私域后台里客户、跟进、活动都有了，卡在微信侧：人在会话里，系统却摸不到。个人微信没有官方运营机器人；个人微信API二次开发是把执行节点接到 SCRM——触达、互动、好友和群，都变成可调度的 HTTP。

很多人一上来就要「全自动私域」。更稳的是先打通映射和一条触达链路，再扩互动和关系动作。映射不稳，自动化只会稳定地发错人。

可以按四块搭

资产。 fetchContactsList 同步好友与已存通讯录的群；未存群靠消息回调补。库表至少有 客户 → toWxid → appId。系统号、公众号过滤掉，别当客户触达。

触达。 跟进、活动用 postText；资料用 postFile / postLink。触发来自业务单据，不是每天扫一遍好友列表群发。短时间状态连跳，合并成一条再推。

互动。 Webhook 收消息，关键词或 AI 再回。回调快回（大约 3 秒），业务进队。群默认触发词再回，全量接管容易刷屏。人工手机接手后停自动路径。

关系。 搜索 + addContacts；建群/拉人；备注和标签方便顾问检索（打标签注意全量覆盖，合并后再提交）。

curl -X POST http://api.geweapi.com/gewe/v2/api/message/postText \
  -H "X-GEWE-TOKEN: YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "appId": "顾问设备ID",
    "toWxid": "客户wxid或群ID",
    "content": "本周跟进已更新，有问题直接回我。"
  }'

多顾问怎么路由

多顾问就多 appId，回调和发送都要路由对。同一客户只能有一个主责号，否则两路回调会双回。号掉线先恢复原设备，别随便新建把映射作废。

业务后台只调 API，不要对多号再跑互相冲突的桌面脚本。主动推和自动回拆幂等键、拆监控，账才对得清。

落地时最容易翻的车

当群发器。 私域自动化拼的是单号驱动和可审计，不是接口清单有多长。

回调里同步调模型和一堆下游。 超时丢互动，后面触达再漂亮也没有触发源。

通讯录当全量会话。 未存群拉不下来，要靠回调补；资产表和聊天列表不是一份东西。

标签只传新 ID。 全量覆盖会清掉旧标签，顾问检索直接乱。

掉线还在狂推。 熔断推送队列，恢复后再放行。

建议顺序：登录 → 同步一份干净资产 → 指定客户推一条 → 回调入队做关键词 → 再加好友/建群/AI。私域自动化先稳通道和映射，再谈「全自动」。

API 文档：GeWe API - GeWe API｜微信 API 开发文档