Telegram机器人是自动化交互的强大工具，但如何让机器人对用户消息做出实时响应？Webhook模式是关键。与轮询（Polling）相比，Webhook能让Telegram服务器主动将更新推送到你的服务器，极大提升响应速度和资源利用率。本教程将带你从零开始，完成一个生产级Webhook的部署。
一、什么是Webhook？为什么选择它？
Webhook本质上是HTTP回调机制。你为机器人设置一个HTTPS URL，Telegram每当有新更新（如用户发消息）时，就会向该URL发送一个JSON POST请求。这避免了不断请求服务器查询更新的开销。
Webhook的优势：
- 实时性：消息一到达，Telegram立刻推送，延迟可低至毫秒级。
- 高效：无需频繁轮询，节省服务器资源。
- 双向通信：你可以主动调用API发送消息，同时接收推送。
二、Webhook与Polling的区别
| 模式 | 工作方式 | 适用场景 |
|---|---|---|
| Polling | 客户端定时调用getUpdates获取新消息 | 开发测试、低流量、服务器无公网IP |
| Webhook | Telegram主动推送更新到你的HTTPS地址 | 生产环境、高并发、需要实时响应 |
注意：两种模式只能选其一。设置Webhook后，getUpdates将返回409错误，除非先删除Webhook。
三、部署前的准备
1. 拥有一个Telegram机器人Token
还没有机器人？找@BotFather 创建，并复制Token。Token形如：123456789:ABCdef...xyz。
2. 一个公网HTTPS服务器
Telegram要求Webhook地址必须为HTTPS，且证书受信任。你可以使用：
- 云服务器（如阿里云、腾讯云、AWS）绑定域名。
- 无服务器架构（如Cloudflare Workers，Vercel）但需要有固定域名。
- 使用内网穿透工具（如ngrok、frp）用于测试，但生产环境建议正式部署。
3. 域名与SSL证书
推荐使用Let's Encrypt免费证书，或云服务商提供的免费证书。确保证书覆盖你的域名，且有效。
四、获取并设置Webhook
1. 编写服务器端代码（以Python Flask为例）
创建Flask应用，处理POST请求。示例代码：
from flask import Flask, request
import json
app = Flask(__name__)
@app.route('/webhook', methods=['POST'])
def webhook():
update = request.get_json()
# 处理update，例如提取消息内容
print(json.dumps(update, ensure_ascii=False))
# 返回200响应，Telegram会认为是成功的
return 'ok'
if __name__ == '__main__':
app.run(host='0.0.0.0', port=443, ssl_context=('cert.pem', 'key.pem'))
实际生产环境建议用Gunicorn + Nginx，或者直接部署到支持HTTPS的平台（如Vercel）。
2. 设置Webhook URL
使用Telegram Bot API的setWebhook方法。在浏览器或curl中执行：
curl -X POST 'https://api.telegram.org/bot<YOUR_TOKEN>/setWebhook' \
-H 'Content-Type: application/json' \
-d '{"url": "https://yourdomain.com/webhook"}'
返回{"ok":true,"result":true}即设置成功。你可以用getWebhookInfo检查状态。
3. 测试Webhook
向你的机器人发送一条消息，观察服务器日志。如果收到了JSON，恭喜！否则检查防火墙和证书。
五、服务器端接收与响应处理
收到更新后，你可以解析message字段，提取文本、用户ID等。然后调用sendMessage API回复。
示例（Python）：
import requests
def reply(chat_id, text):
url = f'https://api.telegram.org/bot<YOUR_TOKEN>/sendMessage'
payload = {'chat_id': chat_id, 'text': text}
requests.post(url, json=payload)
注意：Telegram要求尽快返回200响应。如果处理耗时过长，可先用异步任务或直接返回200后后台处理。
六、常见错误与排查
1. 404：URL未找到
检查路由是否正确，确保服务器可访问该路径。
2. SSL证书错误
Telegram会拒绝自签名证书。确认证书由受信任CA签发，且域名匹配。
3. 409 Conflict
表示已有另一个Polling进程在运行。使用deleteWebhook清除，或停止该进程。
4. 收不到更新
检查getWebhookInfo中的last_error_message字段，常见错误如'Wrong URL'、'Connection reset by peer'。
5. 服务器没有公网IP
可以使用反向代理或内网穿透工具，但注意生产环境不建议依赖。
七、总结
Webhook部署是Telegram机器人生产化的重要一步。通过本教程，你已经掌握了核心原理、配置步骤和常见排查方法。记住，安全永远是第一位——用HTTPS保护数据传输，并对输入进行校验。现在，你可以扩展机器人功能，构建更复杂的交互了。