更新客服信息

PATCH

https://open.feishu.cn/open-apis/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	客服状态错误

请求示例

Shell

JavaScript

Java

Swift

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

响应示例

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

请求参数

Path 参数

agent_id

string

必需

客服id

示例值："ou_14777d82ffef0f707de5a8c7ff2c5ebe"

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

status

string

必需

agent status 示例值：1：在线；2：离线

示例

返回响应

🟢200成功

application/json

Body

code

integer

必需

错误码，非 0 表示失败

msg

string

错误描述

必需

data

object

必需

修改于 2023-02-02 04:27:42

接入指南

获取客服邮箱

更新客服信息

错误码#

请求参数

返回响应

错误码