Skip to main content

工单查询接口

Shulex → 第三方:拉取完整工单详情
Shulex 收到 Webhook 触发后,会向渠道配置中的 queryUrl 发起 GET 请求,以获取完整的工单上下文。

请求格式

示例:

响应体格式

queryUrl 必须返回包装结构,工单详情必须位于 data 字段中;直接返回工单对象的旧格式不兼容。

顶层包装字段

data 工单字段

messages[] 字段

附件字段

messages[].attachments 与顶层 attachments 均使用以下结构:

Shulex 对查询结果的使用方式

  • messages 是回复处理的主要上下文;assistant 表示历史客服或已发送回复。
  • format=html 时,Shulex 保留 HTML 正文,并从其中提取 URL 作为附件。
  • 显式附件与 HTML 正文中解析出的同一 URL 会去重。
  • 顶层 attachments 会附加到最后一条客户消息;没有客户消息时不会自动创建一条消息。
  • customerEmailsupportEmailcustomFields 作为工单补充信息传递,不会自动转换为对话消息。

接入建议

  • 请保证 messages 的数组顺序就是实际对话顺序。
  • 附件 URL 应为可长期访问的 HTTPS 地址,并确保 Shulex 服务端可下载。
  • 建议为消息与附件提供稳定 ID,便于第三方排查与关联。
  • 完整工单应尽量一次返回,避免只返回增量消息导致上下文缺失。