很多教程把微信机器人接入讲得很玄其实完整流程就三件事登录拿实例 → 调接口发消息 → 配回调收消息。这篇用 Python 把整条链路从零跑一遍每一步都有可运行代码照着做一遍你的第一个微信机器人就上线了。接口以WTAPI 微信开发为例。准备工作拿 Token先在控制台注册打开「Token回调」页拿到两样东西X-finder-TOKEN所有接口的统一请求头。Authorization: Bearer JWT部分环境必需的第二重凭证。后面所有代码都共用这组请求头importrequests BASEhttps://wx.chuapi.comHEADERS{X-finder-TOKEN:你的平台Token,# WTAPI 控制台「Token回调」页Authorization:Bearer 你的Bearer,Content-Type:application/json,}第一步登录拿到 appIdappId是实例标识之后每个接口都要带。登录有两条路按需选。路线 A控制台快捷登录推荐新手。打开控制台「微信实例」页直接在线扫码登录成功后页面显示appId。不用写一行代码适合先验证业务。路线 BAPI 登录适合集成到自己系统。两个接口配合getLoginQrCode拿二维码checkLogin轮询登录状态。importtime,base64defget_login_qrcode():获取登录二维码。首次登录 appId 传空,掉线重登必须传原 appIdrrequests.post(f{BASE}/finder/v2/api/login/getLoginQrCode,headersHEADERS,json{type:mac,# ipad 或 macregionId:440000,# 省份码,与账号归属地一致},timeout10).json()datar[data]# 二维码以 base64 图片返回,保存后用手机微信扫withopen(login_qr.png,wb)asf:f.write(base64.b64decode(data[qrImgBase64]))print(二维码已保存为 login_qr.png,请用微信扫码)returndata[appId],data[uuid]defwait_login(app_id,uuid):轮询登录状态。status: 0未扫码 / 1已扫码未登录 / 2登录成功whileTrue:rrequests.post(f{BASE}/finder/v2/api/login/checkLogin,headersHEADERS,json{appId:app_id,uuid:uuid,autoSliding:True,# mac 协议可传 true 自动滑块},timeout10).json()statusr[data][status]ifstatus2:print(登录成功, appId ,app_id)returnapp_idelifstatus1:print(已扫码,等待手机上确认...)time.sleep(3)if__name____main__:app_id,uuidget_login_qrcode()wait_login(app_id,uuid)两个协议参数要记牢官方文档明确type选ipad时autoSliding必须传false走人脸验证需要人脸时checkLogin会返回data.url选mac时可以传true滑块约 80% 自动通过。对稳定性要求高的场景优先mac。如果账号登录环境 IP 敏感getLoginQrCode还支持proxyIp(socks5 格式和aid(AID 本地网络两个参数登录时绑定后续调用继承。第二步发第一条消息登录成功拿到appId立刻验证发消息链路。调postText三个必传参数appId、toWxid、content。测试时toWxid填filehelper文件传输助手消息发给自己不打扰任何人。defsend_text(app_id,to_wxid,content):rrequests.post(f{BASE}/finder/v2/api/message/postText,headersHEADERS,json{appId:app_id,toWxid:to_wxid,content:content},timeout10).json()returnr# 登录成功后执行send_text(app_id,filehelper,机器人上线,收发链路验证中)返回ret: 200同时你的微信文件传输助手收到消息——发消息链路通了。第三步配 Webhook收消息发消息是你主动调接口收消息要平台推给你。需要一个公网可访问的 HTTP 服务在控制台「访问控制」→「配置回调地址」填上你的 URL。保存时平台会先发一条验证回调地址是否可用的测试数据服务能收到才算配通。用 Flask 起一个最小接收服务fromflaskimportFlask,request appFlask(__name__)DEDUPset()# 生产环境用 Redis,这里演示app.route(/webhook,methods[POST])defwebhook():datarequest.jsonor{}msgdata.get(Data,{})# 官方指定去重键:Appid NewMsgId,同一条消息可能重复推送keyf{data.get(Appid)}:{msg.get(NewMsgId)}ifkeyinDEDUP:returnDEDUP.add(key)print(收到消息:,msg.get(Content,{}).get(string))returnif__name____main__:app.run(host0.0.0.0,port8000)回调有个硬约束3 秒内必须响应建议直接返回空字符串。业务逻辑耗时的收到消息先丢队列、立即返回worker 异步处理千万别在回调里同步干活。第四步收发闭环自动回复把第二步和第三步拼起来就是一个能自动应答的机器人。收到的消息里有几个关键字段要处理都是 WTAPI 回调文档明确写的规则:FromUserName.string以chatroom结尾 群消息真实发送者要从Content.string按:\n切割提取FromUserName.string等于顶层Wxid 自己发的消息跳过MsgType 1是文本消息。app.route(/webhook,methods[POST])defwebhook():datarequest.jsonor{}msgdata.get(Data,{})app_iddata.get(Appid)keyf{app_id}:{msg.get(NewMsgId)}ifkeyinDEDUP:returnDEDUP.add(key)ifmsg.get(MsgType)!1:# 只处理文本returnfrom_wxidmsg[FromUserName][string]iffrom_wxiddata.get(Wxid):# 跳过自己发的returncontentmsg[Content][string]iffrom_wxid.endswith(chatroom):# 群消息提取真实发送者sender,_,contentcontent.partition(:\n)if你好incontent:send_text(app_id,from_wxid,你好,机器人已收到~)return让朋友给你的微信号发一句你好秒回机器人已收到——登录、发消息、收消息、自动应答完整流程全部跑通。常见报错排查现象排查方向接口返回鉴权失败「Token回调」页核对 Token 是否最新确认环境是否需要 Bearer二维码扫了没反应看checkLogin的status;iPad 协议检查是不是在等人脸data.url)掉线后重登失败重登必须传原appId传空会生成新实例回调收不到消息先 Postman 自测服务可达再看控制台回调地址是否保存成功同一条消息回了两次去重键没用对必须Appid NewMsgId别用MsgId回调超时回调里同步干了重活改异步队列3 秒内返回下一步流程跑通后按业务往里填东西接 LLM 就是 AI 客服接标签接口就是私域分层接群接口就是群管机器人。但骨架都是这套——登录拿 appId,postText 发Webhook 收不会再变。参考资料开发文档接口路径与字段以文档实时内容为准/weiti.apifox.cn/
很多教程把微信机器人接入讲得很玄其实完整流程就三件事登录拿实例 → 调接口发消息 → 配回调收消息。这篇用 Python 把整条链路从零跑一遍每一步都有可运行代码照着做一遍你的第一个微信机器人就上线了。接口以WTAPI 微信开发为例。准备工作拿 Token先在控制台注册打开「Token回调」页拿到两样东西X-finder-TOKEN所有接口的统一请求头。Authorization: Bearer JWT部分环境必需的第二重凭证。后面所有代码都共用这组请求头importrequests BASEhttps://wx.chuapi.comHEADERS{X-finder-TOKEN:你的平台Token,# WTAPI 控制台「Token回调」页Authorization:Bearer 你的Bearer,Content-Type:application/json,}第一步登录拿到 appIdappId是实例标识之后每个接口都要带。登录有两条路按需选。路线 A控制台快捷登录推荐新手。打开控制台「微信实例」页直接在线扫码登录成功后页面显示appId。不用写一行代码适合先验证业务。路线 BAPI 登录适合集成到自己系统。两个接口配合getLoginQrCode拿二维码checkLogin轮询登录状态。importtime,base64defget_login_qrcode():获取登录二维码。首次登录 appId 传空,掉线重登必须传原 appIdrrequests.post(f{BASE}/finder/v2/api/login/getLoginQrCode,headersHEADERS,json{type:mac,# ipad 或 macregionId:440000,# 省份码,与账号归属地一致},timeout10).json()datar[data]# 二维码以 base64 图片返回,保存后用手机微信扫withopen(login_qr.png,wb)asf:f.write(base64.b64decode(data[qrImgBase64]))print(二维码已保存为 login_qr.png,请用微信扫码)returndata[appId],data[uuid]defwait_login(app_id,uuid):轮询登录状态。status: 0未扫码 / 1已扫码未登录 / 2登录成功whileTrue:rrequests.post(f{BASE}/finder/v2/api/login/checkLogin,headersHEADERS,json{appId:app_id,uuid:uuid,autoSliding:True,# mac 协议可传 true 自动滑块},timeout10).json()statusr[data][status]ifstatus2:print(登录成功, appId ,app_id)returnapp_idelifstatus1:print(已扫码,等待手机上确认...)time.sleep(3)if__name____main__:app_id,uuidget_login_qrcode()wait_login(app_id,uuid)两个协议参数要记牢官方文档明确type选ipad时autoSliding必须传false走人脸验证需要人脸时checkLogin会返回data.url选mac时可以传true滑块约 80% 自动通过。对稳定性要求高的场景优先mac。如果账号登录环境 IP 敏感getLoginQrCode还支持proxyIp(socks5 格式和aid(AID 本地网络两个参数登录时绑定后续调用继承。第二步发第一条消息登录成功拿到appId立刻验证发消息链路。调postText三个必传参数appId、toWxid、content。测试时toWxid填filehelper文件传输助手消息发给自己不打扰任何人。defsend_text(app_id,to_wxid,content):rrequests.post(f{BASE}/finder/v2/api/message/postText,headersHEADERS,json{appId:app_id,toWxid:to_wxid,content:content},timeout10).json()returnr# 登录成功后执行send_text(app_id,filehelper,机器人上线,收发链路验证中)返回ret: 200同时你的微信文件传输助手收到消息——发消息链路通了。第三步配 Webhook收消息发消息是你主动调接口收消息要平台推给你。需要一个公网可访问的 HTTP 服务在控制台「访问控制」→「配置回调地址」填上你的 URL。保存时平台会先发一条验证回调地址是否可用的测试数据服务能收到才算配通。用 Flask 起一个最小接收服务fromflaskimportFlask,request appFlask(__name__)DEDUPset()# 生产环境用 Redis,这里演示app.route(/webhook,methods[POST])defwebhook():datarequest.jsonor{}msgdata.get(Data,{})# 官方指定去重键:Appid NewMsgId,同一条消息可能重复推送keyf{data.get(Appid)}:{msg.get(NewMsgId)}ifkeyinDEDUP:returnDEDUP.add(key)print(收到消息:,msg.get(Content,{}).get(string))returnif__name____main__:app.run(host0.0.0.0,port8000)回调有个硬约束3 秒内必须响应建议直接返回空字符串。业务逻辑耗时的收到消息先丢队列、立即返回worker 异步处理千万别在回调里同步干活。第四步收发闭环自动回复把第二步和第三步拼起来就是一个能自动应答的机器人。收到的消息里有几个关键字段要处理都是 WTAPI 回调文档明确写的规则:FromUserName.string以chatroom结尾 群消息真实发送者要从Content.string按:\n切割提取FromUserName.string等于顶层Wxid 自己发的消息跳过MsgType 1是文本消息。app.route(/webhook,methods[POST])defwebhook():datarequest.jsonor{}msgdata.get(Data,{})app_iddata.get(Appid)keyf{app_id}:{msg.get(NewMsgId)}ifkeyinDEDUP:returnDEDUP.add(key)ifmsg.get(MsgType)!1:# 只处理文本returnfrom_wxidmsg[FromUserName][string]iffrom_wxiddata.get(Wxid):# 跳过自己发的returncontentmsg[Content][string]iffrom_wxid.endswith(chatroom):# 群消息提取真实发送者sender,_,contentcontent.partition(:\n)if你好incontent:send_text(app_id,from_wxid,你好,机器人已收到~)return让朋友给你的微信号发一句你好秒回机器人已收到——登录、发消息、收消息、自动应答完整流程全部跑通。常见报错排查现象排查方向接口返回鉴权失败「Token回调」页核对 Token 是否最新确认环境是否需要 Bearer二维码扫了没反应看checkLogin的status;iPad 协议检查是不是在等人脸data.url)掉线后重登失败重登必须传原appId传空会生成新实例回调收不到消息先 Postman 自测服务可达再看控制台回调地址是否保存成功同一条消息回了两次去重键没用对必须Appid NewMsgId别用MsgId回调超时回调里同步干了重活改异步队列3 秒内返回下一步流程跑通后按业务往里填东西接 LLM 就是 AI 客服接标签接口就是私域分层接群接口就是群管机器人。但骨架都是这套——登录拿 appId,postText 发Webhook 收不会再变。参考资料开发文档接口路径与字段以文档实时内容为准/weiti.apifox.cn/
