这里说的「机器人」通常不是微信里那个官方群机器人插件而是用 API 驱动已登录的个人微信节点让业务系统能发、能收、能管好友和群。个人微信没有企业级官方会话开放接口可填个人微信API二次开发文档里能力是分模块的可以按落地频率记一张清单。很多人把「机器人」理解成一个 method。实际是登录保活一条线消息收发一条线联系人与群一条线朋友圈等能力按需再叠。通道不稳上面叠什么都会像玄学。消息最先打通发文本postText群 配atscontent里还要有昵称。图片、文件、链接、视频有各自接口别往文本里硬塞。收消息走 Webhook大约 3 秒内返回超时可能丢。接口发出去的内容一般不回调手机端发出的会。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: 目标会话, content: 机器人能力连通测试 }主动推业务事件驱动和自动回回调驱动可以共用发送接口幂等键建议拆开。联系人通讯录fetchContactsList好友、已存通讯录的群、公众号等搜索 addContacts加好友或同意申请备注、标签。标签更新是全量覆盖只传新标签会删旧的合并后再提交。列表没有的群未存通讯录的常常要靠群消息回调再补入库。加好友链路是搜索拿v3/v4再添加option区分添加、同意、拒绝。群createChatroom至少两个好友 wxid、inviteMember、removeMember、改群名/群备注备注往往仅自己可见。群会话 ID 形态是xxxchatroom和私聊 wxid 不是一类。朋友圈与登录文字发圈等朋友圈接口新设备常见有一段时间限制以文档为准。登录取码、检查状态appId成功后固定掉线优先恢复别动不动新建把业务映射作废。二维码大约 150 秒过期重取。建议落地顺序登录固定 appId → 发一条文本 → 回调能入队 → 关键词自动回 → 再加好友 / 群管理 / AI实名、控频、业务驱动接口能做不代表适合做骚扰式营销。多号时 Token 下挂多个appId回调和发送都要路由对。机器人能力拼的是映射和纪律不是把文档模块全调一遍。API 文档GeWe API - GeWe API微信 API 开发文档
