回调、超时与幂等
queryUrl、replyUrl、tagsUrl默认超时均为10000ms。- 接入方应快速返回 2xx;耗时业务应转异步处理。
- Webhook、回复和标签回调都可能因网络原因重试,接入方必须幂等。
- 推荐幂等键:有
messageId时使用ticketId + messageId + callbackType;旧调用方未提供messageId时退化为ticketId + callbackType。
tagsUrl 回写 handoffTags;开启 addHandoffReasonTag 后,回调数组还会包含本次转人工原因。