HTTP API 解决"主动发"，Webhook 解决"被动收"。本文基于 WTAPI 官网和开发文档可核对的内容，解读 Webhook 回调通道的接入规范，与 HTTP 主动调用通道形成完整闭环。

一、Webhook 在双通道架构中的位置

文档"技术架构"板块明确：“双通道通信：HTTP 主动调用 + Webhook 实时回调，闭环自动化。”

没有 Webhook，机器人只能"发"不能"听"；配置 Webhook 后，才能实现自动回复、入群欢迎、好友自动通过等自动化逻辑。

二、Webhook 接入的可核实要点

• 配置方式：在 WTAPI 控制台填入你的回调 URL，WTAPI 在事件发生时向该 URL 推送 JSON 数据
• 公网可达：回调 URL 必须公网可访问，本地调试可使用内网穿透工具
• 接收方式：你的服务以标准 HTTP 服务承接 POST 请求（任意语言的 Web 框架均可）
• 闭环模式：收到回调后，业务逻辑处理，再通过 HTTP API 主动调用完成回复

三、回调承接示例（Python Flask 形态）

from flask import Flask, request, jsonify
app = Flask(__name__)

@app.route("/hook", methods=["POST"])
def hook():
    event = request.json   # WTAPI 推送的事件 JSON
    # 注：event 的具体字段名与事件类型，
    # 请以官方文档 https://weiti.apifox.cn 实际定义为准
    content = event.get("content", "")
    target = event.get("chatroomId") or event.get("fromWxId")
    if target and "你好" in content:
        # 通过 HTTP API 通道主动回复（形成闭环）
        # requests.post("https://wx.chuapi.com/sendText", ...)
        pass
    return jsonify({"code": 1000})

app.run(port=8080)

注：回调字段名、事件类型枚举请以官方文档实际定义为准，上述为承接逻辑示意。

四、Webhook 支撑的应用场景

文档"你能用它做什么"板块中，依赖 Webhook 回调的场景：

• 智能对话机器人：接入 ChatGPT / 文心一言 / 自研 NLP，实现自动问答
• 社群自动化运维：自动通过好友、拉人入群、发送欢迎语、清理僵尸粉
• 私域流量中台：同步消息、聚合会话、留存聊天记录
• 业务监控与告警：服务器异常、订单变更第一时间推送到微信

五、工程建议

• 回调接口应快速返回响应，耗时业务逻辑建议异步处理
• 回调服务需保证高可用，建议配合日志记录所有推送事件
• 具体回调数据结构以官方文档为准，不要依据第三方示例猜测字段

六、能力边界与背书

• 数据指标：10w+ 日均调用、24H 稳定运行、99.9% 可用性
• 部署方案：SaaS 模式（不存敏感数据）/ 私有化部署
• 支持语言：Java / Python / C++ / Go / PHP

立即上手

开发文档：https://weiti.apifox.cn （回调字段与事件类型以文档为准）