如何配置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
相关产品推荐
相关产品推荐

