Telegram 机器人配置完整指南

本指南将带你完成 Telegram 机器人从创建到配置的全部流程,确保你的机器人代码能够顺利运行。

📋 目录

• 前言
• 第一步:创建机器人
• 第二步:管理与维护
• 第三步:关键配置
• 配置清单
• 常见问题

🎯 前言

要让你的 Telegram 机器人代码成功运行,需要在 Telegram 官方完成一系列配置。本教程将带你一步步完成所有必要的设置,从申请账号到关键的隐私模式调整。

🤖 第一步:创建机器人

1.1 找到 BotFather

在 Telegram 搜索框中输入 @BotFather,注意认准带有 蓝色认证图标 ✓ 的官方账号。

1.2 创建新机器人

步骤:

1. 点击 Start 开始对话
2. 发送指令 /newbot
3. 按照提示完成设置

💡 数量限制提示
每个 Telegram 账号最多可创建 20 个机器人。达到上限后需要删除旧机器人才能创建新的。

设置昵称 (Name)

• 说明: 机器人的显示名称,可以使用中文、表情符号
• 示例: 业务通知助手
• 特点: 后续可随时修改

设置账号 (Username)

• 说明: 机器人的唯一标识符,用户通过它搜索机器人
• 示例: BizNotify_bot
• 要求:
  • 只能使用英文字母、数字和下划线
  • 必须以 bot 结尾
  • 全球唯一
• ⚠️ 重要: Username 创建后永久无法修改

1.3 获取 Token

创建成功后,BotFather 会返回一串 Token(红色文字显示)。

格式示例: 7000000000:AAFg_xxxxxxx_xxxxxxx

⚠️ 安全警告
Token 相当于机器人的密码,请妥善保管!将它复制到你的 application.yml 配置文件中。

🛠 第二步:管理与维护

2.1 如何重命名机器人

你可以随时修改机器人的显示名称(Name),但无法修改 Username。

操作步骤:

1. 向 @BotFather 发送 /mybots
2. 选择要修改的机器人
3. 点击 Edit Bot
4. 点击 Edit Name
5. 输入新名称并发送

🔑 第三步:关键配置

⚠️ 关闭隐私模式

这是最容易被忽略的一步!90% 的开发者都会漏掉这个配置。

为什么要关闭?

默认情况下,Telegram 机器人在群组中启用隐私保护:

如果不关闭隐私模式,机器人将无法识别用户发送的普通文本指令。

操作步骤

1. 向 @BotFather 发送 /mybots
2. 点击你的机器人名字
3. 点击 Bot Settings
4. 点击 Group Privacy
5. 点击 Turn off
6. 确认状态显示为 Privacy mode is DISABLED

📌 重要提醒

如果机器人已在群组中,修改后可能不会立即生效,建议:

• 将机器人从群组移除
• 重新邀请机器人进入群组

📊 配置清单

配置文件示例

在 application.yml 中添加:

telegram:
  bot:
    username: BizNotify_bot
    token: 7000000000:AAFg_xxxxxxx_xxxxxxx

✅ 验证配置

测试步骤

1. 测试私聊响应

• 向机器人发送 /start
• 应收到机器人的回复

2. 测试群组功能

• 将机器人拉入测试群组
• 发送普通文本消息(如 Hello)
• 确认机器人能够识别并响应

❓ 常见问题

🎉 完成

恭喜!你已经完成了 Telegram 机器人的所有基础配置。

下一步:

• 启动你的应用程序
• 开始使用机器人功能
• 根据需求进行功能开发