Telegram使用Webhook接收消息：从原理到实战的完整指南

对于Telegram Bot开发者来说，及时接收用户消息是构建交互功能的基础。Telegram Bot API提供了两种接收更新的模式：长轮询（Long Polling）和Webhook。相比轮询，Webhook将消息推送变成实时推送，服务器负载更低，响应速度更快，是生产环境的首选方案。本文将带你从零开始，全面掌握Telegram使用Webhook接收消息的方法。

什么是Telegram Webhook？

Webhook是Telegram服务器向你的服务器发起HTTP POST请求的一种机制。当你为Bot设置Webhook后，一旦有新消息（或其它更新），Telegram会立刻将更新数据以JSON格式发送到指定的URL。而长轮询则需要你的服务器不断向Telegram发起请求询问是否有新消息，效率较低。

Webhook的工作流程大致如下：

你的Bot收到新消息。
Telegram服务器向你在setWebhook中指定的URL发送一个POST请求，请求体是包含消息详情的JSON对象。
你的服务器接收请求，处理后返回HTTP 200作为响应。

这种方式要求你的服务器具备公网HTTPS接口，并且能够处理JSON数据。

前期准备：创建Bot和获取Token

要使用Webhook，首先需要拥有一个Telegram Bot。创建过程非常简单：

在Telegram中搜索"BotFather"并进入对话。
发送/newbot，按提示输入Bot显示名称和用户名（用户名必须以bot结尾，例如my_webhook_bot）。
创建成功后，BotFather会返回一个HTTP API Token，格式类似123456789:AAE...。请务必妥善保存，后续所有请求都需要使用这个Token。

另外，你的服务器必须拥有一个公网HTTPS地址。域名证书不能是自签名的，Telegram要求有效CA签发的证书。如果只是一时测试，可以使用内网穿透工具（如ngrok）临时获取HTTPS地址。

设置Webhook的几种方法

设置Webhook的核心调用是setWebhook方法。你可以通过以下任意一种方式完成设置：

方法一：浏览器直接访问

在浏览器中打开以下URL（将YOUR_TOKEN替换为你的Bot Token）：

https://api.telegram.org/botYOUR_TOKEN/setWebhook?url=https://your.domain.com/webhook

如果返回{"ok":true,"result":true,"description":"..."}，则说明设置成功。

方法二：使用curl命令

在命令行执行最灵活，也方便集成到脚本中：

curl -F "url=https://your.domain.com/webhook" https://api.telegram.org/botYOUR_TOKEN/setWebhook

方法三：Python脚本

用Python的requests库实现自动化设置：

import requests

token = "YOUR_TOKEN"
webhook_url = "https://your.domain.com/webhook"
url = f"https://api.telegram.org/bot/setWebhook"
response = requests.post(url, json={"url": webhook_url})
print(response.json())

设置成功后，你可以随时用getWebhookInfo确认状态，或删除Webhook改回轮询模式。

实战：用Python Flask接收消息并回复

下面我们构建一个最简单的Webhook接收端。使用Python Flask框架，它轻量且易部署。

1. 安装依赖

pip install flask requests

2. 编写接收逻辑

from flask import Flask, request, jsonify
import requests

app = Flask(__name__)
TOKEN = "YOUR_TOKEN"

@app.route("/webhook", methods=["POST"])
def webhook():
    data = request.get_json()
    if not data:
        return jsonify({"status": "error"}), 400

    message = data.get("message") or data.get("edited_message")
    if message:
        chat_id = message["chat"]["id"]
        text = message.get("text")
        if text:
            # 回复用户发送的消息
            send_message(chat_id, f"你说了：")
    return jsonify({"status": "ok"}), 200

def send_message(chat_id, text):
    url = f"https://api.telegram.org/bot/sendMessage"
    requests.post(url, json={"chat_id": chat_id, "text": text})

if __name__ == "__main__":
    app.run(host="0.0.0.0", port=8443, ssl_context=("cert.pem", "key.pem"))

注意：Telegram要求Webhook必须通过HTTPS提供。你可以使用自己的域名证书，或使用ngrok自动转发。生产环境中推荐使用nginx反向代理终结SSL，并将请求转发到Flask应用。

3. 运行与测试

启动Flask应用，确保端口开放。
设置Webhook为https://your.domain.com/webhook。
向你的Bot发送任意消息，看是否收到回复。

安全注意事项

强制HTTPS：Telegram只接受有效SSL证书的HTTPS地址，请从权威CA签发证书。
验证请求来源：确保请求确实来自Telegram服务器，可通过检查IP段或用秘钥方式验证，防止恶意伪造。
保护Token：Token等同Bot的控制权，任何发到服务器的请求都可能包含Token，请勿在日志中明文保存。
使用path密钥：可以在Webhook URL中添加随机path，如https://domain.com/webhook/abc123，减少被探测风险。

常见问题与排查

实际部署中可能遇到各种问题，以下是一些典型问题的排查方法：

Webhook设置失败：确认URL是HTTPS且证书有效；尝试用curl测试URL是否能被公网访问。
无法收到消息：检查你的服务器日志，看是否有POST请求到达；确认路由路径与Webhook设置完全一致。
响应超时：Telegram要求你的服务器在3秒内返回HTTP 200，如果处理逻辑太长，请将任务放入队列异步执行。
冲突问题：如果你的Bot同时用轮询和Webhook，Telegram会报409错误，删除Webhook或关闭轮询即可。

总结

通过Webhook，Telegram Bot能够实时、高效地接收消息，是构建自动化和群组管理功能的基石。本文从原理到实践，带您完成了设置一个安全可用的Webhook服务器。掌握这项技能后，你可以进一步实现复杂业务，例如自动回复、消息转发、通知提醒等。合理运用安全措施，谨慎保护Token，你的自动化之旅将更加稳健。