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

# Telegram

Telegram 机器人可让接待员在通话期间向你或团队群组发送消息，例如来电者请求回电或报告紧急问题时。[webhook 工具](/docs/zh/reception-ai/integrations/webhooks) 会调用 Telegram Bot API 的 `sendMessage` 方法。

## 创建机器人并查找聊天 ID

### 创建机器人

在 Telegram 中，打开与 [@BotFather](https://t.me/BotFather) 的聊天，发送 `/newbot`，然后按照提示命名机器人。BotFather 会回复一个机器人令牌，例如 `123456789:AA...`。请将其视为机密：任何拥有该令牌的人都能控制机器人。

### 与机器人开始聊天

机器人只能向其所在的聊天发送消息。

* **给自己发消息：** 打开与新机器人的聊天，然后选择 **开始**。
* **给群组发消息：** 将机器人添加到群组，然后发送一条提及它的消息，例如 `/start@YOUR_BOT_NAME`。

### 查找聊天 ID

在浏览器中打开 `https://api.telegram.org/botBOT_TOKEN/getUpdates`，将其中的 `BOT_TOKEN` 替换为机器人令牌。在响应中找到你的消息，并复制 `"chat":{"id":` 后面的数字。群组 ID 为负数，例如 `-1001234567890`；请保留负号。

如果响应为空，请再向机器人发送一条消息，然后重新加载页面。

## 创建 webhook 工具

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

| 字段         | 值                                                                              |
| ---------- | ------------------------------------------------------------------------------ |
| **名称**     | `notify_team_in_telegram`                                                      |
| **描述**     | “向团队发送 Telegram 消息。来电者请求回电、想与人工沟通或报告紧急问题时使用。”                                  |
| **方法**     | POST                                                                           |
| **URL**    | `https://api.telegram.org/botBOT_TOKEN/sendMessage`，将其中的 `BOT_TOKEN` 替换为机器人令牌  |
| **正文参数**   | `chat_id`（字符串，必填）：“始终使用准确的值 `CHAT_ID`。”  `text`（字符串，必填）：“消息内容：来电者姓名、电话号码及其需求。” |
| **分配给智能体** | **接待员**                                                                        |

将描述中的 `CHAT_ID` 替换为聊天 ID。URL 中包含机器人令牌，因此也请将其视为机密。

选择 **启用**，然后通过请求回电来[测试接待员](/docs/zh/reception-ai/receptionist/testing)。机器人会在聊天中发布消息。

> **Tip**
>
> 若要向多个聊天发送消息，请为每个聊天 ID 创建一个工具。同一个机器人可以向所有聊天发布消息。

## 故障排除

| 问题                            | 检查项                                                    |
| ----------------------------- | ------------------------------------------------------ |
| Telegram 返回 401               | URL 中的机器人令牌有误，或已在 BotFather 中被撤销。URL 必须在令牌正前方包含 `bot`。 |
| `Bad Request: chat not found` | 检查聊天 ID，包括群组的负号，并确认你已与机器人开始聊天或已将其添加到群组。                |
| `Forbidden: bot was kicked`   | 机器人已被移出群组。请重新添加。                                       |
| `getUpdates` 未显示任何内容          | 在群组中，机器人只能看到提及它们的消息。发送 `/start@YOUR_BOT_NAME`，然后重新加载。  |
| 接待员从不发布消息                     | 在工具描述中明确应发布消息的场景。                                      |