操作教程

5 分钟接入 Telegram 机器人

6 个步骤,从 0 开到收到第一条测试消息。BotFather 注册、拿 token、控制台粘贴、webhook 设好,剩下的 Lane.Chat 全接管。

这篇就是个 checklist,照着来 5 分钟就能跑通。

步骤 1: 登录 Lane.Chat 控制台,进入 Channels

在左侧菜单找到 Channels → Telegram,点 "Add new bot"。控制台会生成一个 webhook URL,后面几步会用到。

步骤 2: 在 Telegram 里找 @BotFather 发 /newbot

打开 Telegram,搜索 @BotFather(认准蓝色验证勾)。发送 /newbot 命令。BotFather 会问两个问题:Bot 的显示名称(可以中文)、Bot 的 username(必须以 bot 结尾,全球唯一)。

步骤 3: 拿到 bot token

完成命名后,BotFather 发一段消息,里面有一行 1234567890:ABC... 的长串,这就是 bot token。这串相当于密码,不要截图发给任何人

步骤 4: 粘贴 token 到 Lane.Chat 控制台

回到控制台的 Add Bot 页面,把 token 粘到输入框,点 "Verify"。Lane.Chat 会调一次 Telegram API 验证 token 有效,并且拉取 Bot 的名字、头像。

步骤 5: 设置 webhook

Token 验证通过后,控制台会出现一个 "Set webhook" 按钮。点它,Lane.Chat 自动调 Telegram 的 setWebhook 接口,把 webhook URL 绑到你的 bot 上。整个过程不需要你手动敲 curl。

步骤 6: 发一条测试消息

在 Telegram 里搜你刚建的 bot(@YourBotUsername),点 Start,发任意一条消息。回到 Lane.Chat 控制台,几秒内 Conversations 列表里应该出现这条新对话。回复它,访客端也应该立刻收到。

接下来做什么

  • 配置欢迎语:Channels → Telegram → Welcome Message
  • 绑定知识库,让 AI 自动回复
  • 如果要做 Mini App,申请 BotFather 的 /newapp 额外配置

截图清单 / Screenshots Checklist

  • 01-add-channel.png — 控制台 Channels 页面点击 Add new bot
  • 02-botfather-newbot.png — Telegram 里 BotFather 的 /newbot 对话
  • 03-token-received.png — BotFather 返回 bot token 的消息
  • 05-webhook-configured.png — 控制台显示 webhook 设置成功
  • 06-test-message-received.png — 控制台收到第一条测试消息