常见问题 - Shulex Intelli Custom Ticket Open API

1. Webhook 地址需要自己拼接吗？

不需要。请在 Shulex 前端 UI 创建渠道后，直接复制页面展示的 Webhook 地址。

2. 能否在 Webhook body 中直接传完整消息，不实现 queryUrl？

当前实现不支持。Webhook 只作为触发器使用，完整工单详情仍通过 queryUrl 拉取。

3. queryUrl 可以直接返回工单对象吗？

不可以。当前实现读取 CustomTicketApiResponse.data，因此必须返回：

{ "code": ..., "msg": ..., "data": { ... }, "total": ... }

包装结构。

4. attachments 支持哪些文件？

当前实现通过 URL 透传附件，常见图片和 PDF 都可接入。请确保 URL 可由 Shulex 服务端访问。

5. customFields 会如何使用？

customFields 会用于 AI 上下文构建，并作为结构化 metadata 透传给 Tars。

6. customerEmail 和 supportEmail 会如何使用？

customerEmail 会写入 Tars customer email；customerEmail 与 supportEmail 都会作为补充 metadata 透传。

7. 是否支持 webhookSecret / X-Signature 签名校验？

当前实现不支持。Webhook 鉴权依赖 URL 中的 xToken，且服务端会校验 token 所属租户与 channel 归属一致。

8. 标签回调是不是 AI 生成的业务分类标签？

不是。当前 Custom Ticket 链路的标签回调主要用于流程标签：AI 成功回复后写入 repliedTags，转人工时写入 handoffTags。

Documentation Index