> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# Discord

Discord 频道 webhook 可让接待员在通话期间向频道发布消息，例如来电者要求回电或报告紧急问题时。

## 在 Discord 中创建 webhook

你需要在服务器中拥有 **管理 Webhook** 权限。

### 打开服务器的 webhook

在 Discord 中，打开 **服务器设置** → **集成** → **Webhook**，然后选择 **新建 Webhook**。

### 选择频道

打开新 webhook，为其命名，例如“Reception”，然后选择要发布消息的频道。选择 **保存更改**。

### 复制 webhook URL

选择 **复制 Webhook URL**。该 URL 以 `https://discord.com/api/webhooks/` 开头。请将其视为机密：任何拥有该 URL 的人都可以向频道发布消息。

## 创建 webhook 工具

前往 **集成**，选择 **添加集成**，然后选择 **Webhook 工具**。

| 字段         | 值                                                       |
| ---------- | ------------------------------------------------------- |
| **名称**     | `notify_team_in_discord`                                |
| **说明**     | “向团队的 Discord 频道发布消息。来电者要求回电、想与人工沟通或报告紧急问题时使用。”         |
| **方法**     | POST                                                    |
| **URL**    | Discord webhook URL，末尾添加 `?wait=true`                   |
| **正文参数**   | `content`（字符串，必填）：“要发布的消息，不超过 2,000 个字符：来电者姓名、电话号码及需求。” |
| **分配给智能体** | **接待员**                                                 |

使用 `?wait=true` 后，Discord 会返回已发布的消息而非空响应，因此接待员可确认消息已成功发送。

选择 **启用**，然后通过要求回电来[测试接待员](/docs/zh/reception-ai/receptionist/testing)。消息会显示在频道中。

> **Tip**
>
> 每个 webhook 只能发布到一个频道。如需发布到多个频道，请为每个频道分别创建一个 webhook
> 和一个工具。

## 故障排除

| 问题                   | 检查项                                      |
| -------------------- | ---------------------------------------- |
| Discord 返回 400       | 正文参数名称必须严格为 `content`，且消息不得超过 2,000 个字符。 |
| Discord 返回 401 或 404 | webhook 已删除或 URL 已重置。请复制当前 URL 并更新工具。    |
| Discord 为论坛频道返回 400  | 论坛频道要求每条消息使用一个帖子。请改为将 webhook 指向文本频道。    |
| 接待员从不发布消息            | 在工具说明中注明应在哪些情况下发布消息。                     |