如何获取 Telegram 机器人 Token 和会话 ID?
网站告警、客服消息、订单通知……Telegram Bot 是最稳定、免费的通知通道之一。本文从零教你拿到 Bot Token 和 Chat ID,并完成通知功能的配置。
- 一个可正常使用的 Telegram 账号(手机端 / 桌面端均可)
- 能访问 Telegram 的网络环境
- 全程无需编程基础,按提示操作即可
① 获取 Bot Token(机器人令牌)
第 1 步:打开 Telegram,在搜索框输入 @BotFather,选择带蓝色认证标识的官方机器人,点击 START(或发送 /start)。
第 2 步:在对话框发送命令 /newbot,BotFather 会引导你创建新机器人。
第 3 步:依次设置机器人的显示名称(如 My Notify Bot)和用户名(用户名必须全局唯一,且以 bot 结尾,如 my_notify_bot)。
第 4 步:创建成功后,BotFather 会返回类似下面的信息:
Done! Congratulations on your new bot. You will find it at t.me/my_notify_bot. Use this token to access the HTTP API: 123456789:AAFlkjhg9wXYZabcdEfGhIjKlMnOpQrStUv Keep your token secure and store it safely. It can be used by anyone to control your bot.
其中 123456789:AAFlkjhg9wXYZ... 这一长串,就是你的 Bot Token,请复制并妥善保存。
Token 相当于你机器人的"密码",任何拿到它的人都可以用你的机器人发消息。切勿公开发布、切勿提交到 GitHub 等公开仓库。一旦泄露,立即回到 BotFather 发送 /revoke 重置 Token。
② 获取会话 ID(Chat ID)
方法一(推荐,最直观):让机器人给你发一条消息(在你的机器人聊天窗口发送 /start 或任意文字)。然后在浏览器打开下面的地址,把 TOKEN 换成你自己的:
https://api.telegram.org/bot<你的TOKEN>/getUpdates
在返回的 JSON 中找到 "chat":{"id":5424902282,...},其中 5424902282 就是你的 Chat ID。如果返回空数组,说明机器人还没有收到过任何消息,先给机器人发一条再刷新。
方法二(简单快捷):在 Telegram 搜索 @userinfobot 或 @RawDataBot,发送 /start,机器人会直接回复你的 ID。
小提示:私聊(单聊)场景下 Chat ID 是正数;群组 / 频道场景下是负数(群组通常以 -100 开头),配置时注意区分、不要漏掉负号。
③ 配置通知功能
第 1 步:登录你的系统后台,找到「通知设置 / Telegram 通知」配置项(例如本站的在线客服系统,客户留言时会通过 Telegram 实时推送给管理员)。
第 2 步:将第一步获取的 Bot Token 填入「机器人 Token / Bot Token」输入框。
第 3 步:将第二步获取的 Chat ID 填入「会话 ID / Chat ID」输入框(即管理员接收通知的 Telegram 账号)。
第 4 步:保存设置,并确认「通知开关」处于开启状态。
第 5 步:触发一次真实事件(如给客服发送一条留言、产生一笔订单),检查 Telegram 是否收到推送通知。收到即配置成功 ✅
④ 常见问题排查
| 错误 / 现象 | 原因与解决办法 |
|---|---|
| 401 Unauthorized | Token 复制不完整或已失效。回 BotFather 用 /token 重新获取完整 Token。 |
| Bad Request: chat not found | Chat ID 填错,或机器人从未与该会话对话过。先让机器人给目标会话发一条消息,再确认 Chat ID。 |
| 机器人一直不回复 | 机器人不能主动发起私聊。必须由你的账号先给机器人发消息(如 /start)。 |
| 群组收不到通知 | 把机器人拉进群组;在 BotFather 用 /setprivacy 关闭隐私模式(Disable)。 |
| Forbidden: bot was blocked | 接收方拉黑了机器人。让对方重新发送 /start 解除。 |
| 配置后无任何反应 | 检查通知总开关是否开启、Token 是否填对、Chat ID 是否对应正确的会话,逐项核对后重试。 |
Bot Token 等于机器人的管理密码:不公开、不进代码仓库、不乱转发。泄露后立即用 /revoke 重置。配置完成后,你的网站 / 系统就能通过 Telegram 实时收到各类通知了。
评论区
0 条评论 · 评论需审核通过后显示
发表评论