# 微信小店客服API开放模式说明
# 一、微信小店客服API模式说明
微信小店客服，可分为以下两种模式：
- 使用平台提供的客服工具
【腾讯文档】微信小店客服——使用操作指引
- 接入自研客服工具
小店客服API接口文档
其中：有以下几个要点要关注：
同一个店铺，同一时间，只能在这两种模式中选择一种，来接待用户咨询；
请务必先用一个备用或测试用店铺，先完成客服API的对接，以及自研客工具的开发，再对正式店铺进行模式切换！！！
请务必先用一个备用或测试用店铺，先完成客服API的对接，以及自研客工具的开发，再对正式店铺进行模式切换！！！
请务必先用一个备用或测试用店铺，先完成客服API的对接，以及自研客工具的开发，再对正式店铺进行模式切换！！！
切忌直接在没完成系统对接和开发、验证之前，直接对正式店铺进行操作！！！会直接影响线上业务！！
否则，一但完成切换，店铺的新增用户咨询均将走API路径传递，而自研系统若未完成开发，相关用户咨询可能会丢失且不可恢复；
- 两种模式的聊天记录不互通，微信小店客服工具的聊天记录，可以在客服工作台查询；切换到API模式后的聊天记录，需要在商家自研的客服工具进行管理。
# 二、客服API模式开启流程
# 1.设置入口
在店铺管理后台-【店铺管理】-【客服管理】菜单下，有【接入自研客服】的入口。
# 2.切换流程
切换流程大致如下图，需要重点注意的事项如下：
要开启自研客服模式，需要先完成系统消息推送的配置
要开启自研客服模式，需要店铺超级管理员授权
# 3.消息推送地址
微信小店客服API的消息推送地址，是共用微信小店原本的消息推送地址；
一个微信小店，只可配置一个消息推送地址；
若消息推送地址原来已有其他业务在使用，请务必关注是否会引起业务间的冲突。
配置路径为：店铺管理后台-【服务市场】-【经营工具】-【自研】-【消息推送设置】 消息推送相关指引文档如下：
https://developers.weixin.qq.com/doc/store/shop/API/basics/getaccesstoken.html
https://developers.weixin.qq.com/doc/store/shop/API/basics/message_push.html
# 三、客服API模式当前功能特性说明
# 1、消息收发机制说明
# 消息接收
当有C端用户发起客服咨询，系统将把相关消息，转发到开启客服API时设置的消息推送地址。
消息接收及各种消息体的结构说明文档如下：
# 消息发送
商家可使用自研的客服系统，通过消息发送API，向已经在沟通中的C端用户发送消息，回复用户咨询。
消息发送及各种消息体的结构说明文档如下：
https://developers.weixin.qq.com/doc/store/shop/API/kf/send_msg/send_msg_api.html
# 图片、视频、文件等素材的上传
若需要给用户发送图片、视频、文件等多媒体素材，需要先通过素材上传接口，上传相关文件，获得素材URL，再通过消息发送接口发送。
素材上传接口及各种类型文件的上传指引如下： https://developers.weixin.qq.com/doc/store/shop/API/kf/upload_cos/upload_cos_api.html
# 2、支持接收和发送的消息体
本次支持以下消息体的接收和发送：
文本
图片
文件
商品卡片
订单卡片
本次暂未支持的消息体：
语音
视频
聊天记录
代发起售后等结构化消息卡片
视频号动态
视频号直播
视频号名片等
更多消息体的接收和发送将在后续尽快支持。
# 四、对原微信小店客服工具功能的影响
# 1、对消息收发的影响
切换到API模式后，用户的新增咨询将通过API通道接收和发送，不再通过微信小店客服工作台接收和发送；
切换过程中，正在沟通中的用户咨询会话，可以在微信小店客服工作台继续完成；
若当轮会话结束后，用户再次咨询，就需要通过API通道接收和发送；
- 原本在微信小店客服工作台的历史聊天记录，仍可查询、查阅。
# 2、对客服数据面板功能的影响
切换到API模式后，微信小店客服工作台的数据面板将不会统计API通道上的客服咨询数据；
原本在微信小店客服工作台的历史数据，仍可查询、查阅；
# 3、对自动回复等功能的影响
- 切换到API模式后，微信小店客服工作台的欢迎语、离线语、自动回复等功能均不会再生效；
# 4、对人员管理等功能的影响
切换到API模式后，微信小店客服工作台的人员管理、会话查询等功能将对API模式里的会话无效；
API模式亦不会使用小店客服人员的权限管理机制，需在自研客服系统自行管理；
原本在微信小店客服工作台的历史人员数据、会话记录，仍可查询、查阅。