如何创建Telegram机器人

业务场景

Chat App 消息服务支持通过 Telegram 通道触达全球用户。使用 Telegram 通道前，需要先在 Telegram 平台创建一个机器人，获取 API Token 作为接入凭证。此外，还需要为机器人配置群组和频道的管理权限，以支持群发消息、社群运营等场景。

方案概览

创建 Telegram 机器人并完成权限配置的操作流程如下：

1. 通过 BotFather 创建新机器人。

2. 设置机器人的名称和用户名。

3. 获取并保存 API Token。

4. 完善机器人资料（可选）。

5. 配置群组和频道的管理权限。

BotFather 是 Telegram 官方提供的机器人管理工具，所有机器人的创建和配置操作均通过与 BotFather 对话完成。

步骤一：打开 BotFather 并创建机器人

使用已注册的 Telegram 账号，在 Telegram 客户端（手机端、桌面端或 Web 版）中打开 BotFather。有以下两种方式：

• 搜索：在 Telegram 搜索框中输入 BotFather，选择带有官方认证标识的账号。

• 链接：直接访问 https://t.me/BotFather。

打开后，单击 Start 开始对话，然后发送以下命令创建新机器人：/newbot，BotFather 将依次引导完成机器人名称和用户名的设置。

步骤二：设置机器人名称

BotFather 首先要求输入机器人的显示名称（Name）。该名称面向终端用户展示，支持中文、英文或其他语言。输入名称后直接发送即可。例如：

• 客服助手

• My Shop Assistant

• Order Service Bot

步骤三：设置机器人用户名

BotFather 随后要求设置机器人的用户名（Username）。用户名需满足以下规则：

• 仅支持英文字母、数字和下划线。

• 必须以 bot 结尾。

示例：my_demo_bot、MyShopHelperBot。

以下用户名不符合规则，无法使用：

如果用户名已被占用，BotFather 会提示重新输入。可以尝试添加数字或下划线来调整，例如 my_shop_bot、service_01_bot。

步骤四：获取并保存 API Token

机器人创建成功后，BotFather 返回一条包含 API Token 的消息，格式如下：123456789:AAExampleTokenxxxxxxxxxxxxxxxxxxx

API Token 是机器人调用 Telegram Bot API 的核心凭证，也是后续接入 Chat App 消息服务时的必填信息。建议记录以下内容，后续配置时需要使用：

步骤五：完善机器人资料（可选）

机器人创建完成后，可在 BotFather 中进一步完善机器人信息。以下设置非必需，但有助于提升用户体验：

步骤六：配置机器人权限

如果需要将机器人加入群组或频道使用，需要开启相应的权限。以下操作均在 BotFather 对话中完成。

验证机器人

完成创建和权限配置后，执行以下验证确认机器人工作正常：

1. 在 Telegram 搜索框中搜索机器人用户名（例如 my_demo_bot），确认可以搜索到。

2. 打开机器人主页，单击 Start，确认机器人响应正常。

3. 访问 https://t.me/<机器人用户名>，确认链接可正常打开。

4. 将机器人加入测试群组或频道，确认权限配置生效。

后续步骤

机器人创建并配置完成后，在中创建 Telegram 类型通道，绑定该机器人的 API Token，即可开始使用 Telegram 通道发送消息。

常见问题