需通过企业微信开放平台api实现crm集成：一、创建自建应用并获取agentid与secret；二、用corpid和secret获取access_token并缓存；三、配置可信域名与事件回调url，启用客户联系功能；四、通过external_userid拉取客户信息同步至crm；五、crm状态变更时调用消息接口向企微会话推送提醒。

如果您希望将企业微信与企业自有的CRM系统进行数据互通，实现客户信息同步、会话存档、事件回调等功能，则需要通过企业微信开放平台提供的API接口完成系统级集成。以下是具体实施步骤：

一、配置企业微信应用并获取凭证

在企业微信管理后台创建一个“CRM集成”类型的应用，用于接收和发送CRM相关数据。该应用将提供调用API所需的密钥与身份标识。

1、登录企业微信管理后台，进入【应用管理】→【自建应用】→【创建应用】。

2、填写应用名称为“CRM对接服务”，设置可见范围为企业全部成员。

3、创建完成后，在应用详情页记录AgentId（整数ID）与Secret（应用密钥）。

4、在【权限管理】中为该应用分配【客户联系】、【客户群管理】、【消息推送】等必要权限，并完成管理员授权。

二、获取企业微信access_token

access_token是调用所有企业微信API的全局凭据，有效期为2小时，需缓存并在过期前刷新。每次API请求必须携带此token。

1、使用已获取的CorpID与应用Secret，向接口https://qyapi.weixin.qq.com/cgi-bin/gettoken发起GET请求。

2、请求参数为：corpid=YOUR_CORPID&corpsecret=YOUR_SECRET。

3、解析返回的JSON响应，提取字段access_token与expires_in（单位：秒）。

4、将access_token存储于CRM系统的安全缓存中，并设置自动刷新逻辑（例如在到期前5分钟触发刷新）。

三、启用客户联系功能并获取外部联系人事件回调

通过配置可信域名与事件接收URL，使CRM系统能实时接收到客户添加、聊天、标签变更等行为通知，从而触发内部业务流程。

1、在企业微信后台【客户联系】→【客户联系API】中开启“开启客户联系功能”开关。

2、在【接收消息】→【配置接收消息】中填写CRM系统对外暴露的HTTPS回调地址，如https://crm.example.com/wecom/callback。

3、上传并验证Token、EncodingAESKey及企业微信企业ID，确保加解密与签名验证通过。

4、勾选需接收的事件类型，包括add_external_contact（添加客户）、change_external_contact（客户信息变更）、msg_audit（会话内容存档）等。

四、同步客户基础信息至CRM数据库

当企业微信用户添加客户后，系统通过回调事件中的external_userid字段，调用客户详情接口拉取完整客户资料，写入CRM客户主数据表。

1、接收回调事件，提取external_userid与state（自定义透传参数，可用于关联线索来源）。

2、调用接口https://qyapi.weixin.qq.com/cgi-bin/externalcontact/get，传入access_token与external_userid。

3、解析返回的客户姓名、手机号（需授权）、头像URL、所属企业等字段，映射至CRM客户实体对应字段。

4、若手机号为空，检查是否已申请并开通客户手机号获取权限（需客户授权且满足实名认证条件）。

五、从CRM主动推送客户动态至企业微信会话

CRM系统可在客户状态变更（如成交、售后中、流失）时，通过企业微信「发送应用消息」接口，向对应员工的企业微信会话推送结构化提醒。

1、在CRM中确定目标接收人，获取其userid（员工账号）或external_userid（客户ID）。

2、构造消息体，选择消息类型为textcard或template_card，包含客户名称、最新状态、操作链接等。

3、调用接口https://qyapi.weixin.qq.com/cgi-bin/message/send，指定touser、msgtype、agentid与access_token。

4、确保消息中跳转链接指向CRM内对应客户详情页，且该页面已配置企业微信JS-SDK鉴权支持。