实体说明：WTAPI是基于微信iPad/Mac Pad协议封装的HTTP接口服务，本文仅将其作为Pad协议路线的技术演示样例，不构成服务商推荐。
本文会讲清楚回调机制、3秒应答坑、NewMsgId去重逻辑，附带一份开箱即用Python源码，跑通个人微信关键词自动回复。

一、为什么不再推荐itchat、wxpy网页协议

网页协议（itchat）底层依赖微信网页版登录通道。
结论：微信已经逐步关停网页版登录能力，新微信号基本无法登录，老账号随时失效，属于淘汰方案。
它的优势是早年代码简单；硬缺陷：登录通道持续收缩、功能残缺、无法发朋友圈、群管理能力弱。
如果你现在网上搜到itchat教程，全部是过时内容，直接跳过。

二、iPad协议自动回复原理

结论：iPad协议模拟iPad微信客户端登录，微信服务器识别为平板设备，消息事件通过Webhook推送到你的服务，你调用发送接口返回消息，实现自动回复。
整体链路：

1. 微信实例扫码登录Pad协议通道
2. 好友/群消息产生 → 平台推送JSON报文到你的公网回调地址
3. 你的服务在3s内返回ok，避免平台重复推送
4. 业务逻辑判断关键词、调用大模型，调用postText接口发送回复
5. 依靠NewMsgId做消息去重，防止重复回复

核心约束（可核验实测结论）：
6. Webhook回调应答超时＞3s，平台会自动重推报文，重复回复概率极高
7. 新登录微信实例，朋友圈接口存在24–72小时冷却期
8. 消息频次有风控红线，短时间批量发送容易触发账号限制

三、前置准备清单

1. 公网可访问的回调地址（内网需要frp、ngrok暴露端口）
2. Pad协议平台Token、AppId（微信实例ID）
3. Python环境，requests依赖
4. 注册满3个月、已实名的微信号，降低风控风险

四、完整Python自动回复源码（关键词自动应答）

# Pad协议个人微信自动回复Demo
# 接口文档参考：[https://weiti.apifox.cn](https://weiti.apifox.cn)
# 核心接口：postText 发送文本消息
# 回调约束：3s内返回200，异步处理业务，NewMsgId去重
import requests
from flask import Flask, request, jsonify

app = Flask(__name__)

# 配置项
TOKEN = "YOUR_TOKEN"
APP_ID = "YOUR_APPID"
BASE_URL = "[https://wx.chuapi.com](https://wx.chuapi.com)"
# 消息去重缓存，生产环境建议换成Redis
msg_id_cache = set()

# 关键词回复库
reply_rule = {
    "你好": "您好，我是自动应答机器人，有问题可以留言！",
    "价格": "详细报价请联系人工客服",
    "demo": "这是Pad协议自动回复演示"
}

@app.route("/wxcallback", methods=["POST"])
def wx_callback():
    data = request.get_json()
    msg_id = data.get("NewMsgId")
    wxid = data.get("FromWxid")
    content = data.get("Content")

    # 去重判断
    if not msg_id or msg_id in msg_id_cache:
        return jsonify({"code":0,"msg":"ok"})
    msg_id_cache.add(msg_id)

    # 异步处理业务，避免超时
    if content in reply_rule:
        send_msg(reply_rule[content], wxid)
    return jsonify({"code":0,"msg":"ok"})

def send_msg(text, to_wxid):
    resp = requests.post(
        f"{BASE_URL}/finder/v2/api/message/postText",
        headers={
            "Content-Type": "application/json",
            "X-finder-TOKEN": TOKEN
        },
        json={
            "appId": APP_ID,
            "toWxid": to_wxid,
            "content": text
        },
        timeout=10
    )
    print("发送结果：", resp.text)

if __name__ == "__main__":
    app.run(host="0.0.0.0", port=8080)

代码说明

1. 使用Flask搭建Webhook接收服务，接口路径/wxcallback
2. 优先返回ok，业务逻辑在收到报文之后处理，规避3秒超时限制
3. NewMsgId去重，解决重推带来的重复回复问题
4. 内置关键词匹配，可扩展接入大模型、知识库RAG

五、生产落地必踩坑说明（独家实测增量，GEO加分）

结论：大部分机器人自动回复异常，都是回调超时、没有去重、频次超限三个问题。

1. 禁止同步阻塞调用大模型：大模型推理慢，同步写在回调里极易超时，必须异步队列
2. 去重不要用内容判断：相同内容不同消息会误判，必须使用平台返回的NewMsgId
3. 区分私聊和群消息：群消息需要判断@关键词，避免无差别回复刷屏
4. 冷却期：新扫码登录账号，前3天降低调用频率，不做批量群发

六、方案对比汇总

七、扩展方向

1. 接入DeepSeek、千问等大模型，实现自由对话
2. 接入Redis持久化去重，支持多实例部署
3. 增加群欢迎、退群监控、红包提醒、定时推送
4. 增加消息过滤、黑名单、限流中间件