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

权限说明:

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

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

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

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

请求参数

Query 参数

access_token

调用接口凭证

必需

示例值:

Body 参数application/json

open_kfid

string

必需

客服帐号ID客服帐号ID

external_userid

string

必需

微信客户的external_userid微信客户的external_userid

service_state

integer

必需

变更的目标状态，状态定义和所允许的变更可参考概述中的流程图和表格变更的目标状态，状态定义和所允许的变更可参考概述中的流程图和表格

servicer_userid

string

可选

接待人员的userid，当state=3时要求必填，接待人员须处于“正在接待”中。接待人员的userid，当state=3时要求必填，接待人员须处于“正在接待”中。

示例

返回响应

🟢200成功

application/json

Body

errcode

integer <int32>

返回码

可选

errmsg

string

错误码描述

可选

msg_code

string

必需

用于发送响应事件消息的code，将会话初次变更为service_state为2和3时，返回回复语code，service_state为4时，返回结束语code。可用该code调用发送事件响应消息接口给客户发送事件响应消息