企业微信客户服务插件

为了方便客户直接联系企业成员进行沟通，企业可以将一个或多个成员配置到「联系我」二维码或者「联系我」按钮，并将二维码直接展示给客户或将按钮配置到小程序中。客户扫描二维码或在小程序中点击按钮后即可获得成员的企业微信联系方式，客户添加后即可直接加成员为好友并发起沟通。

企业管理员可在“企业微信管理后台->客户联系->加客户->联系我”中完成「联系我」二维码和「联系我」按钮两种联系方式的创建和配置，从而建立企业成员与客户的连接。其中「联系我」按钮需要开发者做简单的开发配置，开发者可按以下文档说明完成配置「联系我」按钮到小程序的接入工作。

微信iOS系统V8.0.6和安卓系统V8.0.3及以上版本的用户可直接在小程序内长按识别「联系我」二维码了，之前版本的用户仍需通过接收服务通知获取联系方式。

一、小程序插件接入步骤

1. 开发者在小程序管理后台申请使用插件，添加路径：设置 ->第三方服务 -> 插件管理 -> 添加插件，搜索并添加插件ID： wx104a1a20c3f81ec2，无需审核确认。
2. 开发者在小程序app.json 文件中添加对插件的引用
   

   "plugins": {
   	"contactPlugin": {
   		"version": "1.4.3",
   		"provider": "wx104a1a20c3f81ec2"
   	}
   }  

   
   
3. 开发者在具体引用插件的页面文件json文件中，添加对组件的引用，例如：
   

   "usingComponents": {
   	"cell": "plugin://contactPlugin/cell"
   }

   
   
4. 开发者在引用插件的wxml文件中添加组件的具体代码，其中plugid为在企业微信管理后台配置的客服ID，将该ID作为参数传入组件，例如：
   

   <cell bind:startmessage='startmessage' bind:completemessage="completemessage" plugid='plugid'  />

参数说明：

其中 completemessage 回调接收的参数格式如下：

{
    errcode: 0,  // 消息发送状态
    name: '',  // 推送的客服人员姓名
    headurl: ''  // 推送的客服人员头像
	notifytype: 0,  // 0: 表示消息通知的方式  1：表示二维码的方式
}

请开发者注意，name和headurl参数在 errcode 为0和-3006 时才会返回，errcode 的异常错误码说明如下：
-3002：获取插件配置信息失败
-3004：用户信息授权失败
-3005：客服消息发送失败
-3006：发送的客服人员已经和当前用户是好友关系，如果 notifytype = 1，则为二维码展示方式，此时仍会展示二维码
-3008：当前配置没有客服人员

二、插件扩展参数说明

为了对插件的UI表现进行定制，插件提供了以下参数对插件的UI进行进一步的扩展配置，可配置的公用属性如下：

三、插件运行环境说明

小程序版本的插件目前仅支持运行在微信的小程序环境中，企业微信环境暂不支持。