添加接待人员 - 企业微信 API

添加指定客服帐号的接待人员，每个客服帐号目前最多可添加2000个接待人员，20个部门。

userid_list和department_id_list至少需要填其中一个

权限说明:

企业需要使用“微信客服”secret所获取的accesstoken来调用（accesstoken如何获取？）

第三方应用需具有“微信客服->管理帐号、分配会话和收发消息”权限。仅可将应用可见范围内的成员添加为接待人员

代开发自建应用需具有“微信客服->管理帐号、分配会话和收发消息”权限。仅可将应用可见范围内的成员添加为接待人员

只能通过API管理企业指定的客服帐号。企业可在管理后台“微信客服-通过API管理微信客服帐号”处设置对应的客服帐号通过API来管理。

curl --location -g --request POST 'https://qyapi.weixin.qq.com/cgi-bin/kf/servicer/add?access_token=' \ --header 'Content-Type: application/json' \ --data-raw '{ "open_kfid": "kfxxxxxxxxxxxxxx", "userid_list": ["zhangsan", "lisi"], "department_id_list": [2, 4] }'

{ "errcode": 0, "errmsg": "ok", "result_list": [ { "userid": "zhangsan", "errcode": 0, "errmsg": "success" }, { "userid": "lisi", "errcode": 0, "errmsg": "ignored" }, { "department_id": 2, "errcode": 0, "errmsg": "success" }, { "department_id": 3, "errcode": 0, "errmsg": "ignored" } ] }

请求参数

Query 参数

access_token

调用接口凭证

必需

示例值:

Body 参数application/json

open_kfid

string

客服帐号ID

必需

userid_list

array[string]

可选

接待人员userid列表。第三方应用填密文userid，即open_userid 可填充个数：0 ~ 100。超过100个需分批调用。

department_id_list

array[integer]

可选

接待人员部门id列表可填充个数：0 ~ 100。超过100个需分批调用。

示例

返回响应

🟢200成功

application/json

Body

errcode

integer <int32>

可选

errmsg

string

可选

result_list

array [object {4}]

操作结果

可选

errcode

integer <int32>

可选

该userid的添加结果

errmsg

string

结果信息

可选

userid

string

可选

接待人员的userid

department_id

integer

接待人员部门的id

可选