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

添加客服账号,并可设置客服名称和头像。目前一家企业最多可添加5000个客服账号。

请求方式: POST(HTTPS)

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

请求示例

{
    "name": "新建的客服账号",
    "media_id": "294DpAog3YA5b9rTK4PjjfRfYLO0L5qpDHAJIzhhQ2jAEWjb9i661Q4lk8oFnPtmj"
}

参数说明:

参数必须类型说明
access_tokenstring调用接口凭证
namestring客服名称
不多于16个字符
media_idstring客服头像临时素材。可以调用上传临时素材接口获取。
不多于128个字节

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

应用类型权限要求
自建应用配置到「 微信客服- 可调用接口的应用」中,且在管理后台「通过API管理会话消息」-「企业内部开发」对应的自建应用的「可管理的客服账号」处,配置至少一个客服账号
第三方应用具有“微信客服->管理账号、分配会话和收发消息”权限
代开发自建应用具有“微信客服->管理账号、分配会话和收发消息”权限

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

通过接口创建的客服账号,将自动拥有该客服账号的管理权限。企业可在管理后台“微信客服-通过API管理微信客服账号”处设置对应的客服账号通过API来管理。

返回结果:

{
    "errcode": 0,
    "errmsg": "ok",
    "open_kfid": "wkAJ2GCAAAZSfhHCt7IFSvLKtMPxyJTw"
}

参数说明:

参数类型说明
errcodeint32返回码
errmsgstring错误码描述
open_kfidstring新创建的客服账号ID
上一篇
概述
下一篇
删除客服账号