回复回调
Shulex → 第三方:回传生成的回复内容当 Shulex 完成回复生成后,会调用渠道配置中的
replyUrl。调用时会携带渠道配置的 replyAuthHeader(如有)。
请求格式
默认 HTML 回调体
当replyFormat 未配置或配置为 HTML 时:
TEXT 回调体
当replyFormat 配置为 TEXT 时,Shulex 会将生成内容转为纯文本:
字段说明
messageId 始终优先取查询快照中最后一条客户消息 ID;Webhook 未提供消息 ID 时仍按此规则回传。若没有有效客户消息 ID,则省略 messageId;原始 Webhook 消息 ID(如有)单独放在 webhookMessageId。
期望响应
第三方成功处理后应尽快返回任意 2xx 状态码。例如:幂等与失败处理
- 建议使用 ticketId + messageId + replyType 作为幂等键;webhookMessageId 仅表示原始 Webhook 事件,可用于事件幂等与链路排查,不应替代 messageId。若没有有效 messageId,可退化为 ticketId + webhookMessageId + replyType。
- 回调处理应先持久化或入队,再快速返回 2xx,避免网络超时造成重复投递。
replyUrl调用失败会被视为本次回复处理失败,请确保接口可用且鉴权配置正确。- 回调内容可能包含 HTML;如需存储或渲染,请按第三方系统的安全策略处理。