飞书 API

更新客服技能

PATCH

https://open.feishu.cn/open-apis/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用':'连接而成的字符串。

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

错误码

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

请求示例

Shell

JavaScript

Java

Swift

curl --location --request PATCH 'https://open.feishu.cn/open-apis/helpdesk/v1/agent_skills/' \
--header 'Authorization;' \
--header 'Content-Type: application/json' \
--data-raw '{
  "agent_skill": {
    "name": "skill-name",
    "rules": [
      {
        "id": "test-skill-id",
        "selected_operator": 8,
        "operator_options": [
          3
        ],
        "operand": {
          "selected_departments": [
            {
              "id": "部门ID",
              "name": "IT"
            }
          ]
        }
      }
    ],
    "agent_ids": [
      "ou_ea21d7f018e1155d960e40d33191f966"
    ]
  }
}'

响应示例

{
  "code": 0,
  "msg": "success",
  "data": {}
}

请求参数

Path 参数

agent_skill_id

string

必需

agent skill id

示例值："test-skill-id"

Header 参数

Authorization

string

必需

tenant_access_token 或 user_access_token 值格式："Bearer access_token" 示例值："Bearer u-7f1bcd13fc57d46bac21793a18e560"

默认值:

Bearer {{access_token}}

Content-Type

string

必需

固定值："application/json; charset=utf-8"

默认值:

application/json; charset=utf-8

Body 参数application/json

agent_skill

object

更新技能

可选

name

string

可选

技能名示例值："skill-name"

rules

array [object {4}]

技能rules

可选

agent_ids

array[string]

可选

具有此技能的客服ids 示例值：["ou_ea21d7f018e1155d960e40d33191f966"]

示例

返回响应

🟢200成功

application/json

Body

code

integer

必需

错误码，非 0 表示失败

msg

string

错误描述

必需

data

object

必需

修改于 2023-02-02 05:53:19

删除客服技能

查询指定客服技能

更新客服技能

错误码#

请求参数

返回响应

错误码