第三方应用开发 服务端API 微信客服 接待人员管理 添加接待人员
添加接待人员

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

请求方式: POST(HTTPS)

请求地址: https://qyapi.weixin.qq.com/cgi-bin/kf/servicer/add?access_token=ACCESS_TOKEN

请求实例:

{
	"open_kfid": "kfxxxxxxxxxxxxxx",
	"userid_list": ["zhangsan", "lisi"],
	"department_id_list": [2, 4]
}

参数说明:

参数是否必须说明
access_token调用接口凭证
open_kfid客服帐号ID
userid_list接待人员userid列表。第三方应用填密文userid,即open_userid
可填充个数:0 ~ 100。超过100个需分批调用。
department_id_list接待人员部门id列表
可填充个数:0 ~ 100。超过100个需分批调用。
userid_list和department_id_list至少需要填其中一个

 

权限说明:

  • 企业需要使用“微信客服”secret所获取的accesstoken来调用(accesstoken如何获取?),同时开启“会话消息管理”开关
  • 第三方应用需具有“微信客服->管理帐号、分配会话和收发消息”权限。仅可将应用可见范围内的成员添加为接待人员
  • 代开发自建应用需具有“微信客服->管理帐号、分配会话和收发消息”权限。仅可将应用可见范围内的成员添加为接待人员

 

返回结果:

{
    "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"
		}
	]
}

参数说明:

参数类型说明
errcodeint返回码
errmsgstring错误码描述
result_listarrary操作结果
result_list.useridstring接待人员的userid
result_list.department_idint接待人员部门的id
result_list.errcodeint该userid的添加结果
result_list.errmsgstring结果信息
上一篇
获取客服帐号链接
下一篇
删除接待人员