创建客服技能

该接口用于创建客服技能。

Tip: 注意事项： user_access_token 访问，需要操作者是当前服务台的管理员或所有者

请求

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

请求头

名称	类型	必填	描述
Authorization	string	是	user_access_token 值格式："Bearer access_token" 示例值："Bearer u-7f1bcd13fc57d46bac21793a18e560" 了解更多：如何选择与获取 access token
Content-Type	string	是	固定值："application/json; charset=utf-8"

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

Key: X-Lark-Helpdesk-Authorization

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

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

请求体

名称	类型	必填	描述
name	string	否	技能名 示例值："test-skill"
rules	agent_skill_rule\[\]	否	技能rules
└ id	string	否	rule id, 参考获取客服技能rules 用于获取rules options 示例值："test-skill-id"
└ selected_operator	int	否	运算符比较, 参考客服技能运算符选项 示例值：8
└ operand	string	否	rule 操作数的值 示例值："{\"selected_departments\":[{\"id\":\"部门ID\",\"name\":\"IT\"}]}"
└ category	int	否	rule 类型，1-知识库，2-工单信息，3-用户飞书信息 示例值：3
agent_ids	string\[\]	否	客服 ids 示例值：["ou_ea21d7f018e1155d960e40d33191f966"]

请求体示例

{
    "name": "部门技能",
    "rules": [
        {
            "id": "12",
            "selected_operator": 8,
            "operand": {
                "selected_departments": [
                    {
                        "id": "部门ID",
                        "name": "IT"
                    }
                ]
            }
        }
    ],
    "agent_ids": [
        "客服ID"
    ]
}

响应

响应体

名称	类型	描述
code	int	错误码，非 0 表示失败
msg	string	错误描述
data	\-	-
└ agent_skill_id	string	客服技能id

响应体示例

{
    "code": 0,
    "msg": "success",
    "data": {
        "agent_skill_id": "test-skill-id"
    }
}

错误码

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