第三方应用开发 服务端API 客户联系 获客助手组件 概述
概述
最后更新:2023/11/20
可联系渠道经理采购或代理智慧硬件接口已支持设备 联系渠道经理
概述
最后更新:2023/11/20

了解「获客助手组件」

申请接入获客助手组件后,企业可授权在你的场景中接入获客助手。授权后,该场景的用户可通过获客链接添加企业成员,你可自动获得数据回传。

为什么要支持企业在你提供的场景中接入获客助手组件?

企业微信截图_e1747219-76f7-45e4-9f03-ed6ba3c2498f.png

适用对象

典型如下:
企业微信截图_caae9c52-5c5a-49ff-97a2-71c1d00cad7f.png

接入流程

1、 提交申请

注册成为企业微信服务商,在「服务商助手-工具-通用配置-获客助手组件」处提交申请。

2、 引导企业授权接入

申请通过并发布组件后,你可获得专属的组件授权链接/二维码。可在你的业务页面配置该链接,企业点击后将自动打开企业微信,授权在你的场景中接入获客助手,你可获得改场景中的获客转化数据。

3、 配置获客链接

企业授权给你的链接会自动带有你的场景参数,配置时请保留该参数。你可接受在你的场景中的获客转化数据。

4、 接收数据回传

可在获客链接的comp_scene=xxx后再次拼参,企业微信将以此参数进行获客转化数据回调,用于跨平台用户身份识别。如:
说明
https://work.weixin.qq.com/ca/caxxxxxxxxxxxx?comp_scene=xxx&customer_channel=1

字符串不超过64字节,超过会被截断,如第三方平台用户ID超过64字节,建议做内部映射。

 

授权流程

开发者可以在服务商助手的「工具-通用配置-获客助手组件」获取授权链接或二维码,之后企业可使用该授权链接或二维码接入获客助手组件,具体流程如下图所示:
获客助手链接授权.png注:

  • 回调临时授权码的公共信息字段详细说明见授权成功通知
  • 利用临时授权码获取永久授权码见获取永久授权码
  • 临时授权码10分钟后会失效,第三方服务商需尽快使用临时授权码换取永久授权码及授权信息。
    每个企业授权的每个应用的永久授权码、授权信息都是唯一的,第三方服务商需妥善保管。后续可以通过永久授权码获取企业access_token,进而调用企业微信相关API为授权企业提供服务。
  • 企业授权成功以后,若再次通过授权链接或二维码可进入获客助手授权链接管理界面,变更授权的获客链接时会回调变更授权通知
  • 企业取消接入获客助手组件时,会回调取消授权通知事件。注意,服务商收到取消授权事件后,应当确保删除该企业所有相关的数据。

更多说明

1、关于获客助手组件授权链接/二维码

开发者可以在上文授权流程中所述的授权链接拼上指定参数,实现对应功能。

  • 拼接参数state,当企业授权接入获客助手组件时,授权成功通知或变更授权通知将回调该参数给开发者,开发者可依据该参数,明确知道企业是要在哪里接入获客链接。
    例: https://open.work.weixin.qq.com/compApp/wwxxxxxxxx?state=xxxxxx

2、关于获客链接

a)可将获客链接配置在微信内/外的获客场景,客户点击即可打开成员的profile。
b)企业授权接入后,服务商可通过API或在服务商助手的「工具-通用配置-组件数据」处查看企业接入的获客链接,并请及时将获取到的获客链接配置到自己的场景中。
c)获客链接带有服务商的场景参数,配置时须保留该参数。通过该获客链接发起的操作,你才可进行管理。
d)若要接收获客转化回调,则必须在链接后添加customer_channel=自定义字符串。企业微信将以此参数进行获客转化数据回调,用于跨平台用户身份识别。

上一篇
上传附件资源
下一篇
获取组件授权信息