查询全部客服技能

获取全部客服技能。

请求

项目	值
HTTP URL	https://open.feishu.cn/open-apis/helpdesk/v1/agent_skills
HTTP Method	GET
接口频率限制	特殊频控
支持的应用类型	custom
权限要求 调用该 API 所需的权限。开启其中任意一项权限即可调用	helpdesk:all:readonly 获取服务台资源详情

请求头

名称	类型	必填	描述
Authorization	string	是	tenant_access_token 值格式："Bearer access_token" 示例值："Bearer t-7f1bcd13fc57d46bac21793a18e560" 了解更多：如何选择与获取 access token

Tip: 服务台请求Header中还需添加“服务台token”参数：

Key: X-Lark-Helpdesk-Authorization

Value: base64(helpdesk_id:helpdesk_token)，通过base64加密将helpdesk_id和helpdesk_token用':'连接而成的字符串。

了解更多：获取与使用服务台token

响应

响应体

名称	类型	描述
code	int	错误码，非 0 表示失败
msg	string	错误描述
data	\-	-
└ agent_skills	agent_skill\[\]	客服技能列表
└ id	string	技能id
└ name	string	技能名
└ agent_ids	string\[\]	具有此技能的客服ids
└ is_default	boolean	默认技能

响应体示例

{
    "code": 0,
    "msg": "success",
    "data": {
        "agent_skills": [
            {
                "id": "test-skill-id",
                "name": "skill-name",
                "agent_ids": [
                    "ou_ea651a5c09e2d01af8acd34059f5359b"
                ],
                "is_default": false
            }
        ]
    }
}

错误码

HTTP状态码	错误码	描述	排查建议
400	154000	Bad request, please check your request body	请求不合法，请检查参数
403	154003	Please check you have the correct access	检查是否申请正确权限
500	155000	Internal error	内部错误，请联系我们
401	154001	Unauthorized, please check you have the correct access	检查Authorization 和 X-Lark-Helpdesk-Authorization 是否正确，应用和服务台属于同一租户