在Telegram机器人开发中，接收用户消息是核心功能之一。除了常见的轮询（Polling）方式，Webhook以其实时性和高效性成为生产环境的首选。本文将深入讲解如何利用Webhook接收消息，从原理到具体代码实现，帮你避开常见坑点。
一、什么是Webhook？为什么选择它？
Webhook是一种主动推送机制：Telegram服务器在收到用户发给机器人的消息后，会立刻向预先设置的HTTPS地址发送一个包含更新数据的POST请求。相比轮询，Webhook具有以下优势：
- 实时性高：消息几乎零延迟到达，无需定时请求。
- 节省资源：无需频繁轮询，降低服务器负载和API调用次数。
- 架构简洁：你只需处理POST请求，逻辑更清晰。
二、准备工作
开始之前，你需要准备：
- 一个Telegram机器人Token（通过BotFather获取）。
- 一台公网可达的服务器，且必须支持HTTPS（必须是有效证书，Telegram不支持自签名证书）。
- 一个域名或子域名，并配置好SSL证书（可使用Let's Encrypt免费申请）。
注意：手机或本地电脑无法直接接收Webhook，必须部署到云服务器。
三、设置Webhook的两种方法
方法1：浏览器直接设置（适合快速测试）
在浏览器地址栏输入以下地址（将<token>替换为你的机器人Token）：
https://api.telegram.org/bot<token>/setWebhook?url=https://你的域名/webhook返回JSON中ok为true即表示设置成功。
方法2：通过Python脚本设置（推荐）
import requests
TOKEN = "你的机器人Token"
WEBHOOK_URL = "https://你的域名/webhook"
response = requests.post(
f"https://api.telegram.org/bot/setWebhook",
json={"url": WEBHOOK_URL}
)
print(response.json())
四、Python代码接收Webhook（Flask示例）
以下代码使用Flask搭建一个简单的Webhook服务，能接收任何类型消息并回复“收到”。
import json
import requests
from flask import Flask, request
app = Flask(__name__)
TOKEN = "你的机器人Token"
BASE_URL = f"https://api.telegram.org/bot"
@app.route("/webhook", methods=["POST"])
def webhook():
update = request.get_json()
if "message" in update:
chat_id = update["message"]["chat"]["id"]
text = update["message"].get("text", "")
# 回复消息
requests.post(f"/sendMessage", json={
"chat_id": chat_id,
"text": f"你说了："
})
return "OK", 200
if __name__ == "__main__":
app.run(host="0.0.0.0", port=5000, ssl_context=("cert.pem", "key.pem"))
注意：ssl_context需要你的证书文件路径。如果使用反向代理（如Nginx），则无需在Flask中配置SSL，但必须确保代理转发正常。
五、安全验证：确保请求来自Telegram
为防止伪造请求，Telegram允许你验证请求头X-Telegram-Bot-Api-Secret-Token。设置方法：
# 设置Webhook时附加secret_token参数
requests.post(f"https://api.telegram.org/bot/setWebhook", json={
"url": WEBHOOK_URL,
"secret_token": "你的自定义密钥"
})
然后在Flask代码中验证：
from flask import Flask, request, abort
SECRET_TOKEN = "你的自定义密钥"
@app.route("/webhook", methods=["POST"])
def webhook():
if request.headers.get("X-Telegram-Bot-Api-Secret-Token") != SECRET_TOKEN:
abort(403)
# 继续处理…
六、常见问题与排查
Q1：Webhook设置成功但收不到消息？
- 检查HTTPS证书是否有效（可用在线工具测试）。
- 检查是否同时启用了轮询（必须调用
deleteWebhook关闭轮询）。 - 检查公网IP和端口是否开放，以及域名解析是否正确。
Q2：怎样查看当前Webhook状态？
https://api.telegram.org/bot<token>/getWebhookInfo返回信息包含last_error_message，能直接告诉你错误原因。
Q3：处理失败时如何响应？
Telegram要求你的服务器返回200，否则会重试。如果处理过程较慢，建议先返回200，再异步处理（如使用队列）。
七、最佳实践建议
- 使用HTTPS反向代理：推荐用Nginx或Caddy代理你的应用，简化证书管理。
- 异步处理：用Celery或Redis队列处理耗时任务，避免Webhook超时。
- 日志记录：保存完整的update日志，便于调试和数据分析。
- 版本控制：使用webhook时可以上传证书，但建议用负载均衡方案。
总结
通过Webhook接收消息是Telegram机器人开发的核心技能。本文从原理到实战，详细介绍了设置方法、代码示例和安全验证。在实际部署中，请务必注意HTTPS配置、证书有效性以及请求验证。掌握这些后，你就能构建实时响应、稳定可靠的Telegram机器人了。