> ## Documentation Index
> Fetch the complete documentation index at: https://beaver.voc.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 回调与超时说明

> 回调超时、重试策略与幂等性建议

# 回调、超时与幂等

* `queryUrl`、`replyUrl`、`tagsUrl` 默认超时均为 `10000ms`。
* 接入方应快速返回 2xx；耗时业务应转异步处理。
* Webhook、回复和标签回调都可能因网络原因重试，接入方必须幂等。
* 推荐幂等键：有 `messageId` 时使用 `ticketId + messageId + callbackType`；旧调用方未提供 `messageId` 时退化为 `ticketId + callbackType`。

转人工无需单独接口。Shulex 通过 `tagsUrl` 回写 `handoffTags`；开启 `addHandoffReasonTag` 后，回调数组还会包含本次转人工原因。