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调用发送事件响应消息接口给客户发送事件响应消息