Skip to main content

标签回调

Shulex → 第三方:回传流程标签(可选)
当渠道配置了 tagsUrl 时,Shulex 会在回复成功或需要转人工时回传流程标签。调用时会携带渠道配置的 replyAuthHeader(如有)。

触发场景

请求格式

回复成功示例

转人工示例

字段说明

tagsUrl 用于同步“已回复”“转人工”等流程状态,不是任意业务分类标签回调。

转人工标签

默认情况下,转人工只回传 handoffTags。当渠道配置 addHandoffReasonTag=true 时,Shulex 会在标签数组末尾追加本次转人工原因;该原因会随触发条件变化。 转人工分支不会调用 replyUrl,第三方应以 handoffTags 作为进入人工处理流程的依据。

期望响应

第三方成功处理后应尽快返回任意 2xx 状态码。例如:

幂等与失败处理

  • 建议使用 ticketId + messageId + tags 作为幂等依据;未传 messageId 时可退化为 ticketId + tags
  • tagsUrl 未配置时不会发送标签回调。
  • 标签回调失败不会撤销已完成的回复或转人工判断;仍建议记录失败并按第三方策略补偿。