> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vecbase.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Telegram

> 通过 BotFather 将 Agent 连接到 Telegram

# Telegram 接入指南

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

## 前置条件

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

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

<Steps>
  <Step title="打开 BotFather">
    打开 Telegram，搜索 **@BotFather**（Telegram 官方的机器人管理工具）。
  </Step>

  <Step title="创建新机器人">
    发送 `/newbot`，BotFather 会要求你提供：

    * **机器人名称**：显示名（如 "我的公司助手"）
    * **机器人用户名**：必须以 `bot` 结尾（如 `mycompany_assistant_bot`）
  </Step>

  <Step title="复制 Bot Token">
    BotFather 会回复一个 Token，格式如下：

    ```
    8737604196:AAFspi44trCXi3fxDr50-v1g6gIdvageZQA
    ```

    **请妥善保管** — 任何人拿到这个 Token 都可以控制你的机器人。
  </Step>
</Steps>

## 第二步：在 Vecbase 中连接

<Steps>
  <Step title="打开 Agent 设置">
    打开你的 Agent，点击右上角的 **设置**，然后选择 **通道**。
  </Step>

  <Step title="添加 Telegram 通道">
    点击 **Telegram** 旁边的 **添加通道**。
  </Step>

  <Step title="填写凭证">
    * **显示名称**：给通道取个名字（如 "客服机器人"）
    * **Bot Token**：粘贴从 BotFather 获取的 Token
  </Step>

  <Step title="创建">
    点击 **创建**。状态变为 **已连接** 即成功。
  </Step>
</Steps>

## 第三步：测试

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

## 机器人设置（可选）

你可以在 BotFather 中自定义机器人：

| 命令                | 说明        |
| ----------------- | --------- |
| `/setdescription` | 设置机器人描述   |
| `/setabouttext`   | 设置"关于"文本  |
| `/setuserpic`     | 设置头像      |
| `/setcommands`    | 设置自定义命令菜单 |

## 限制

| 限制   | 数值                 |
| ---- | ------------------ |
| 文件上传 | 50 MB（Bot API）     |
| 文件下载 | 20 MB（getFile API） |
| 消息长度 | 4,096 字符           |

<Info>
  Telegram 机器人可以在**私聊**和**群聊**中使用。在群聊中，机器人在被 `@机器人用户名` 提及时回复。
</Info>