CRM同步企微联系人避坑指南

销售在 CRM 把线索改成「已签约」。第二天企微里搜索仍是「张总」，拉群时对不上人。问题不在 CRM 保存失败，是改名没有写进企业微信联系人。

备注接口认 userId。用昵称「张总」当主键，重名时会改错人。

Token、设备登录和联系人字段，文档里可以对照着看：快速查看 API 文档

CRM 保存成功后立刻写企微

QiWe API 联系人模块提供设置备注。CRM 的 customer_id 必须已经绑定 userId。

import requests

API = "http://manager.qiweapi.com/qiwe/api/qw/doApi"
HEADERS = {
    "X-QIWEI-TOKEN": "YOUR_API_KEY",
    "Content-Type": "application/json",
}


def do_api(method, params):
    body = requests.post(
        API, headers=HEADERS,
        json={"method": method, "params": params}, timeout=30,
    ).json()
    if body.get("code") != 0:
        raise RuntimeError(body)
    return body


def sync_remark(guid, user_id, remark):
    do_api("/contact/setRemark", {
        "guid": guid, "userId": user_id, "remark": remark,
    })
    detail = do_api("/contact/get", {
        "guid": guid, "userId": user_id,
    })
    got = (detail.get("data") or {}).get("remark")
    if got != remark:
        raise RuntimeError({"expected": remark, "got": got, "detail": detail})
    return detail

字段名以联系人模块为准。执行账号必须已是好友。备注过长或含特殊符号可能被截断，先测中文短句。改备注不会通知对方，不要当成「已发签约祝贺」。

入口在 QiWe API 官网。

收口

CRM 改名以企微联系人详情回读为准。测试号改成带日期的备注，手机通讯录能搜到新字，再批量同步。