微信小程序客服消息使用指南

功能介绍

用户可使用小程序客服消息功能，与小程序的客服人员进行沟通。

客服消息会话入口有两个：

1、小程序内：开发者在小程序内添加客服消息按钮组件https://developers.weixin.qq.com/miniprogram/dev/component/contact-button.html?t=20161221，用户可在小程序内唤起客服会话页面，给小程序发消息；

<contact-button 
  type="default-light" 
  size="20"
  session-from="weapp"
>
</contact-button>

2、已使用过的小程序客服消息会聚合显示在微信会话“小程序客服消息”内，用户可以在小程序外查看历史客服消息，并给小程序客服发消息。

客服回复：

小程序也可以直接使用微信公众平台网页版客服工具进行客服消息回复。

https://mpkf.weixin.qq.com/cgi-bin/kfindex?token=1052208922

若小程序没有启用消息推送，则用户发送的消息将会被转发至网页版客服工具，客服人员可在网页版客服工具中接入并回复用户。

注意：“用户通过客服消息按钮进入会话”事件将不会转发至网页版客服工具。

使用网页版客服工具前，小程序管理员需在小程序后台完成客服人员的绑定。目前小程序支持绑定不多于100个客服人员。

已被绑定的小程序客服人员可扫码登录微信公众平台网页版客服工具，并选择对应的小程序帐号，登录后即可看到与小程序对话的用户，可选择接入对话。

为尽量满足小程序开发者的需求，小程序可通过以下两种方式下发客服消息：1、调用发送客服消息接口；2、使用公众平台网页版客服工具

当用户和小程序客服产生特定动作的交互时（具体动作列表请见下方说明），小程序可向用户下发客服消息。

目前允许的动作列表如下，不同动作触发后，允许下发消息条数和下发时限不同。下发条数达到上限后，会返回错误码。

用户动作	允许下发条数限制	下发时限
用户通过客服消息按钮进入会话	1条	1分钟
用户发送信息	3条	48小时

可发送客服消息条数不累加，上述用户动作会触发可下发条数及可下发时限的更新，可下发消息条数更新为当前可下发条数限制的最大值，有效下发时间限制也更新为最长有效时间。

当用户在小程序内打开客服会话，或是给小程序客服发消息，微信服务器会将消息（或事件）的数据包（JSON或者XML格式）POST到开发者填写的URL。开发者收到请求后可以调用接口进行异步回复。

登录小程序，在“设置-开发设置-消息推送”启用消息推送功能并完成相关信息配置（包括服务器地址、Token、及加密方式等）。