AI 回复回调
Shulex → 第三方:回传生成的回复内容当 Shulex 完成回复生成后,会调用渠道配置中的
replyUrl。调用时会携带渠道配置的 replyAuthHeader(如有)。
请求格式
默认 HTML 回调体
当replyFormat 未配置或配置为 HTML 时:
TEXT 回调体
当replyFormat 配置为 TEXT 时,Shulex 会将生成内容转为纯文本:
字段说明
messageId 未提供时,回调体不会包含空的 messageId 字段。期望响应
第三方成功处理后应尽快返回任意 2xx 状态码。例如:幂等与失败处理
- 建议使用
ticketId + messageId + replyType作为幂等键;旧事件可退化为ticketId + replyType。 - 回调处理应先持久化或入队,再快速返回 2xx,避免网络超时造成重复投递。
replyUrl调用失败会被视为本次回复处理失败,请确保接口可用且鉴权配置正确。- 回调内容可能包含 HTML;如需存储或渲染,请按第三方系统的安全策略处理。