第三方应用开发 服务端API 微信客服 接待人员管理 添加接待人员
添加接待人员
最后更新:2023/11/30
可联系渠道经理采购或代理智慧硬件接口已支持设备 联系渠道经理
添加接待人员
最后更新:2023/11/30

添加指定客服账号的接待人员,每个客服账号目前最多可添加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至少需要填其中一个

 

权限说明:
调用的应用需要满足如下的权限

应用类型权限要求
自建应用配置到「 微信客服- 可调用接口的应用」中
第三方应用具有“微信客服->管理账号、分配会话和收发消息”权限
代开发自建应用具有“微信客服->管理账号、分配会话和收发消息”权限

注: 从2023年12月1日0点起,不再支持通过系统应用secret调用接口,存量企业暂不受影响 查看详情

  • 只能通过API管理企业指定的客服账号。企业可在管理后台“微信客服-通过API管理微信客服账号”处设置对应的客服账号通过API来管理。
  • 操作的客服账号对应的接待人员应在应用的可见范围内

 

返回结果:

{
    "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结果信息
上一篇
获取客服账号链接
下一篇
删除接待人员