Telegram 机器人接入指南：创建 Bot 凭据、连接工作区并在统一收件箱收发消息

概览

Telegram 通道用于连接一个 Telegram 机器人（bot），给它发消息的人会与其他渠道的访客一样出现在团队收件箱中。Telegram 速度快、消息免费，非常适合客服与社群 — 并且复用 WAthink 的自动回复、流程与 AI 助手。Telegram 没有 24 小时窗口限制：用户一旦启动你的机器人，你随时都可以回复。

好消息：Telegram 不需要平台管理员配置应用，也无需审核。任何套餐包含该通道的工作区用户，都可以创建机器人并在两分钟内完成连接。

通道工作原理

• Telegram 机器人运行在官方的 Bot API 上。每个机器人由一个机密的 Token 标识。
• WAthink 会为你的机器人向 Telegram 注册 Webhook，因此每条入站更新（消息、按钮点击等）都会即时推送到 WAthink。
• 回复通过 Bot API 的 sendMessage / sendPhoto 等方法，使用你的 Token 发送。
• 用户通过打开 t.me/YourBotUsername 并按 Start 找到你的机器人，也可以把它添加到群组中使用。

创建机器人与获取 Token

机器人 Token 由 Telegram 官方的 BotFather 签发。步骤如下：

1. 打开 BotFather。在任意 Telegram 应用中搜索 @BotFather（带蓝色认证勾的那个）并打开对话。
2. 创建机器人。发送 /newbot。
3. 命名。回复一个显示名称（例如 “Acme Support”）。
4. 选择用户名。回复一个以 bot 结尾的唯一用户名（例如 acme_support_bot）。
5. 复制 Token。BotFather 会回复形如 123456789:AAExxxxxxxxxxxxxxxxxxxxxxxxxxxx 的 Token。它是机器人的密码 — 务必保密。
6. （可选）完善机器人。仍在 BotFather 中，可以设置头像（/setuserpic）、描述（/setdescription）、简介文本（/setabouttext）与命令提示（/setcommands）。

如果 Token 泄露，任何人都能控制你的机器人。请在 BotFather 中用 /revoke 吊销并重新签发，然后把新 Token 粘贴到 WAthink。

在 WAthink 中连接

1. 打开 Telegram 页面 — 菜单中的 Channels → Telegram。
2. 粘贴机器人 Token并保存。
3. WAthink 会自动向 Telegram 注册 Webhook — 无需复制任何 URL。它还会获取机器人的用户名，以便链接正常工作。
4. 测试。打开 t.me/YourBotUsername，按 Start 并发送一条消息 — 几秒内就会出现在团队收件箱中。

每个机器人只能有一个 Webhook。一个 Telegram 机器人的 Webhook 同一时间只能指向一个地址。不要同时在其它工具中使用同一个 Token，否则更新会被分流。

API 限制与规则

使用收件箱

• 每个会话一个线程。每个联系你的 Telegram 用户（或群组）都会得到一个线程，标注其 Telegram 名称/用户名。
• 媒体。照片、文档、贴纸和语音消息可内联显示，并可直接回复。
• 按钮。来自流程的内联键盘和回复键盘在 Telegram 中显示为可点击按钮。

自动回复、流程与 AI

• 自动回复。在自动回复中，把欢迎 / 离开 / 非工作时间 / 关键词规则限定到你的 Telegram 机器人。
• 流程。在流程构建器中把触发节点的渠道设为 Telegram。按钮、快捷回复、媒体与提问步骤均可在 Telegram 上运行。
• AI 助手。为机器人指定一个 AI 助手，实现自动回复并支持转接人工。

Telegram 广播

Telegram 广播编辑器会向所有已启动你的机器人的会话发送消息。选择机器人、挑选收件人、撰写消息（带实时预览）并发送。由于没有 24 小时窗口，你可以触达整个机器人受众 — WAthink 会对发送限速以保持在 Telegram 的速率限制内，已屏蔽机器人的用户会被跳过。

故障排查