客户信息打通

自有CRM系统和尘锋SCRM的客户信息对接方案

尘锋业务架构图

专业名称解释：

名次解释	描述
unionId	微信用户的统一标识。，针对一个微信开放平台帐号下的应用，同一用户的unionid是唯一的。
external_userid	企业微信用于表示企业的外部联系人而设立的id
联系人	员工维护的个人客户档案，可以与添加的企微好友关联
联系人公海	公共联系人线索池
联系人自定义字段	在系统内自定义的档案字段

适用于将尘锋系统的所有联系人信息统一同步至三方系统。以及将尘锋系统后续新增的联系人信息同步至三方系统。

第一步：获取联系人信息存量数据获取：可调用“查询联系人列表接口”来获取联系人的信息增量数据获取：可订阅联系人变更推送事件并判断 data.body.type=“add(新增联系人)”时，接收新增的联系人数据信息

第二步：联系人关联映射将尘锋的联系人和三方系统的联系人建立映射关系。目前提供的关联方式有两种：

unionId关联：如三方系统的联系人也有微信用户的unionId信息，可通过uniondId实现和好友及联系人的打通（微信unionid互通场景）

手机号关联：如三方系统只有联系人的手机号信息，可通过通过尘锋的“查询联系人”接口的返回参数（data.mobiles）进行联系人关联

第三步：联系人跟进员工获取通过“查询联系人”接口的返回参数data.owner的数据，来调用 “查询员工信息”接口获取联系人的主跟进员工信息员工关联：可通过查询员工信息返回的手机号信息进行员工信息的关联。（也可选择员工名称进行关联，但是需确保名称唯一）

第四步:联系人跟进员工关联：可根据获取的员工信息，将联系人绑定到指定员工

第五步:联系人标签获取：通过“查询联系人”接口的返回参数data.tags的数据，来调用 “查询标签列表和明细”接口获取联系人标签的详细信息。

第六步**:联系人标签关联**：可将获取的联系人标签信息存储下来

第七步**:联系人自定义字段获取**：通过“查询联系人”接口的返回参数data.custom_fields.id的数据，来调用 “查询字段模版”接口获取联系人标签的详细信息。

第八步： 联系人自定义字段关联:可将获取的联系人标签信息存储下来

涉及接口清单：

适用于在对接初始化时将三方系统的所有联系人资料统一同步至尘锋。以及将三方系统后续新增的联系人资料同步至尘锋。在联系人导入中，有两种场景：

场景A：将三方系统的客户信息指定到某个销售

场景B：将三方系统的客户信息指定到公海中

场景A举例：XX电商以前有自己的客户管理系统，想要把自己系统中的客户同步到尘锋，同时指定销售人员去跟进这些客户信息

当企业需要将客户导入尘锋系统且指定对应的员工去跟进时，可先调用“查询员工信息”接口获取员工信息，然后调用“批量新增联系人”接口将三方系统的客户资料导入至尘锋系统。此外后续三方系统如果有新增客户资料，也可通过该接口将客户资料导入至尘锋！

注意：在批量新增联系人接口中，需把员工ID 放在customer_list.owner字段中

接口名称	接口备注
查询员工信息	使用接口鉴权说明调用授权。
新增联系人	使用接口鉴权说明调用授权。用于第三方系统的客户信息导入至尘锋（批量导入和单个导入）

场景B举例：XX电商以前有自己的客户管理系统，想要把自己系统中的客户同步到尘锋，同时指定进公海中。

当企业需要将客户导入尘锋系统且指定公海时，可先调用“获取公海”接口来获取公海信息，然后调用“批量新增联系人”接口将三方系统的客户资料导入至尘锋系统。此外后续三方系统如果有新增客户资料，也可通过该接口将客户资料导入至尘锋！

注意：在批量新增联系人接口中，需把公海ID 放在customer_list.pool字段中

涉及接口清单：

接口名称	接口备注
查询联系人公海列表	使用接口鉴权说明调用授权。
新增联系人	使用接口鉴权说明调用授权。用于第三方系统的客户信息导入至尘锋（批量导入和单个导入）

场景举例：客户之前有使用企微，但是用了别的服务商产生了一些客户资料，现在改用尘锋，想将之前的联系人的跟进记录信息、好友标签信息、跟进员工信息同步至尘锋系统。

当客户需要将尘锋系统的扩展信息（跟进记录、好友标签、跟进员工）数据导入至三方系统时，需进行以下操作：

第一步:**跟进模版获取：**调用“查询跟进类型”接口，来获取跟进类型的信息

跟进类型应用场景：举例：比如XX整形医院想针对联系人的跟进类型进行不同分类，以便销售后续进行跟进。

第二步:联系人跟进记录创建 ：调用“批量创建联系人跟进记录”接口创建联系人的跟进记录信息，如后台开启跟进类型开关，则该字段必传。

第三步:**联系人标签创建：**可调用“编辑联系人标签”接口维护联系人标签库。

**联系人标签编辑:**可调用“编辑联系人的标签信息”接口给联系人打上“联系人标签”。

第四步:**指定员工跟进：**可调用“批量编辑联系人”接口编辑联系人的主跟进人ID信息

涉及接口清单：