工单查询接口
Shulex → 第三方:拉取完整工单详情
Shulex 收到 Webhook 触发后,会向渠道配置中的 queryUrl 发起 GET 请求,以获取完整的工单上下文。
请求格式
示例:
响应体格式
queryUrl 必须返回包装结构,工单详情必须位于 data 字段中;直接返回工单对象的旧格式不兼容。
顶层包装字段
data 工单字段
messages[] 字段
附件字段
messages[].attachments 与顶层 attachments 均使用以下结构:
Shulex 对查询结果的使用方式
messages 是回复处理的主要上下文;assistant 表示历史客服或已发送回复。
format=html 时,Shulex 保留 HTML 正文,并从其中提取 URL 作为附件。
- 显式附件与 HTML 正文中解析出的同一 URL 会去重。
- 顶层
attachments 会附加到最后一条客户消息;没有客户消息时不会自动创建一条消息。
customerEmail、supportEmail 与 customFields 作为工单补充信息传递,不会自动转换为对话消息。
接入建议
- 请保证
messages 的数组顺序就是实际对话顺序。
- 附件 URL 应为可长期访问的 HTTPS 地址,并确保 Shulex 服务端可下载。
- 建议为消息与附件提供稳定 ID,便于第三方排查与关联。
- 完整工单应尽量一次返回,避免只返回增量消息导致上下文缺失。