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

了解「微信客服组件」

申请接入微信客服组件后,企业可授权在你的场景中接入微信客服。授权后,该场景的用户可通过微信客服咨询企业,你可管理对应的客服咨询。

为什么要支持企业在你提供的场景中接入微信客服?

enter image description here

适用对象

适合可为企业提供微信客服接入场景的服务商。典型如下:

enter image description here

接入流程

enter image description here

授权流程

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

  • 回调临时授权码的公共信息字段详细说明见授权成功通知。除了公共的字段信息外,微信客服组件的授权成功通知会额外携带ExtraInfo.AuthOpenKfIdList参数,用于告知服务商用户当前授权是选择了哪些客服账号,详情见组件授权通知事件
  • 利用临时授权码获取永久授权码见获取永久授权码
  • 临时授权码10分钟后会失效,第三方服务商需尽快使用临时授权码换取永久授权码及授权信息。
    每个企业授权的每个应用的永久授权码、授权信息都是唯一的,第三方服务商需妥善保管。后续可以通过永久授权码获取企业access_token,进而调用企业微信相关API为授权企业提供服务。
  • 企业授权成功以后,若再次通过授权链接或二维码进行客服账号授权,会回调变更授权通知。同样,会额外携带ExtraInfo.AuthOpenKfIdList参数,用于告知服务商用户此次授权是选择了哪些客服账号。
  • 企业取消接入客服组件时,会回调取消授权通知事件。注意,服务商收到取消授权事件后,应当确保删除该企业所有相关的数据。

更多说明

1、关于微信客服组件授权链接/二维码

开发者可以在上文授权流程中所述的授权链接拼上指定参数,实现对应功能。
a)拼接参数state,当企业授权接入客服组件时,授权成功通知或变更授权通知将回调该参数给开发者,开发者可依据该参数,明确知道企业是要在哪里接入客服。
例: https://open.work.weixin.qq.com/compApp/wwxxxxxxxx?state=xxxxxx
b)拼接上参数mode=1,当企业授权接入客服组件时,每次仅可选择一个客服账号进行授权
例: https://open.work.weixin.qq.com/compApp/wwxxxxxxxx?mode=1

2、关于客服账号链接

a)每个客服账号对应一个客服链接。用户在微信内外各个场景,点击客服账号链接,即在微信可向该企业的客服发起咨询。
b)企业授权接入后,服务商可通过API或在服务商助手的「工具-通用配置-组件数据」处查看企业接入的客服账号和对应的客服账号链接,并请及时将获取到的客服账号链接配置到自己的场景中。
c)客服账号链接带有服务商的场景参数,配置时须保留该参数。通过该客服链接发起的咨询,你才可进行管理。
d)服务商也可以通过API,获取携带更多个性化参数的客服链接
e)如果在小程序接入不同企业的客服,需调用在小程序打开微信客服 接口;小程序默认只能打开同主体的客服账号,申请微信组件登记的小程序AppID,将可接入不同企业的客服。接入时,依旧需要在小程序管理后台先绑定同主体的企业ID,调用接口时,填入同主体的企业ID,和实际所需跳转的客服链接。

更多介绍可查看文档:微信客服组件介绍

上一篇
回调通知
下一篇
获取客服账号列表