Name

QQ::weixin::work::kf::service_state

DESCRIPTION

微信客服->会话分配与消息收发->分配客服会话

FUNCTION

get(access_token, hash);

获取会话状态

SYNOPSIS

https://developer.work.weixin.qq.com/document/path/94669#获取会话状态

请求说明:

请求包结构体为:

{
"open_kfid": "wkxxxxxxxxxxxxxxxxxx",
"external_userid": "wmxxxxxxxxxxxxxxxxxx"
}

参数说明:

参数 必须 类型 说明
access_token 是 调用接口凭证
open_kfid 是 客服帐号ID
external_userid 是 微信客户的external_userid

权限说明

企业需要使用“微信客服”secret所获取的accesstoken来调用(accesstoken如何获取?) 第三方应用需具有“微信客服权限->管理帐号、分配会话和收发消息”权限

RETURN 返回结果

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

RETURN 参数说明

参数 类型 说明
errcode int 返回码
errmsg string 错误码描述
service_state int 当前的会话状态,状态定义参考概述中的表格
servicer_userid string 接待人员的userid。第三方应用为密文userid,即open_userid。仅当state=3时有效

trans(access_token, hash);

变更会话状态

SYNOPSIS

https://developer.work.weixin.qq.com/document/path/94669#变更会话状态

请求说明:

请求包结构体为:

{
"open_kfid": "wkxxxxxxxxxxxxxxxxxx",
"external_userid": "wmxxxxxxxxxxxxxxxxxx",
"service_state": 3,
"servicer_userid": "zhangsan"
}

参数说明:

参数 必须 类型 说明
access_token 是 调用接口凭证
open_kfid 是 客服帐号ID
external_userid 是 微信客户的external_userid
service_state 是 变更的目标状态,状态定义和所允许的变更可参考概述中的流程图和表格
servicer_userid 否 接待人员的userid。第三方应用填密文userid,即open_userid。当state=3时要求必填,接待人员须处于“正在接待”中。

权限说明

企业需要使用“微信客服”secret所获取的accesstoken来调用(accesstoken如何获取?) 第三方应用需具有“微信客服->管理帐号、分配会话和收发消息”权限

RETURN 返回结果

{
"errcode": 0,
"errmsg": "ok",
"msg_code": "MSG_CODE"
}

RETURN 参数说明

参数 类型 说明
errcode int 返回码
errmsg string 错误码描述
msg_code string 用于发送响应事件消息的code,将会话初次变更为service_state为2和3时,返回回复语code,service_state为4时,返回结束语code。
可用该code调用发送事件响应消息接口给客户发送事件响应消息