要把好友进 CRM、把顾问名下资产对齐手工导出通讯录既慢又脏。个人微信API二次开发用通讯录接口拉数据先记住一句话这份列表和「聊天列表里出现过的所有群」不是同一份东西。很多人以为拉一次通讯录就等于全量会话资产后面同步永远对不齐。拉通讯录登录好节点、固定appId之后curl -X POST http://api.geweapi.com/gewe/v2/api/contacts/fetchContactsList \ -H X-GEWE-TOKEN: YOUR_TOKEN \ -H Content-Type: application/json \ -d { appId: 你的设备ID }ret 200时常见会有friends好友 wxidchatrooms已保存到通讯录的群ghs关注的公众号好友多时接口偏慢超时按文档改走缓存结果别死等一次全量把调用链打穿。系统号、文件传输助手之类不要当客户写入业务库。需要备注、详情时再调详情/搜索类接口字段以文档为准不要猜结构。多顾问多号时每个appId各自一份通讯录。业务库至少要有客户/群 → toWxid → appId的映射禁止全局写死「默认设备的通讯录就是全公司」。列表没有的群怎么办未存通讯录的群这份接口可能给不了。文档侧常见补法是群里一旦有新消息走回调你再拉群详情入库或者运营侧要求顾问把常用群存进通讯录再定时同步。加好友则是另一条链搜索拿v3/v4再addContacts和「拉列表」不要当成同一次任务。拉到好友之后备注、标签可以继续维护——标签更新是全量覆盖只传新标签会把旧的清掉合并后再提交。同步时最容易翻的车每分钟全量打满。定时增量即可把号打热了后面发消息、加好友一起遭殃。把公众号、系统号当客户。入库前过滤否则 SCRM 脏数据会污染触达名单。登录掉线还在同步。先恢复原appId再重跑换新设备 ID 等于换节点旧映射全废。脱敏与留存。联系人数据落地注意权限和留存周期别把全量 wxid 明文甩进日志。数据同步解决的是「资产看得见」真正触达还要靠发送接口和回调。先把列表拉通、过滤干净、映射写稳再接到推送和自动回。API 文档GeWe API - GeWe API微信 API 开发文档