小程序客服消息使用指南

# 小程序客服消息是微信官方的客服工具，所有的功能均是微信开发的

## 为丰富小程序的服务能力，提高服务质量，微信为小程序提供客服消息能力，以便小程序用户可以方便快捷地与小程序服务提供方进行沟通。

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

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

#### 1、小程序内：开发者在小程序内添加客服消息按钮组件，用户可在小程序内唤起客服会话页面，给小程序发消息；

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

![](https://docs.qiniucs.kingcms.com.cn/media/202108/2021-08-28_093149.png)

#### 客服消息下发条件：小程序用户在小程序内唤起客服会话或用户给小程序客服发送消息，具体下发时间有效期及消息条数限制见客服消息下发条件说明

### 客服消息类型：目前支持文本及图片类型消息

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

### 下发条件说明

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

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

![](https://docs.qiniucs.kingcms.com.cn/media/202108/2021-08-28_093230.png)

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

### 调用客服消息接口发送客服消息

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

#### 如小程序的客服消息权限集已授权给第三方平台，则所有的客服消息将推送到第三方平台的服务器，不再推送到开发者的服务器或推送到网页版客服工具

### 填写消息推送配置

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

![](https://docs.qiniucs.kingcms.com.cn/media/202108/2021-08-28_093302.png)

![](https://docs.qiniucs.kingcms.com.cn/media/202108/2021-08-28_093308.png)

![](https://docs.qiniucs.kingcms.com.cn/media/202108/2021-08-28_093324.png)