WxCpKfServiceImpl (WxJava - CP Java SDK 4.7.0 API)

java.lang.Object
- me.chanjar.weixin.cp.api.impl.WxCpKfServiceImpl

所有已实现的接口:

WxCpKfService
```
public class WxCpKfServiceImpl
extends Object
implements WxCpKfService
```
微信客服接口-服务实现

作者:

Fu created on 2022/1/19 19:41

构造器概要

构造器
构造器和说明

WxCpKfServiceImpl()

构造器
构造器和说明
`WxCpKfServiceImpl()`

方法概要

所有方法实例方法具体方法
限定符和类型	方法和说明
`WxCpKfAccountAddResp`	`addAccount(WxCpKfAccountAdd add)` 添加客服帐号，并可设置客服名称和头像。
`WxCpKfServicerOpResp`	`addServicer(String openKfid, List<String> userIdList)` 接待人员管理添加指定客服帐号的接待人员，每个客服帐号目前最多可添加500个接待人员。
`WxCpBaseResp`	`cancelUpgradeService(String openKfid, String externalUserId)` 为客户取消推荐
`WxCpKfCustomerBatchGetResp`	`customerBatchGet(List<String> externalUserIdList)` 获取客户基础信息
`WxCpBaseResp`	`delAccount(WxCpKfAccountDel del)` 删除已有的客服帐号
`WxCpKfServicerOpResp`	`delServicer(String openKfid, List<String> userIdList)` 接待人员管理从客服帐号删除接待人员
`WxCpKfAccountLinkResp`	`getAccountLink(WxCpKfAccountLink link)` 企业可通过此接口获取带有不同参数的客服链接，不同客服帐号对应不同的客服链接。
`WxCpKfGetCorpStatisticResp`	`getCorpStatistic(WxCpKfGetCorpStatisticRequest request)` 获取「客户数据统计」企业汇总数据通过此接口，可以获取咨询会话数、咨询客户数等企业汇总统计数据请求方式：POST(HTTPS) 请求地址：	`WxCpKfGetServicerStatisticResp`	`getServicerStatistic(WxCpKfGetServicerStatisticRequest request)` 获取「客户数据统计」接待人员明细数据通过此接口，可获取接入人工会话数、咨询会话数等与接待人员相关的统计信息请求方式：POST(HTTPS) 请求地址：	`WxCpKfServiceStateResp`	`getServiceState(String openKfid, String externalUserId)` 分配客服会话获取会话状态
`WxCpKfServiceUpgradeConfigResp`	`getUpgradeServiceConfig()` 获取配置的专员与客户群
`WxCpKfAccountListResp`	`listAccount(Integer offset, Integer limit)` 获取客服帐号列表，包括所有的客服帐号的客服ID、名称和头像。
`WxCpKfServicerListResp`	`listServicer(String openKfid)` 接待人员管理获取某个客服帐号的接待人员列表
`WxCpKfMsgSendResp`	`sendMsg(WxCpKfMsgSendRequest request)` 发送消息当微信客户处于“新接入待处理”或“由智能助手接待”状态下，可调用该接口给用户发送消息。
`WxCpKfMsgSendResp`	`sendMsgOnEvent(WxCpKfMsgSendRequest request)` 发送欢迎语等事件响应消息当特定的事件回调消息包含code字段，或通过接口变更到特定的会话状态，会返回code字段。
`WxCpKfMsgListResp`	`syncMsg(String cursor, String token, Integer limit, Integer voiceFormat)` 读取消息微信客户发送的消息、接待人员在企业微信回复的消息、发送消息接口发送失败事件（如被用户拒收）、客户点击菜单消息的回复消息，可以通过该接口获取具体的消息内容和事件。
`WxCpKfMsgListResp`	`syncMsg(String cursor, String token, Integer limit, Integer voiceFormat, String openKfId)`
`WxCpKfServiceStateTransResp`	`transServiceState(String openKfid, String externalUserId, Integer serviceState, String servicerUserId)` 分配客服会话变更会话状态
`WxCpBaseResp`	`updAccount(WxCpKfAccountUpd upd)` 修改已有的客服帐号，可修改客服名称和头像。
`WxCpBaseResp`	`upgradeGroupchatService(String openKfid, String externalUserId, String chatId, String wording)` 升级客户群服务
`WxCpBaseResp`	`upgradeMemberService(String openKfid, String externalUserId, String userid, String wording)` 升级专员服务

