> ## 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.

# 渠道配置方式

> 在 Shulex UI 中创建并配置 Custom Ticket 渠道

# 渠道配置方式

优先在 Shulex UI 创建和维护渠道，并直接复制 UI 展示的 Webhook 与 Summary 地址，不要自行拼接。

| 配置项                   | 必填 | 说明                                      |
| --------------------- | -- | --------------------------------------- |
| `accountName`         | 是  | 渠道显示名称                                  |
| `queryUrl`            | 是  | 工单详情查询地址                                |
| `queryAuthHeader`     | 否  | 调用 `queryUrl` 的鉴权 Header                |
| `replyUrl`            | 是  | 回复回调地址                                  |
| `replyAuthHeader`     | 否  | 调用回复、标签和异步摘要回调的鉴权 Header                |
| `replyFormat`         | 否  | `HTML`（默认）或 `TEXT`                      |
| `tagsUrl`             | 否  | 流程标签回调地址                                |
| `repliedTags`         | 否  | AI 成功回复后回写的标签；未配置默认 `shulex_ai_replied` |
| `handoffTags`         | 否  | 转人工时回写的标签；未配置默认 `transfer_to_agent`     |
| `addHandoffReasonTag` | 否  | `true` 时，在转人工标签中追加原因；默认 `false`         |
| `replyTimeoutMs`      | 否  | HTTP 超时，默认 `10000` 毫秒                   |

`queryUrl`、`replyUrl`、`tagsUrl` 必须是 HTTPS（本地调试可用 localhost）。鉴权 Header 推荐使用完整形式，例如 `Authorization: Bearer xxx`。