想开发 Telegram 机器人，第一步不是写代码，而是通过官方 @BotFather 创建机器人账号并完成基础设置。本教程从创建机器人、保存 Token、设置头像和命令菜单，一直讲到隐私模式、群组权限和上线前检查。
一、Telegram机器人是什么？
Telegram 机器人是一种特殊账号，不需要额外手机号码。机器人本身只是 Telegram 中的入口，真正的业务逻辑运行在你的程序或服务器上。程序通过 Telegram Bot API 接收消息、发送内容、处理按钮和执行自动化操作。
官方文档说明，Bot API 使用 HTTPS 请求和 JSON 数据进行通信。创建完成后，你会得到一个唯一 Token，程序使用它证明自己有权控制该机器人。
二、通过BotFather创建机器人
第1步：找到官方BotFather
在 Telegram 搜索 @BotFather。确认用户名准确，不要把 Token 交给名称相似的第三方账号。进入聊天后点击“开始”或发送 /start。
第2步：发送/newbot
向 BotFather 发送 /newbot。随后它会要求你设置两个名称：
- 机器人显示名称：用户看到的名称，可以使用中文，例如“SOS记账机器人”。
- 机器人用户名：必须唯一，并以
bot结尾，例如SOSBillbot。
用户名设置成功后，BotFather 会返回机器人链接和一串 API Token。此时机器人账号已经创建，但还没有业务功能。
三、Token是什么？应该如何保存？
Token 相当于机器人的密码。任何拿到 Token 的人都可能控制机器人、读取机器人能够接收的更新或发送消息，因此不要把完整 Token 发到群里、截图中、GitHub 仓库或公开日志。
- 生产环境建议保存在服务器环境变量或专用密钥管理系统中。
- 不要直接写进公开代码仓库。
- 怀疑泄露时，立即在 BotFather 中撤销并重新生成 Token。
- 不要把真实 Token 粘贴到不可信网站进行测试。
测试 Token 是否有效，可以让程序调用 Bot API 的 getMe 方法。官方文档提供的基本格式是：https://api.telegram.org/bot<YOUR_BOT_TOKEN>/getMe。测试完毕后仍应避免在浏览器历史或截图中暴露 Token。
四、设置机器人头像、简介和描述
发送 /mybots，选择刚创建的机器人，然后进入 Edit Bot。常用设置包括：
- Edit Name：修改机器人显示名称。
- Edit Description：设置用户打开机器人时看到的详细介绍。
- Edit About：设置机器人资料页中的简短说明。
- Edit Botpic：上传机器人头像，建议使用清晰的正方形品牌图。
- Edit Commands：设置命令菜单。
名称和描述应该直接说明用途。例如记账机器人可以在简介中写明“群组入账、下发、汇率计算、账单统计与管理后台”，避免只写“智能机器人”这种含义不清的内容。
五、设置机器人命令菜单
进入 /mybots → 选择机器人 → Edit Bot → Edit Commands，按照“命令 – 说明”的格式逐行发送。命令名称不要带斜杠，例如：
start - 开始使用
help - 查看使用说明
menu - 打开功能菜单
settings - 管理机器人设置
命令菜单只是向用户展示可用入口，真正收到命令后如何回复，仍然需要在机器人程序中实现。Telegram 也支持针对私聊、群组或管理员设置不同范围的命令。
六、设置机器人能否加入群组
在 BotFather 的 Bot Settings 中可以管理群组相关设置。开启加入群组后，用户才能把机器人添加到群聊。加入群组并不代表机器人自动拥有管理员权限；删除消息、置顶、管理成员等功能需要群主另外授予对应权限。
七、Privacy Mode隐私模式怎么设置？
隐私模式决定机器人在群组中能够收到哪些消息。开启隐私模式时，机器人通常只接收与自己相关的命令、回复和部分服务消息；关闭后，机器人可以接收更多普通群消息。
如果机器人需要关键词监听、自动记账或完整群消息处理，通常需要根据功能评估是否关闭隐私模式。关闭隐私模式后，建议重新把机器人加入群组，并严格限制数据保存范围。普通客服或菜单机器人一般不需要读取全部群消息。
八、机器人为什么创建后没有反应？
BotFather 只负责创建和配置机器人账号，不会自动生成业务程序。机器人没有反应通常有以下原因：
- 机器人程序尚未编写或没有启动。
- Token 填写错误、已被撤销或包含多余空格。
- Webhook 地址不可访问或 HTTPS 证书异常。
- Long Polling 与 Webhook 同时使用造成冲突。
- 群组隐私模式或管理员权限不符合功能需求。
- 服务器程序退出、网络异常或接口报错。
九、Polling和Webhook怎么选择？
Long Polling 适合本地开发和快速测试，程序主动向 Telegram 获取新消息；Webhook 更适合正式服务器部署，Telegram 会把更新推送到你的 HTTPS 地址。正式项目还应加入日志、错误恢复、数据库备份和运行监控。
十、上线前检查清单
- 机器人名称、头像、简介和命令菜单已经设置。
- Token 保存在安全位置，没有出现在公开代码中。
/start、/help和主要按钮均能正常工作。- 群组权限和隐私模式符合功能需要。
- 服务器支持自动重启、日志记录和故障提醒。
- 数据库、用户数据和配置已建立备份机制。
需要定制Telegram机器人怎么办？
创建机器人账号只是第一步。记账、群管、会员、钱包监控、商城、客服和管理后台都需要程序开发与服务器部署。SOS Bot 提供 Telegram 机器人、网站、软件、小程序及自动化系统定制开发，可通过 @sosbot 沟通需求。
