Telegram如何配置

Telegram 机器人完整配置教程（适配本插件）

一、核心前提

1. 服务器需能访问 Telegram 官方接口（api.telegram.org），若服务器在国内，需配置代理 / 科学上网；
2. 需有 Telegram 账号（手机注册），并能正常登录。

二、步骤 1：创建 Telegram 机器人（获取 Token）

1. 打开 Telegram，搜索机器人 @BotFather（官方机器人创建工具），点击「开始」或发送 /start；
2. 发送 /newbot 命令，按提示创建机器人：
   • 第一步：输入机器人名称（自定义，如「我的网站通知机器人」）；
   • 第二步：输入机器人用户名（必须以 bot 结尾，如 my_site_notify_bot）；
3. 创建成功后，@BotFather 会返回机器人 Token（格式：123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11），复制此 Token 保存好（后续配置用）。

补充：若忘记 Token，可给 @BotFather 发送 /mybots → 选择对应机器人 → 点击「API Token」即可查看。

三、步骤 2：获取 ChatID（接收通知的目标：个人 / 群聊）

方式 1：获取个人 ChatID（通知推送给自己）

1. 在 Telegram 搜索机器人 @userinfobot，点击「开始」或发送 /start；
2. 该机器人会直接返回你的个人 ChatID（数字格式，如 123456789），复制保存。

方式 2：获取群聊 ChatID（通知推送给群聊）

1. 创建 Telegram 群聊（或使用现有群聊），将你创建的通知机器人加入群聊；
2. 在群聊中 @ 机器人 @getidsbot（发送 @getidsbot 即可，无需空格）；
3. @getidsbot 会回复群聊信息，其中 chat_id 字段即为群聊 ChatID（负数格式，如 -1001234567890），复制保存；
4. 关键：给机器人授予「发送消息」权限 → 群聊设置 → 管理员 → 添加你的机器人 → 勾选「发送消息」「查看消息」权限。

四、步骤 3：插件后台配置 Telegram 机器人

1. 登录 WordPress 后台 → 「设置」→「机器人通知」；
2. 在「机器人配置」区域：
   • 点击「添加机器人」（或编辑现有机器人）；
   • 机器人名称：自定义（如「Telegram 通知机器人」）；
   • 机器人类型：选择「Telegram 机器人」；
   • Webhook 地址：按格式填写（替换为你的 Token）：

     https://api.telegram.org/bot<你的Token>/sendMessage

     示例（Token 为 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11）：

      

     https://api.telegram.org/bot123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11/sendMessage

   • 密钥（加签用）：Telegram 无需填写，留空即可；
   • 额外字段 → ChatID：填写步骤 2 中获取的「个人 ChatID」或「群聊 ChatID」；
   • 勾选「启用」，点击「保存设置」。

五、步骤 4：测试通知是否生效

1. 在插件后台「测试通知」区域，点击「发送测试通知」；
2. 查看 Telegram 个人聊天窗口 / 群聊，会收到包含「UTC 时间 + 北京时间」的测试消息，说明配置成功。

六、常见问题排查

问题 1：测试通知发送失败，提示「请求失败」

• 原因：服务器无法访问 Telegram 接口（国内服务器常见）；
• 解决：
  1. 给服务器配置代理（如 Clash、V2Ray），确保 curl https://api.telegram.org 能正常访问；
  2. 或使用 Telegram 反向代理地址替换 Webhook 中的 api.telegram.org，例如：
      

     https://tg-api.xxxx.com/bot<你的Token>/sendMessage

      

问题 2：ChatID 正确但收不到消息

• 原因 1：机器人未被加入群聊（群聊场景）→ 重新添加机器人到群聊，并授予发消息权限；
• 原因 2：个人 ChatID 错误 → 重新给 @userinfobot 发消息获取；
• 原因 3：机器人被限制 → 给 @BotFather 发送 /setprivacy → 选择对应机器人 → 选择 Disable（关闭隐私模式）。

问题 3：插件提示「ChatID 为空」

• 解决：检查插件配置中「额外字段 → ChatID」是否填写，确保无空格 / 错误字符。

七、注意事项

1. Telegram 机器人 Token 是核心凭证，切勿泄露给他人；
2. 群聊场景下，若群聊人数较多，需确保机器人未被禁言；
3. 若长期收不到通知，可重新生成 Token（@BotFather → /mybots → 对应机器人 → Regenerate Token），并更新插件中的 Webhook 地址。