💎一站式轻松地调用各大LLM模型接口,支持GPT4、智谱、星火、月之暗面及文生图 广告
为丰富小程序的服务能力,提高服务质量,微信为小程序提供客服消息能力,以便小程序用户可以方便快捷地与小程序服务提供方进行沟通。 # 功能介绍 用户可使用小程序客服消息功能,与小程序的客服人员进行沟通。 客服消息会话入口有两个: 1、小程序内:开发者在小程序内添加[客服消息按钮组件](https://developers.weixin.qq.com/miniprogram/dev/component/contact-button.html),用户可在小程序内唤起客服会话页面,给小程序发消息; 2、已使用过的小程序客服消息会聚合显示在微信会话“小程序客服消息”内,用户可以在小程序外查看历史客服消息,并给小程序客服发消息。 ![](https://res.wx.qq.com/wxdoc/dist/assets/img/x11.fa35cf19.png) 客服消息下发条件:小程序用户在小程序内唤起客服会话或用户给小程序客服发送消息,具体下发时间有效期及消息条数限制见客服消息:下发条件说明 客服消息类型:目前支持文本及图片类型消息 为尽量满足小程序开发者的需求,小程序可通过以下两种方式下发客服消息:1、调用发送客服消息接口;2、使用公众平台网页版客服工具 ### 下发条件说明 当用户和小程序客服产生特定动作的交互时(具体动作列表请见下方说明),小程序可向用户下发客服消息。 目前允许的动作列表如下,不同动作触发后,允许下发消息条数和下发时限不同。下发条数达到上限后,会返回错误码。 | 用户动作 | 允许下发条数限制 | 下发时限 | | --- | --- | --- | | 用户发送信息 | 5条 | 48小时 | 可发送客服消息条数不累加,上述用户动作会触发可下发条数及可下发时限的更新,可下发消息条数更新为当前可下发条数限制的最大值,有效下发时间限制也更新为最长有效时间。 ### 调用客服消息接口发送客服消息 当用户给小程序客服发消息,微信服务器会将消息(或事件)的数据包(JSON或者XML格式)POST到开发者填写的URL。开发者收到请求后可以调用接口进行异步回复。 **如小程序的客服消息权限集已授权给第三方平台,则所有的客服消息将推送到第三方平台的服务器,不再推送到开发者的服务器或推送到网页版客服工具** ### 填写消息推送配置 登录小程序,在“设置-开发设置-消息推送”启用消息推送功能并完成相关信息配置(包括服务器地址、Token、及加密方式等)。 ![](https://res.wx.qq.com/wxdoc/dist/assets/img/c1.83f16498.png) ![](https://res.wx.qq.com/wxdoc/dist/assets/img/b1.98ae61b7.png) 启用并设置服务器配置后,用户发送的消息以及开发者需要的事件推送,都将被微信转发至开发者URL中。 ![](https://res.wx.qq.com/wxdoc/dist/assets/img/d1.6bad2653.png) # 接口调用 [小程序客服消息API文档](https://developers.weixin.qq.com/doc/offiaccount/Message_Management/Service_Center_messages.html) ### 网页版客服工具与移动端小程序客服工具 小程序也可以直接使用[微信公众平台网页版客服工具](https://mpkf.weixin.qq.com/)或者移动端小程序客服小助手进行客服消息回复。 ![](https://img.kancloud.cn/e9/f6/e9f6174c004d22109dc97417d9e86c41_258x258.png) 客服小助手小程序码 若小程序没有启用消息推送,则用户发送的消息将会被转发至网页版和移动端小程序客服工具,客服人员可在网页版与移动端小程序客服工具中接入并回复用户。 **如小程序的客服消息权限集已授权给第三方平台,则所有的客服消息将推送到第三方平台的服务器,不再推送到开发者的服务器或推送到网页版客服工具。** **注意:“用户通过客服消息按钮进入会话”事件将不会转发至网页版客服工具。** ### 绑定客服人员 使用网页版与移动端小程序客服工具前,小程序管理员需在小程序后台完成客服人员的绑定。目前小程序支持绑定不多于100个客服人员。 ![](https://res.wx.qq.com/wxdoc/dist/assets/img/a1.be06fb5a.png) ### 客服小助手小程序使用说明 #### 登录并接入 已被绑定的小程序客服人员可微信搜索“客服小助手”或扫码登录客服小助手小程序,并选择对应的小程序帐号,登录后即可看到与小程序对话的用户,可选择接入对话。 #### 切换客服状态 点击在线状态,可以选择在线状态、离开状态: 选择在线状态后,即时退出客服小程序,仍可在“服务通知”中接收到用户咨询的消息提醒; 选择离开状态后,将无法收到客服消息与消息提醒。 ![](https://res.wx.qq.com/op_res/JBQA7UeF0TlZMmPCAMkCxn6PCEOpm247GmPoCLZbUxFfWFDT_hc3SzQjS3ie9u9k) #### 接收与发送消息 首次打开小程序后,会自动接入客服消息,后续有新的客服消息,可点击顶部接入栏进行接入; 已经接入的会话,客服人员可以在48小时内和用户进行对话,目前支持发送文本、图片类型的消息。 ![](https://res.wx.qq.com/op_res/HCQD7EvUYqZdchEKrumqbwLSYx0lAK2Ha0FEichV6vw4Ko7WlFQ_rV0rt7cRX_y8%0A) ### [ 微信公众平台网页版客服工具使用说明 #### 登录并接入 已被绑定的小程序客服人员可扫码登录[微信公众平台网页版客服工具](https://mpkf.weixin.qq.com/),并选择对应的小程序帐号,登录后即可看到与小程序对话的用户,可选择接入对话。 ![](https://res.wx.qq.com/wxdoc/dist/assets/img/i1.3af433c4.png) #### 切换客服状态 点击在线状态,可以选择在线状态、离开状态或退出登录 ![](https://res.wx.qq.com/wxdoc/dist/assets/img/f1.5463f401.png) #### 接收消息 手动接入:客服人员上线后,点击“待接入”,即可在“待接入”列表中,手动接入待回复的对话 自动接入:当待接入的对话太多时,可以在设置/接入设置中,开启自动接入 重新接入:退出登录,或对话超过半小时,需要重新接入,激活对话 ![](https://res.wx.qq.com/wxdoc/dist/assets/img/m1.8f4ff13e.png) #### 发送消息 已经接入的会话,客服人员可以在48小时内和用户进行对话,目前支持发送文本、图片类型的消息。 ![](https://res.wx.qq.com/wxdoc/dist/assets/img/h1.f7e5cdfa.png) # 使用规范 小程序客服消息使用除必须遵守《微信小程序平台运营规范》外,还不能违反以下规则,包括但不限于: 1. 不允许恶意诱导用户进行可能触发客服消息下发的操作,以达到可向用户下发客服消息目的 2. 不允许恶意骚扰,下发与用户发送的消息没有关联的、对用户造成骚扰的消息 3. 不允许恶意营销,下发内容涉嫌虚假夸大、违法类营销信息 4. 不允许使用客服消息向用户下发虚假、色情、暴力等违反国家法律规定的信息