查询指定客服技能

GET

/helpdesk/v1/agent_skills/{agent_skill_id}

该接口用于获取客服技能。

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

Key: X-Lark-Helpdesk-Authorization

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

错误码

HTTP状态码	错误码	描述	排查建议
400	154000	Bad request, please check your request body	请求不合法，请检查参数
403	154003	Please check you have the correct access	检查是否申请正确权限
500	155000	Internal error	内部错误，请联系我们

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Path 参数

返回响应

🟢200成功

application/json

Body

请求示例

Shell

JavaScript

Java

Swift

curl --location --request GET '/helpdesk/v1/agent_skills/' \
--header 'Authorization: Bearer <token>'

响应示例

{
    "code": 0,
    "msg": "success",
    "data": {
        "agent_skill": {
            "id": "test-skill-id",
            "name": "skill-name",
            "rules": [
                {
                    "id": "test-skill-id",
                    "selected_operator": 8,
                    "operator_options": [
                        3
                    ],
                    "operand": {
                        "selected_departments": [
                            {
                                "id": "部门ID",
                                "name": "IT"
                            }
                        ]
                    },
                    "category": 3,
                    "display_name": "中文知识库分类"
                }
            ],
            "agent_ids": [
                "ou_ea21d7f018e1155d960e40d33191f966"
            ],
            "is_default": false,
            "agents": [
                {
                    "id": "ou_ea651a5c09e2d01af8acd34059f5359b",
                    "avatar_url": "https://avatar-url.com/test.png",
                    "name": "test-user"
                }
            ]
        }
    }
}

修改于 2025-10-21 07:25:57

更新客服技能

查询全部客服技能

查询指定客服技能

错误码#

请求参数

返回响应

错误码