回复工单

坐席对工单进行回复，产生一条流转记录。comment 最长 3000 字符；customerSee=true 表示访客可见，仅支持非邮件工单且模板开启了访客查询功能（queryStatus=1）。appendFields 格式为 JSON 数组，每项 typename 为自定义字段 ID 或字符串 uploadFile（对应模板文件字段），最多 50 项。有 appendFields 时 customerSee 必须为 true；工单被删除时返回对应业务错误。

请求参数

名称	类型	必填	描述
appKey	string	是	应用 AppKey
time	int64	是	请求时间戳（秒）
checksum	string	是	请求签名校验和
checksumAlgorithm	int32	否	签名算法：0 - 默认(SHA1)，1 - SHA256

请求体

名称	类型	必填	描述	示例值
ticketId	int64	是	工单 ID	123456
staffId	int64	是	操作坐席 ID	10001
comment	string	否	回复内容，最长 3000 字符	已联系财务核实退款状态，预计 1 个工作日内给您答复。
attachments	string	否	附件列表 JSON 字符串，每项：{type, payload, fileName}	[{"type":2,"payload":"openapi/attachments/2024/07/refund-proof.pdf","fileName":"退款凭证.pdf"}]
customerSee	boolean	否	是否访客可见（仅访客工单且模板开启访客查询时有效）	true
appendFields	string	否	访客可见时追加的补充字段列表，JSON 数组字符串，每项：{typename: fieldId 或 uploadFile}	[{"typename":81001,"name":"订单号","value":"SO202407010001"},{"typename":"uploadFile","name":"补充附件","value":"openapi/attachments/2024/07/refund-proof.pdf"}]

返回参数

名称	类型	描述	示例值
code	int32	状态码，200 表示成功	200
message	string	提示信息：成功时为业务数据，失败时为错误描述	true

错误码

状态码	描述
8813	工单已删除；邮件工单不支持访客可见；非访客工单不支持访客可见；appendFields 有值但 customerSee 未开启
14004	ticketId 或 staffId 为空；comment 超过 3000 字符；appendFields 超过 50 项；字段不存在；JSON 格式错误
14100	staffId 不存在或已停用
14500	服务内部异常

postEndpoint

/openapi/v2/ticket/reply

curl -X POST "https://qiyukf.com/openapi/v2/ticket/reply?appKey=string&time=0&checksum=string" \  -H "Content-Type: application/json" \  -d '{    "ticketId": 123456,    "staffId": 10001  }'

{
  "code": 200,
  "message": "true"
}

{
  "code": 8813,
  "message": "工单已删除；邮件工单不支持访客可见；非访客工单不支持访客可见；appendFields 有值但 customerSee 未开启"
}

{
  "code": 14004,
  "message": "ticketId 或 staffId 为空；comment 超过 3000 字符；appendFields 超过 50 项；字段不存在；JSON 格式错误"
}

{
  "code": 14100,
  "message": "staffId 不存在或已停用"
}

{
  "code": 14500,
  "message": "服务内部异常"
}