Telegram 机器人开发基础配置
要在 Telegram 上搭建自己的机器人,核心在于拿到两个关键凭证:Bot Token 和 Chat ID。下面按实际开发流程梳理一下具体步骤。
一、创建机器人并获取 Token
首先需要在 Telegram 里找到官方管理机器人 @BotFather。直接搜索添加好友即可,不需要复杂的验证。
- 发送
/start激活对话,接着输入/newbot。 - 系统会提示你给机器人起个名字(支持中文),注意名称必须以
bot结尾,且不能与其他现有机器人重复。 - 命名成功后,BotFather 会返回一段类似
Use this token to access the HTTP API的提示,后面那串字符就是你的 Bot Token,务必妥善保存。
二、获取用户及群组 Chat ID
Token 只是机器人的身份证,要发消息还得知道发给谁。Chat ID 分为个人 UserID 和群组/频道 ID。
1. 获取 UserID
添加机器人 @getuseridbot,发送 /start 后,它会自动回复你的 UserID。这个 ID 通常用于私聊测试。
2. 获取群组或频道 ID
如果是群发消息,需要获取群组 ID。操作步骤如下:
- 将机器人
@get_id_bot添加到目标群组或频道中。 - 在群里发送任意消息,然后向该机器人发送命令
/my_id@get_id_bot。 - 它会返回以
-100开头的数字,例如-1001818202301,这就是该群的 Chat ID。
三、接口连通性测试
拿到 Token 和 ID 后,别急着写代码,先用工具验证一下接口是否通畅。这里提供两种最直接的测试方式。
浏览器访问:
直接在地址栏替换 {token} 和 {chatid} 为实际值,回车即可看到服务器响应。
https://api.telegram.org/bot{token}/sendMessage?chat_id={chatid}&text=HelloWorld
命令行测试:
如果你习惯用终端,curl 命令更灵活,适合批量调试。
curl -s -X POST https://api.telegram.org/bot{token}/sendMessage -d chat_id={chatid} -d text="Hello World"
如果返回 JSON 数据包含 ok: true,说明凭证无误,可以开始正式开发了。
四、群组消息权限设置
默认情况下,机器人加入群组后只能接收指令,无法读取普通消息。如果需要监听群内动态,需要调整隐私模式。
- 再次联系
@BotFather,输入/setprivacy。 - 选择对应的机器人,将其设置为
Disable模式。 - 修改完成后,建议将机器人踢出群组再重新拉入,确保新权限立即生效。
搞定以上几步,你的 Telegram 机器人环境就搭建完成了,接下来就可以根据业务需求编写具体的处理逻辑了。

