添加客服帐号

POST

/cgi-bin/kf/account/add

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

权限说明:

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

第三方应用需具有“微信客服->管理帐号、分配会话和收发消息”权限

代开发自建应用需具有“微信客服->管理帐号、分配会话和收发消息”权限

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

请求示例

Shell

JavaScript

Java

Swift

curl --location -g --request POST 'https://qyapi.weixin.qq.com/cgi-bin/kf/account/add?access_token=' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "新建的客服帐号",
    "media_id": "294DpAog3YA5b9rTK4PjjfRfYLO0L5qpDHAJIzhhQ2jAEWjb9i661Q4lk8oFnPtmj"
}'

响应示例

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

请求参数

Query 参数

access_token

调用接口凭证

必需

示例值:

Body 参数application/json

name

string

可选

media_id

string

可选

示例

返回响应

🟢200成功

application/json

Body

errcode

integer <int32>

可选

errmsg

string

可选

open_kfid

string

可选

修改于 2022-12-06 09:30:50

回调通知

删除客服帐号