标签回调
Shulex → 第三方:回传流程标签(可选)
当渠道配置了 tagsUrl 时,Shulex 会在回复成功或需要转人工时回传流程标签。调用时会携带渠道配置的 replyAuthHeader(如有)。
触发场景
请求格式
回复成功示例
转人工示例
字段说明
tagsUrl 用于同步“已回复”“转人工”等流程状态,不是任意业务分类标签回调。
转人工标签
默认情况下,转人工只回传 handoffTags。当渠道配置 addHandoffReasonTag=true 时,Shulex 会在标签数组末尾追加本次转人工原因;该原因会随触发条件变化。
转人工分支不会调用 replyUrl,第三方应以 handoffTags 作为进入人工处理流程的依据。
期望响应
第三方成功处理后应尽快返回任意 2xx 状态码。例如:
幂等与失败处理
- 建议使用
ticketId + messageId + tags 作为幂等依据;未传 messageId 时可退化为 ticketId + tags。
tagsUrl 未配置时不会发送标签回调。
- 标签回调失败不会撤销已完成的回复或转人工判断;仍建议记录失败并按第三方策略补偿。