cn.binarywang.wx.miniapp.api

接口 WxMaKefuService

所有已知实现类:

WxMaKefuServiceImpl

public interface WxMaKefuService

 小程序客服管理接口.
 不同于 WxMaCustomserviceWorkService (企业微信客服绑定) 和 WxMaMsgService.sendKefuMsg (发送客服消息),
 此接口专门处理小程序客服账号管理、会话管理等功能。
 
 注意：小程序客服管理接口与公众号客服管理接口在API端点和功能上有所不同。
 

作者:

Binary Wang

方法概要

限定符和类型	方法和说明
boolean	kfAccountAdd(WxMaKfAccountRequest request) 添加客服账号 详情请见：添加客服账号 接口url格式：https://api.weixin.qq.com/customservice/kfaccount/add?
boolean	kfAccountDel(String kfAccount) 删除客服账号 详情请见：删除客服账号 接口url格式：https://api.weixin.qq.com/customservice/kfaccount/del?
boolean	kfAccountUpdate(WxMaKfAccountRequest request) 修改客服账号 详情请见：修改客服账号 接口url格式：https://api.weixin.qq.com/customservice/kfaccount/update?
WxMaKfList	kfList() 获取客服基本信息 详情请见：获取客服基本信息 接口url格式：https://api.weixin.qq.com/cgi-bin/customservice/getkflist?
boolean	kfSessionClose(String openid, String kfAccount) 关闭会话 详情请见：关闭会话 接口url格式：https://api.weixin.qq.com/customservice/kfsession/close?
boolean	kfSessionCreate(String openid, String kfAccount) 创建会话 详情请见：创建会话 接口url格式：https://api.weixin.qq.com/customservice/kfsession/create?
WxMaKfSession	kfSessionGet(String openid) 获取客户的会话状态 详情请见：获取客户的会话状态 接口url格式：https://api.weixin.qq.com/customservice/kfsession/getsession?
WxMaKfSessionList	kfSessionList(String kfAccount) 获取客服的会话列表 详情请见：获取客服的会话列表 接口url格式：https://api.weixin.qq.com/customservice/kfsession/getsessionlist?

方法详细资料

kfList

WxMaKfList kfList()
           throws WxErrorException

 获取客服基本信息
 详情请见：获取客服基本信息
 接口url格式：https://api.weixin.qq.com/cgi-bin/customservice/getkflist?access_token=ACCESS_TOKEN
 

返回:

客服列表

抛出:

WxErrorException - 异常

kfAccountAdd

boolean kfAccountAdd(WxMaKfAccountRequest request)
              throws WxErrorException

 添加客服账号
 详情请见：添加客服账号
 接口url格式：https://api.weixin.qq.com/customservice/kfaccount/add?access_token=ACCESS_TOKEN
 

参数:

request - 客服账号信息

返回:

是否成功

抛出:

WxErrorException - 异常

kfAccountUpdate

boolean kfAccountUpdate(WxMaKfAccountRequest request)
                 throws WxErrorException

 修改客服账号
 详情请见：修改客服账号
 接口url格式：https://api.weixin.qq.com/customservice/kfaccount/update?access_token=ACCESS_TOKEN
 

参数:

request - 客服账号信息

返回:

是否成功

抛出:

WxErrorException - 异常

kfAccountDel

boolean kfAccountDel(String kfAccount)
              throws WxErrorException

 删除客服账号
 详情请见：删除客服账号
 接口url格式：https://api.weixin.qq.com/customservice/kfaccount/del?access_token=ACCESS_TOKEN&kf_account=KFACCOUNT
 

参数:

kfAccount - 客服账号

返回:

是否成功

抛出:

WxErrorException - 异常

kfSessionCreate

boolean kfSessionCreate(String openid,
                        String kfAccount)
                 throws WxErrorException

 创建会话
 详情请见：创建会话
 接口url格式：https://api.weixin.qq.com/customservice/kfsession/create?access_token=ACCESS_TOKEN
 

参数:

openid - 用户openid

kfAccount - 客服账号

返回:

是否成功

抛出:

WxErrorException - 异常

kfSessionClose

boolean kfSessionClose(String openid,
                       String kfAccount)
                throws WxErrorException

 关闭会话
 详情请见：关闭会话
 接口url格式：https://api.weixin.qq.com/customservice/kfsession/close?access_token=ACCESS_TOKEN
 

参数:

openid - 用户openid

kfAccount - 客服账号

返回:

是否成功

抛出:

WxErrorException - 异常

kfSessionGet

WxMaKfSession kfSessionGet(String openid)
                    throws WxErrorException

 获取客户的会话状态
 详情请见：获取客户的会话状态
 接口url格式：https://api.weixin.qq.com/customservice/kfsession/getsession?access_token=ACCESS_TOKEN&openid=OPENID
 

参数:

openid - 用户openid

返回:

会话信息

抛出:

WxErrorException - 异常

kfSessionList

WxMaKfSessionList kfSessionList(String kfAccount)
                         throws WxErrorException

 获取客服的会话列表
 详情请见：获取客服的会话列表
 接口url格式：https://api.weixin.qq.com/customservice/kfsession/getsessionlist?access_token=ACCESS_TOKEN&kf_account=KFACCOUNT
 

参数:

kfAccount - 客服账号

返回:

会话列表

抛出:

WxErrorException - 异常