从类继承的方法 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 构造器详细资料
  - WxCpKfServiceImpl
```
public WxCpKfServiceImpl()
```
- 方法详细资料
  - addAccount
```
public WxCpKfAccountAddResp addAccount(WxCpKfAccountAdd add)
                                throws WxErrorException
```
    从接口复制的说明: WxCpKfService
    
    添加客服帐号，并可设置客服名称和头像。目前一家企业最多可添加10个客服帐号
    
    指定者:
    
    addAccount 在接口中 WxCpKfService
    
    参数:
    
    add - 客服帐号信息
    
    返回:
    
    result -新创建的客服帐号ID
    
    抛出:
    
    WxErrorException - 异常
  - updAccount
```
public WxCpBaseResp updAccount(WxCpKfAccountUpd upd)
                        throws WxErrorException
```
    从接口复制的说明: WxCpKfService
    
    修改已有的客服帐号，可修改客服名称和头像。
    
    指定者:
    
    updAccount 在接口中 WxCpKfService
    
    参数:
    
    upd - 新的客服账号信息
    
    返回:
    
    result wx cp base resp
    
    抛出:
    
    WxErrorException - 异常
  - delAccount
```
public WxCpBaseResp delAccount(WxCpKfAccountDel del)
                        throws WxErrorException
```
    从接口复制的说明: WxCpKfService
    
    删除已有的客服帐号
    
    指定者:
    
    delAccount 在接口中 WxCpKfService
    
    参数:
    
    del - 要删除的客服帐号
    
    返回:
    
    result wx cp base resp
    
    抛出:
    
    WxErrorException - 异常
  - listAccount
```
public WxCpKfAccountListResp listAccount(Integer offset,
                                         Integer limit)
                                  throws WxErrorException
```
    从接口复制的说明: WxCpKfService
    
    获取客服帐号列表，包括所有的客服帐号的客服ID、名称和头像。
    
    指定者:
    
    listAccount 在接口中 WxCpKfService
    
    参数:
    
    offset - 分页，偏移量, 默认为0
    
    limit - 分页，预期请求的数据量，默认为100，取值范围 1 ~ 100
    
    返回:
    
    客服帐号列表 wx cp kf account list resp
    
    抛出:
    
    WxErrorException - 异常
  - getAccountLink
```
public WxCpKfAccountLinkResp getAccountLink(WxCpKfAccountLink link)
                                     throws WxErrorException
```
    从接口复制的说明: WxCpKfService
    
    企业可通过此接口获取带有不同参数的客服链接，不同客服帐号对应不同的客服链接。获取后，企业可将链接嵌入到网页等场景中，微信用户点击链接即可向对应的客服帐号发起咨询。企业可依据参数来识别用户的咨询来源等
    
    指定者:
    
    getAccountLink 在接口中 WxCpKfService
    
    参数:
    
    link - 参数
    
    返回:
    
    链接 account link
    
    抛出:
    
    WxErrorException - 异常
  - addServicer
```
public WxCpKfServicerOpResp addServicer(String openKfid,
                                        List<String> userIdList)
                                 throws WxErrorException
```
    从接口复制的说明: WxCpKfService
    
    接待人员管理添加指定客服帐号的接待人员，每个客服帐号目前最多可添加500个接待人员。
    
    指定者:
    
    addServicer 在接口中 WxCpKfService
    
    参数:
    
    openKfid - 客服帐号ID
    
    userIdList - 接待人员userid列表。第三方应用填密文userid，即open_userid 可填充个数：1 ~ 100。超过100个需分批调用。
    
    返回:
    
    添加客服账号结果 wx cp kf servicer op resp
    
    抛出:
    
    WxErrorException - 异常
  - delServicer
