跳转到主要内容

​
Telegram 接入指南

将 Vecbase Agent 连接到 Telegram，用户可以直接在 Telegram 中与 Agent 对话。

​
前置条件

  • 一个 Telegram 账号
  • 已创建 Vecbase Agent

​
第一步：通过 BotFather 创建机器人

1

打开 BotFather

打开 Telegram，搜索 @BotFather（Telegram 官方的机器人管理工具）。
2

创建新机器人

发送 /newbot，BotFather 会要求你提供：
  • 机器人名称：显示名（如 “我的公司助手”）
  • 机器人用户名：必须以 bot 结尾（如 mycompany_assistant_bot）
3

复制 Bot Token

BotFather 会回复一个 Token，格式如下：
8737604196:AAFspi44trCXi3fxDr50-v1g6gIdvageZQA
请妥善保管 — 任何人拿到这个 Token 都可以控制你的机器人。

​
第二步：在 Vecbase 中连接

1

打开 Agent 设置

打开你的 Agent，点击右上角的 设置，然后选择 通道。
2

添加 Telegram 通道

点击 Telegram 旁边的 添加通道。
3

填写凭证

  • 显示名称：给通道取个名字（如 “客服机器人”）
  • Bot Token：粘贴从 BotFather 获取的 Token
4

创建

点击 创建。状态变为 已连接 即成功。

​
第三步：测试

打开 Telegram，搜索你的机器人用户名，发送一条消息。Vecbase Agent 会自动回复。

​
机器人设置（可选）

你可以在 BotFather 中自定义机器人：
命令说明
/setdescription设置机器人描述
/setabouttext设置”关于”文本
/setuserpic设置头像
/setcommands设置自定义命令菜单

​
限制

限制数值
文件上传50 MB（Bot API）
文件下载20 MB（getFile API）
消息长度4,096 字符
Telegram 机器人可以在私聊和群聊中使用。在群聊中，机器人在被 @机器人用户名 提及时回复。