You need to enable JavaScript to run this app. 如何配置Telegram Bot将群组全部消息自动转发至自有PHP服务器
优惠活动
大模型
产品
解决方案
定价
更多

如何配置Telegram Bot将群组全部消息自动转发至自有PHP服务器

核心实现逻辑

Telegram Bot不具备主动拉取群组全量消息的能力,必须通过官方Webhook机制被动接收符合权限要求的消息推送,不存在本地脚本定时抓取群消息的可行方案。

第一步:Bot与群组基础权限配置
  • 通过@BotFather创建目标Bot,获取专属的API访问Token
  • 关闭Bot默认开启的隐私模式:这是配置过程中最容易遗漏的核心步骤,默认隐私模式下Bot仅能收到@它的命令、服务类系统消息,无法接收普通成员发送的常规聊天内容。可通过BotFather的/setprivacy指令选择对应Bot,设置为Disable即可
  • 将Bot添加到目标群组:普通成员身份即可满足接收全量消息的需求,无需授予管理员权限(除非后续需要执行消息撤回、踢人等操作)
  • 针对超级群组:需要在群组权限设置页,单独开启Bot的“读取所有消息”开关,部分新版本Telegram客户端中该权限和普通聊天权限独立配置
第二步:绑定Webhook到你的PHP服务器
  • 按照Telegram接口规则发起请求,把消息推送地址绑定到你的PHP服务接口:
    • 接口请求格式:https://api.telegram.org/bot<你的BotToken>/setWebhook?url=https://你的服务器域名/telegram/receive.php&secret_token=自定义随机校验字符串
    • 强制要求:你的PHP服务接口必须使用HTTPS协议,配置受信任的CA证书,服务端口必须是Telegram允许的443、80、88、8443端口,不支持非标准端口和自签名证书(除非上传对应公钥完成证书校验)
  • 配置完成后可调用getWebhookInfo接口校验配置状态,若返回结果中的推送地址和你设置的一致,且没有最近推送错误记录,即为配置生效
第三步:PHP服务端接收逻辑编写
  • 注意:Telegram推送的内容为JSON格式,不要依赖PHP默认的$_POST全局变量接收数据,需直接读取原始请求体:
// 读取Telegram推送的原始数据
$payload = json_decode(file_get_contents('php://input'), true);
// 校验请求合法性,匹配你设置的secret_token
$requestSecret = $_SERVER['HTTP_X_TELEGRAM_BOT_API_SECRET_TOKEN'] ?? '';
if ($requestSecret !== '你之前设置的自定义随机字符串') {
    http_response_code(403);
    exit;
}
// 提取消息核心字段
if (isset($payload['message'])) {
    $groupChatId = $payload['message']['chat']['id']; // 来源群组ID
    $senderUserId = $payload['message']['from']['id']; // 发信用户ID
    $senderName = $payload['message']['from']['first_name']; // 发信用户昵称
    $messageContent = $payload['message']['text'] ?? $payload['message']['caption'] ?? '[非文本消息]'; // 兼容普通文本、媒体消息说明
    // 在此处编写你的消息转发、存储业务逻辑
}
// 必须返回200状态码,否则Telegram会判定推送失败,反复重试发送同一条消息
http_response_code(200);
常见配置踩坑说明
  • 不要使用长轮询getUpdates方案做实时消息同步:轮询间隔会带来不可控的消息延迟,高并发场景下还容易丢消息,Webhook是官方支持的实时全量推送方案
  • 若配置完成后Bot收不到普通成员的消息,优先排查两个点:隐私模式是否关闭、超级群组内的消息读取权限是否开启,两个条件任意一个不满足,都无法收到非@Bot的普通聊天内容
  • 不要在Webhook接收接口中编写耗时业务逻辑(如大文件处理、跨接口同步),否则会因接口响应超时触发Telegram的推送重试,建议收到消息后先写入本地队列,由异步任务处理后续业务

内容的提问来源于stack exchange,提问作者Zipette

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.14 22:06:09