```
public WxCpKfServicerOpResp delServicer(String openKfid,
                                        List<String> userIdList)
                                 throws WxErrorException
```
    从接口复制的说明: WxCpKfService
    
    接待人员管理从客服帐号删除接待人员
    
    指定者:
    
    delServicer 在接口中 WxCpKfService
    
    参数:
    
    openKfid - 客服帐号ID
    
    userIdList - 接待人员userid列表。第三方应用填密文userid，即open_userid 可填充个数：1 ~ 100。超过100个需分批调用。
    
    返回:
    
    删除客服账号结果 wx cp kf servicer op resp
    
    抛出:
    
    WxErrorException - 异常
  - listServicer
```
public WxCpKfServicerListResp listServicer(String openKfid)
                                    throws WxErrorException
```
    从接口复制的说明: WxCpKfService
    
    接待人员管理获取某个客服帐号的接待人员列表
    
    指定者:
    
    listServicer 在接口中 WxCpKfService
    
    参数:
    
    openKfid - 客服帐号ID
    
    返回:
    
    接待人员列表 wx cp kf servicer list resp
    
    抛出:
    
    WxErrorException - 异常
  - getServiceState
```
public WxCpKfServiceStateResp getServiceState(String openKfid,
                                              String externalUserId)
                                       throws WxErrorException
```
    从接口复制的说明: WxCpKfService
    
    分配客服会话获取会话状态
    
    指定者:
    
    getServiceState 在接口中 WxCpKfService
    
    参数:
    
    openKfid - 客服帐号ID
    
    externalUserId - 微信客户的external_userid
    
    返回:
    
    service state
    
    抛出:
    
    WxErrorException - the wx error exception
  - transServiceState
```
public WxCpKfServiceStateTransResp transServiceState(String openKfid,
                                                     String externalUserId,
                                                     Integer serviceState,
                                                     String servicerUserId)
                                              throws WxErrorException
```
    从接口复制的说明: WxCpKfService
    
    分配客服会话变更会话状态
    
    指定者:
    
    transServiceState 在接口中 WxCpKfService
    
    参数:
    
    openKfid - 客服帐号ID
    
    externalUserId - 微信客户的external_userid
    
    serviceState - 变更的目标状态，状态定义和所允许的变更可参考概述中的流程图和表格
    
    servicerUserId - 接待人员的userid。第三方应用填密文userid，即open_userid。当state=3时要求必填，接待人员须处于“正在接待”中。
    
    返回:
    
    部分状态返回回复语code wx cp kf service state trans resp
    
    抛出:
    
    WxErrorException - the wx error exception
  - syncMsg
```
public WxCpKfMsgListResp syncMsg(String cursor,
                                 String token,
                                 Integer limit,
                                 Integer voiceFormat)
                          throws WxErrorException
```
    从接口复制的说明: WxCpKfService
    
    读取消息微信客户发送的消息、接待人员在企业微信回复的消息、发送消息接口发送失败事件（如被用户拒收）、客户点击菜单消息的回复消息，可以通过该接口获取具体的消息内容和事件。不支持读取通过发送消息接口发送的消息。支持的消息类型：文本、图片、语音、视频、文件、位置、链接、名片、小程序、菜单、事件。
    
    指定者:
    
    syncMsg 在接口中 WxCpKfService
    
    参数:
    
    cursor - 上一次调用时返回的next_cursor，第一次拉取可以不填。不多于64字节
    
    token - 回调事件返回的token字段，10分钟内有效；可不填，如果不填接口有严格的频率限制。不多于128字节
    
    limit - 期望请求的数据量，默认值和最大值都为1000。注意：可能会出现返回条数少于limit的情况，需结合返回的has_more字段判断是否继续请求。
    
    voiceFormat - 语音消息类型，0-Amr 1-Silk，默认0。可通过该参数控制返回的语音格式
    
    返回:
    
    微信消息 wx cp kf msg list resp
    
    抛出:
    
    WxErrorException - 异常
  - syncMsg
