开发 Telegram 机器人:凭证获取与接口测试
搭建 Telegram 机器人的第一步,是拿到两个核心凭证:Bot Token 和 Chat ID。有了它们,才能通过 HTTP API 发送消息或接收事件。
1. 创建机器人并获取 Token
在 Telegram 中搜索并添加官方机器人 @BotFather。这是管理所有机器人的入口。
进入对话后,输入 /start 开始交互,接着发送 /newbot 指令。系统会提示你为新机器人命名(支持中文),名称必须以 bot 结尾且不能重复。提交后,BotFather 会返回一段类似 Use this token to access the HTTP API 的字符串,这就是你的 Bot Token,务必妥善保存。
2. 获取用户 ID 与群组 ID
不同的聊天对象需要不同的 ID 格式,获取方式略有区别。
个人用户 ID
添加机器人 @getuseridbot,发送 /start,它会自动回复你的 UserID。
群组或频道 ID
将机器人 @get_id_bot 拉入目标群组或频道。发送命令 /my_id@get_id_bot,它会返回以 -100 开头的 Chat ID(例如 -1001818202301)。注意,普通群组的 ID 通常不需要加 -100,但频道和超级群组必须带前缀。
3. 接口连通性测试
拿到凭证后,建议先验证 API 是否可用。这里提供两种常用方法,无需编写代码即可快速排查。
浏览器访问
直接在地址栏替换 {token} 和 {chatid} 后访问:
https://api.telegram.org/bot{token}/sendMessage?chat_id={chatid}&text=Hello
如果返回 JSON 数据包含 ok: true,说明连接正常。
命令行测试 如果你习惯使用终端,可以用 curl 发送 POST 请求:
curl -s -X POST https://api.telegram.org/bot{token}/sendMessage -d chat_id={chatid} -d text="Hello World"
这种方式更接近实际开发中的调用逻辑,适合在脚本环境中调试。
4. 群组消息权限设置
默认情况下,机器人无法接收群组内的普通消息。若需要在群聊中监听消息,需调整隐私模式。
联系 @BotFather,输入 /setprivacy,选择对应的机器人,将其设置为 Disable 模式。修改后,如果机器人仍收不到消息,尝试将其踢出群组再重新拉入,刷新一下状态即可生效。
注:Token 相当于密码,请勿泄露给他人;Chat ID 随群组变化,动态获取更稳妥。

