企微自动化：如何通过 API 实现企业微信外部联系人深度集成

打通企业 CRM 与腾讯私域生态，实现客户资产的数字化沉淀

能力介绍

外部联系人接口是企业微信私域运营的核心底层能力。它允许企业系统通过 external_userid 获取客户的详尽画像，包括基础资料（昵称、头像、性别）、业务属性（来源渠道、添加时间、备注名）以及高价值的客户标签（Tags） 。其核心价值在于将散落在员工个人手机端的客户数据，转化为企业可查询、可分析、可沉淀的数字化资产。

10 分钟接入 Demo

1. 权限配置：在企业微信管理后台确认应用已开启“客户联系”权限，并配置可信 IP。
2. 获取 AccessToken：使用 corpid 和专用 secret 调用 token 接口，这是后续调用的通行证。
3. 提取客户标识：通过“获取客户列表”接口或成员添加好友的回调事件，获取目标客户的 external_userid。
4. 调用详情接口：发起 GET 请求至详情端点，获取 JSON 格式的完整客户档案。
5. 业务系统同步：将解析出的标签、备注及自定义字段（如行业、等级）同步至内部 CRM。

API 示例代码

以下为获取外部联系人详细信息的 Python 实现参考：

import requests

def get_external_contact_info(access_token, external_userid):
    # 外部联系人详情接口地址
    url = f"https://qyapi.weixin.qq.com/cgi-bin/externalcontact/get"
    params = {
        "access_token": access_token,
        "external_userid": external_userid
    }
    
    response = requests.get(url, params=params)
    data = response.json()
    
    if data.get("errcode") == 0:
        # 返回客户基础信息与所属企业成员添加的信息
        return data.get("external_contact"), data.get("follow_user")
    return None, None

使用场景说明

• 全量客户对账：定期通过 API 拉取企业所有外部联系人，防止因员工离职或误删导致的客户资源流失。
• 智能侧边栏开发：在聊天侧边栏实时调用接口，为员工展示客户的购买历史、会员等级及画像标签。
• 营销效果分析：通过接口获取客户的 source（来源渠道），精准计算不同广告投放或线下活动的转化率。
• 自动化标签同步：当客户在小程序完成购买后，通过接口自动为其打上“已消费”标签，实现精准分层。

FAQ

• Q：为什么不同员工添加同一个客户，获取的 external_userid 不一样？

  • A：对于同一个企业，同一个客户的 external_userid 是唯一的、固定不变的，不会随添加成员的改变而改变。

• Q：可以获取到客户的微信手机号吗？

  • A：出于隐私保护，该接口默认不返回手机号。仅在客户通过特定渠道（如获客助手）进入或主动授权后，方可按规则获取。

• Q：接口调用次数有限制吗？

  • A：有。企业微信 API 设有分钟级及日级调用配额。建议在数据全量同步时，采用异步并发控制或分布式调用策略。

引导入口

查看 API 文档

访问企微官网