```
public WxCpKfMsgListResp syncMsg(String cursor,
                                 String token,
                                 Integer limit,
                                 Integer voiceFormat,
                                 String openKfId)
                          throws WxErrorException
```
    指定者:
    
    syncMsg 在接口中 WxCpKfService
    
    抛出:
    
    WxErrorException
  - sendMsg
```
public WxCpKfMsgSendResp sendMsg(WxCpKfMsgSendRequest request)
                          throws WxErrorException
```
    从接口复制的说明: WxCpKfService
    
    发送消息当微信客户处于“新接入待处理”或“由智能助手接待”状态下，可调用该接口给用户发送消息。注意仅当微信客户在主动发送消息给客服后的48小时内，企业可发送消息给客户，最多可发送5条消息；若用户继续发送消息，企业可再次下发消息。支持发送消息类型：文本、图片、语音、视频、文件、图文、小程序、菜单消息、地理位置。
    
    指定者:
    
    sendMsg 在接口中 WxCpKfService
    
    参数:
    
    request - 发送信息
    
    返回:
    
    发送结果 wx cp kf msg send resp
    
    抛出:
    
    WxErrorException - 异常
  - sendMsgOnEvent
```
public WxCpKfMsgSendResp sendMsgOnEvent(WxCpKfMsgSendRequest request)
                                 throws WxErrorException
```
    从接口复制的说明: WxCpKfService
    
    发送欢迎语等事件响应消息当特定的事件回调消息包含code字段，或通过接口变更到特定的会话状态，会返回code字段。开发者可以此code为凭证，调用该接口给用户发送相应事件场景下的消息，如客服欢迎语、客服提示语和会话结束语等。除"用户进入会话事件"以外，响应消息仅支持会话处于获取该code的会话状态时发送，如将会话转入待接入池时获得的code仅能在会话状态为”待接入池排队中“时发送。
    目前支持的事件场景和相关约束如下：
    事件场景允许下发条数 code有效期支持的消息类型获取code途径用户进入会话，用于发送客服欢迎语 1条 20秒文本、菜单事件回调进入接待池，用于发送排队提示语等 1条 48小时文本转接会话接口从接待池接入会话，用于发送非工作时间的提示语或超时未回复的提示语等 1条 48小时文本事件回调、转接会话接口结束会话，用于发送结束会话提示语或满意度评价等 1条 20秒文本、菜单事件回调、转接会话接口
    
    指定者:
    
    sendMsgOnEvent 在接口中 WxCpKfService
    
    参数:
    
    request - the request
    
    返回:
    
    wx cp kf msg send resp
    
    抛出:
    
    WxErrorException - the wx error exception
  - customerBatchGet
```
public WxCpKfCustomerBatchGetResp customerBatchGet(List<String> externalUserIdList)
                                            throws WxErrorException
```
    从接口复制的说明: WxCpKfService
    
    获取客户基础信息
    
    指定者:
    
    customerBatchGet 在接口中 WxCpKfService
    
    参数:
    
    externalUserIdList - the external user id list
    
    返回:
    
    wx cp kf customer batch get resp
    
    抛出:
    
    WxErrorException - the wx error exception
  - getUpgradeServiceConfig
```
public WxCpKfServiceUpgradeConfigResp getUpgradeServiceConfig()
                                                       throws WxErrorException
```
    从接口复制的说明: WxCpKfService
    
    获取配置的专员与客户群
    
    指定者:
    
    getUpgradeServiceConfig 在接口中 WxCpKfService
    
    返回:
    
    upgrade service config
    
    抛出:
    
    WxErrorException - the wx error exception
  - upgradeMemberService
