获客助手对接场景

一、业务场景

在当前的数字化营销环境中，一部分用户已经开始利用企业微信获客助手工具，投放在线上渠道进行获客。这些工具不仅提升了客户获取的效率，同时也积累了大量的潜在客户数据，目前在使用过程中遇到的痛点是无法将通过获客助手工具获得的客户数据与现有的数据管理系统（包括内部和第三方平台）实现数据互通，这种互通能力对于提升数据的可用性、增强客户洞察力以及优化营销策略至关重要，本文为多渠道投放获客助手链接提供通用获客助手与三方平台系统打通方案。

二、解决方案

目前企微支持在已生成的获客助手链接后拼接自定义参数，如用户访问该获客助手链接加微，则系统会自动回传该自定义参数，便于开发者进行跨平台用户身份识别。
完整获客助手链接示例如下，其中customer_channel字段为自定义标识，「cal_230369685906067456」值示例内容为尘锋生成&使用，请勿清除或修改，否则会影响数据统计功能，可以在其后继续拼接最长32个字节的标识内容：

为了确保能识别用户唯一标识，在定向投放链接之前，例如根据用户的手机号码做固定长度的二次加密(仅为建议，具体请自行设计)，如用户手机号为:13000010002，加密后为3066ceb2c664b，则生成的获客助手链接为：

如果在拼接了用户唯一标识的基础上还需要额外标记来源，如抖音，则生成的获客助手链接为：

通过以上方式投放的链接加微之后，系统会通过「添加好友事件」-「qwExternalUserState」字段进行回传，便于开发者识别。
自定义拼接参数格式说明，请勿删除尘锋保留参数「cal」和参数值部分，在其后按要求拼接，并且参数名称和参数值内容里不能包含"+"、"_"等保留字符信息：
获客助手链接?customer_channel=cal_尘锋保留参数值+参数名称1_参数值1+参数名称2_参数值2+参数名称3_参数值3+....

三、对接流程

四、相关接口

接口名称	备注
查询联系人	获取尘锋系统的线索数据
添加好友事件	当员工主动/被动添加微信好友之后会推送该事件，关注qwExternalUserState字段

五、核心字段

字段名	备注
qwExternalUserState	好友加微渠道标识，在本文档的场景中相当于customer_channel值，该字段用于跨平台身份识别。
customer_channel	获客助手链接自定义唯一标识，用户访问链接后会原样回传，最大长度为32字节。
external_userid	企微外部联系人id，如有多位员工添加同1好友，那么好友该值都是一样的。
uid	尘锋员工id，添加好友的员工id
customerId	尘锋联系人id，线索客户数据id

一、业务场景#

二、解决方案#

三、对接流程#

四、相关接口#

五、核心字段#

一、业务场景

二、解决方案

三、对接流程

四、相关接口

五、核心字段