Telegram | ElevenLabs Documentation

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

创建机器人并查找聊天 ID

创建机器人

在 Telegram 中，打开与 @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 中包含机器人令牌，因此也请将其视为机密。

选择启用，然后通过请求回电来测试接待员。机器人会在聊天中发布消息。

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

故障排除

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