SemibotTelegram Bot 详细配置
适用于 Telegram Bot 的 webhook 接入和群聊使用。
1. 前置准备
先在 Telegram 里找到 @BotFather，发送 /newbot 创建机器人。按提示设置名称和用户名后，BotFather 会返回一个 Bot Token（格式类似 123456:ABC-DEF...）。先把这个 Token 保存好。
2. 在 Semibot 创建 Bot 实例
打开 Semibot 配置中心，进入 Bots > 新建，选择 Telegram。填入 Bot Token，选好默认智能体，再把允许接入的群聊 ID 配到 allowedChatIds 里，然后保存。
3. 设置 Webhook
Webhook 地址格式是：https://<your-domain>/v1/integrations/telegram/webhook。这个地址必须能从公网访问，而且要走 HTTPS。你可以用 Semibot CLI 去设置，也可以直接调用 Telegram API 来注册。
4. 隐私模式与 chatId
Telegram Bot 默认开着 Privacy Mode，在群里通常只能收到 @bot 的消息和 /command。如果你想收所有群消息，就去 BotFather 里用 /setprivacy 关掉。chat_id 可以在机器人进群后发一条消息，再通过 getUpdates 看 chat.id，把它填进 allowedChatIds 就行。
5. 联调与验证
先在 Semibot 里点「测试」，确认链路通了。再去 Telegram 群里发一条消息或 @bot，然后到事件中心看有没有收到 chat.message.received。最后在会话详情里确认执行过程和回传结果。最常见的问题就是 Webhook 没配好、Privacy Mode 没处理，或者 allowedChatIds 没填对。
FAQ
Telegram Bot 接入最容易卡在哪？
最常见的是 Webhook 地址不可达、HTTPS 配置不完整，或者 BotFather 里拿到的 token 填错。建议先确认公网回调地址，再检查 token 和连通性测试。
为什么群里发消息机器人没反应？
通常和群聊隐私模式、allowedChatIds 配置、或者机器人没有被正确拉进群有关。先检查 Privacy Mode，再确认实例是否允许当前群聊。
应该先配 Telegram 还是先把本地环境跑起来？
建议先把本地环境和 Web UI 跑通，再接 Telegram。这样一旦接入失败，更容易判断问题是在本地服务、回调地址还是 Telegram 平台本身。