分配客服会话-获取会话状态

POST

/cgi-bin/kf/service_state/get

服务端API企业内部开发第三方应用开发

权限说明:

企业需要使用“微信客服”secret所获取的accesstoken来调用（accesstoken如何获取？），同时开启“会话消息管理”开关

第三方应用需具有“微信客服权限->管理帐号、分配会话和收发消息”权限

代开发自建应用需具有“微信客服->管理帐号、分配会话和收发消息”权限

请求示例

Shell

JavaScript

Java

Swift

curl --location -g --request POST 'https://qyapi.weixin.qq.com/cgi-bin/kf/service_state/get?access_token=' \
--header 'Content-Type: application/json' \
--data-raw '{
    "open_kfid": "wkxxxxxxxxxxxxxxxxxx",
    "external_userid": "wmxxxxxxxxxxxxxxxxxx"
}'

响应示例

{
  "errcode": 0,
  "errmsg": "ok",
  "service_state": 3,
  "servicer_userid": "zhangsan"
}

请求参数

Query 参数

access_token

调用接口凭证

必需

示例值:

Body 参数application/json

open_kfid

string

客服帐号ID

必需

external_userid

string

必需

微信客户的external_userid

示例

返回响应

🟢200成功

application/json

Body

errcode

integer <int32>

返回码

可选

service_state

integer <int32>

可选

当前的会话状态，状态定义参考概述中的表格

errmsg

string

错误码描述

可选

servicer_userid

string

可选

接待人员的userid。第三方应用为密文userid，即open_userid。仅当state=3时有效

修改于 2022-12-06 09:40:09

概述

分配客服会话-变更会话状态