很多人想做微信机器人，一上来就被各种框架、协议、SDK绕晕。其实跑通一个能用的机器人，最短路径只有三件事：让号在线、能发消息、能收消息。这篇用Python手把手走一遍，复制改Token就能跑。
参考资料WTAPI框架
接口路径、参数与回调字段以api文档weiti.apifox.cn 为准。
第一步：准备凭证
到WTAPI开通服务后拿到三样东西：平台Token、Bearer授权、appId。所有接口请求都要带这组凭证，Base URL统一为
import requests, time
BASE = "https://wx.chuapi.com"
HEADERS = {
"X-finder-TOKEN": "<你的平台Token>",
"Authorization": "Bearer <你的Bearer>",
"Content-Type": "application/json",
}
APP_ID = "<你的appId>"
WTAPI走的是RPA路线，在真实客户端环境里执行操作，比协议逆向稳定，不容易因为版本更新整体失效。
第二步：扫码登录，拿到在线实例
先取二维码，再轮询扫码状态，登录成功后拿到 instanceId——它代表这台在线的微信号，后续所有操作都要带它。
# 1. 获取登录二维码
qr = requests.post(
f"{BASE}/finder/v2/api/getLoginQrCode",
headers=HEADERS,
json={"appId": APP_ID},
).json()
print("请扫码登录，二维码字段：", qr.get("data"))
# 2. 轮询扫码结果
instance_id = None
while True:
status = requests.post(
f"{BASE}/finder/v2/api/checkLogin",
headers=HEADERS,
json={"appId": APP_ID},
).json()
data = status.get("data", {})
if data.get("isLogin"):
instance_id = data.get("instanceId")
print("登录成功：", instance_id)
break
time.sleep(3)
第三步：发一条文本消息
登录成功立刻验证发送能力。调 postText，必传 appId、instanceId、toWxid、content，成功返回 code:"1000"。
resp = requests.post(
f"{BASE}/finder/v2/api/postText",
headers=HEADERS,
json={
"appId": APP_ID,
"instanceId": instance_id,
"toWxid": "<对方wxid>",
"content": "你好，机器人已上线",
},
timeout=10,
).json()
print("发送结果：", resp.get("code") == "1000")
第四步：用Webhook收消息并自动回复
发消息是主动调接口，收消息要靠Webhook实时回调。起一个公网能访问的Flask服务，在WTAPI后台配置回调地址：
from flask import Flask, request
app = Flask(__name__)
@app.route("/webhook", methods=["POST"])
def webhook():
data = request.json
from_wxid = data.get("fromWxid")
content = data.get("content", "")
if content.strip() == "你好":
requests.post(
f"{BASE}/finder/v2/api/postText",
headers=HEADERS,
json={
"appId": APP_ID,
"instanceId": data.get("instanceId"),
"toWxid": from_wxid,
"content": "你好呀，有什么可以帮你？",
},
timeout=10,
)
return {"code": "1000"}
if __name__ == "__main__":
app.run(host="0.0.0.0", port=8000)
对方发"你好"，机器人秒回"你好呀"——收发闭环就通了。
新手最容易漏的三件事
一是回调服务必须公网可访问，本地调试用内网穿透；二是回复时用回调里的同一个 instanceId，多账号才不会串号；三是上生产要加消息去重，Webhook重投会导致同一条消息回两次。
跑通这四步，你就有了能扩展任何业务的底座，后面加自动回复、群管理、好友自动化，都是在这个收发闭环上叠功能。