```
public WxCpBaseResp upgradeMemberService(String openKfid,
                                         String externalUserId,
                                         String userid,
                                         String wording)
                                  throws WxErrorException
```
    从接口复制的说明: WxCpKfService
    
    升级专员服务
    
    指定者:
    
    upgradeMemberService 在接口中 WxCpKfService
    
    参数:
    
    openKfid - 客服帐号ID
    
    externalUserId - 微信客户的external_userid
    
    userid - 服务专员的userid
    
    wording - 推荐语
    
    返回:
    
    wx cp base resp
    
    抛出:
    
    WxErrorException - the wx error exception
  - upgradeGroupchatService
```
public WxCpBaseResp upgradeGroupchatService(String openKfid,
                                            String externalUserId,
                                            String chatId,
                                            String wording)
                                     throws WxErrorException
```
    从接口复制的说明: WxCpKfService
    
    升级客户群服务
    
    指定者:
    
    upgradeGroupchatService 在接口中 WxCpKfService
    
    参数:
    
    openKfid - 客服帐号ID
    
    externalUserId - 微信客户的external_userid
    
    chatId - 客户群id
    
    wording - 推荐语
    
    返回:
    
    wx cp base resp
    
    抛出:
    
    WxErrorException - the wx error exception
  - cancelUpgradeService
```
public WxCpBaseResp cancelUpgradeService(String openKfid,
                                         String externalUserId)
                                  throws WxErrorException
```
    从接口复制的说明: WxCpKfService
    
    为客户取消推荐
    
    指定者:
    
    cancelUpgradeService 在接口中 WxCpKfService
    
    参数:
    
    openKfid - 客服帐号ID
    
    externalUserId - 微信客户的external_userid
    
    返回:
    
    wx cp base resp
    
    抛出:
    
    WxErrorException - the wx error exception
  - getCorpStatistic
```
public WxCpKfGetCorpStatisticResp getCorpStatistic(WxCpKfGetCorpStatisticRequest request)
                                            throws WxErrorException
```
    从接口复制的说明: WxCpKfService
```
 获取「客户数据统计」企业汇总数据
 通过此接口，可以获取咨询会话数、咨询客户数等企业汇总统计数据
 请求方式：POST(HTTPS)
 请求地址：
 https://qyapi.weixin.qq.com/cgi-bin/kf/get_corp_statistic?access_token=ACCESS_TOKEN
 文档地址：
 https://developer.work.weixin.qq.com/document/path/95489
 
```
    指定者:
    
    getCorpStatistic 在接口中 WxCpKfService
    
    参数:
    
    request - 查询参数
    
    返回:
    
    客户数据统计 -企业汇总数据
    
    抛出:
    
    WxErrorException - the wx error exception
  - getServicerStatistic
```
public WxCpKfGetServicerStatisticResp getServicerStatistic(WxCpKfGetServicerStatisticRequest request)
                                                    throws WxErrorException
```
    从接口复制的说明: WxCpKfService
```
 获取「客户数据统计」接待人员明细数据
 通过此接口，可获取接入人工会话数、咨询会话数等与接待人员相关的统计信息
 请求方式：POST(HTTPS)
 请求地址：
 https://qyapi.weixin.qq.com/cgi-bin/kf/get_servicer_statistic?access_token=ACCESS_TOKEN
 文档地址：
 https://developer.work.weixin.qq.com/document/path/95490
 
```
    指定者:
    
    getServicerStatistic 在接口中 WxCpKfService
    
    参数:
    
    request - 查询参数
    
    返回:
    
    客户数据统计 -企业汇总数据
    
    抛出:
    
    WxErrorException - the wx error exception

类 WxCpKfServiceImpl

构造器概要

方法概要

从类继承的方法 java.lang.Object

构造器详细资料

WxCpKfServiceImpl

方法详细资料

addAccount

updAccount

delAccount

listAccount

getAccountLink

addServicer

delServicer

listServicer

getServiceState

transServiceState

syncMsg

syncMsg

sendMsg

sendMsgOnEvent

customerBatchGet

getUpgradeServiceConfig

upgradeMemberService

upgradeGroupchatService

cancelUpgradeService

getCorpStatistic

getServicerStatistic