更新客服信息

PATCH

/helpdesk/v1/agents/{agent_id}

更新客服状态等信息。

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

Key: X-Lark-Helpdesk-Authorization

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

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

错误码

HTTP状态码	错误码	描述	排查建议
400	150001	param is invalis	客服状态错误

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Path 参数

Body 参数application/json

示例

返回响应

🟢200成功

application/json

Body

请求示例

Shell

JavaScript

Java

Swift

curl --location --request PATCH 'https://open.feishu.cn/open-apis/helpdesk/v1/agents/' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "status": "1：在线；2：离线"
}'

响应示例

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

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

接入指南

获取客服邮箱

更新客服信息

错误码#

请求参数

返回响应

错误码