通过工单 ID 添加对工单的回复。
请求参数
参数 | 类型 | 说明 | 必需的 |
---|---|---|---|
action | string | “AddTicketReply” | Required |
ticketid | int | 票证在数据库中的 ID。 $ticketid 是必需的 | Required |
message | string | 票务回复的内容 | Required |
markdown | bool | 是否应在票证回复输出中使用降价 | Optional |
clientid | int | 传递 clientid 以将票证回复与特定客户端相关联 | Optional |
contactid | int | 传递一个 contactid 以将票证回复与属于 $clientid 的特定联系人相关联 | Optional |
adminusername | string | 与票证回复相关联的管理员用户名 | Optional |
name | string | 如果不是管理员或客户端响应,则与票证回复关联的名称 | Optional |
string | 如果不是管理员或客户回复,则与工单回复相关联的电子邮件 | Optional | |
status | string | 如果不需要管理员/客户端响应的默认状态,则在做出回复后在工单上设置的状态。请参阅GetSupportStatuses API 命令 | Optional |
noemail | bool | 设置为 true 以停止发送工单回复电子邮件 | Optional |
customfields | string | 要更新的自定义字段的 base64 编码数组 | Optional |
attachments | array | 可选的 base64 json 编码的文件附件数组。可以是 multipart-form-data 表单提交的直接输出(PHP 中的 $_FILES 超全局)或由文件名和数据键组成的数组数组(参见下面的示例)。 | Optional |
created | string | 工单回复将显示为已发送的日期和时间。格式:ISO8601 或YYYY-MM-DD HH:mm:ss | Optional |
响应参数
参数 | 类型 | 说明 |
---|---|---|
result | string | 操作结果:成功或错误 |
示例请求 (CURL)
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://www.example.com/includes/api.php');
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS,
http_build_query(
array(
'action' => 'AddTicketReply',
// See https://developers.whmcs.com/api/authentication
'username' => 'IDENTIFIER_OR_ADMIN_USERNAME',
'password' => 'SECRET_OR_HASHED_PASSWORD',
'ticketid' => '1',
'message' => 'This is a sample ticket reply',
'clientid' => '1',
'customfields' => base64_encode(serialize(array("1"=>"Google"))),
'markdown' => true,
'attachments' => base64_encode(json_encode([['name' => 'sample_text_file.txt', 'data' => base64_encode('This is a sample text file contents')]])),
'responsetype' => 'json',
)
)
);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
$response = curl_exec($ch);
curl_close($ch);
示例请求(本地 API)
$command = 'AddTicketReply';
$postData = array(
'ticketid' => '1',
'message' => 'This is a sample ticket reply',
'clientid' => '1',
'customfields' => base64_encode(serialize(array("1"=>"Google"))),
'markdown' => true,
'attachments' => base64_encode(json_encode([['name' => 'sample_text_file.txt', 'data' => base64_encode('This is a sample text file contents')]])),
);
$adminUsername = 'ADMIN_USERNAME'; // Optional for WHMCS 7.2 and later
$results = localAPI($command, $postData, $adminUsername);
print_r($results);
示例响应 JSON
{
"result": "success"
}
错误响应
可能的错误条件响应包括:
- 未找到票证 ID
- 未找到客户端 ID
- 未找到联系人 ID
- 如果不是客户,则需要姓名和电子邮件地址
- 需要留言
- 电子邮件地址无效
- 无效的票证状态
- 无效的日期格式
- 回复创建日期不能是将来
相关用法
- PHP WHMCS AddTicketNote用法及代码示例
- PHP WHMCS AddTransaction用法及代码示例
- PHP WHMCS AddonUnsuspended用法及代码示例
- PHP WHMCS AddContact用法及代码示例
- PHP WHMCS AddUser用法及代码示例
- PHP WHMCS AddonAdd用法及代码示例
- PHP WHMCS AddonTerminated用法及代码示例
- PHP WHMCS AddPayMethod用法及代码示例
- PHP WHMCS AddBillableItem用法及代码示例
- PHP WHMCS AddonFraud用法及代码示例
- PHP WHMCS AddCancelRequest用法及代码示例
- PHP WHMCS AddonDeleted用法及代码示例
- PHP WHMCS AddonActivated用法及代码示例
- PHP WHMCS AddOrder用法及代码示例
- PHP WHMCS AddonSuspended用法及代码示例
- PHP WHMCS AddInvoicePayment用法及代码示例
- PHP WHMCS AddAnnouncement用法及代码示例
- PHP WHMCS AddonConfigSave用法及代码示例
- PHP WHMCS AddonConfig用法及代码示例
- PHP WHMCS AddClient用法及代码示例
- PHP WHMCS AddBannedIp用法及代码示例
- PHP WHMCS AddonRenewal用法及代码示例
- PHP WHMCS AddCredit用法及代码示例
- PHP WHMCS AddProjectTask用法及代码示例
- PHP WHMCS AddProjectMessage用法及代码示例
注:本文由纯净天空筛选整理自whmcs.com大神的英文原创作品 AddTicketReply。非经特殊声明,原始代码版权归原作者所有,本译文未经允许或授权,请勿转载或复制。