文档反馈官招募中，报名立赚积分兑换代金券！> HOT
文档中心>即时通信 IM>智能客服（Desk）>服务端配置>服务端 API>数据分析相关>查询客服成员状态轨迹数据

查询客服成员状态轨迹数据

最近更新时间：2025-10-10 09:17:51

我的收藏

本页目录：

接口调用说明

通过该接口查询客服成员状态轨迹数据。

请求 URL 示例

https://console.tim.qq.com/v4/desk_http_svc/describe_member_status_trace?sdkappid=88888888&identifier=admin&usersig=xxx&random=99999999&contenttype=json

请求参数说明

下表仅列出调用本接口时涉及修改的参数及其说明，更多参数详情请参见 REST API 简介。
参数
说明
v4/desk_http_svc/describe_member_status_trace
请求接口。
sdkappid
创建应用时即时通信 IM 控制台分配的 SDKAppID。
identifier
必须为 App 管理员账号，更多详情请参见 App 管理员。
usersig
App 管理员账号生成的签名，具体操作请参见 生成 UserSig。
random
请输入随机的32位无符号整数，取值范围0 - 4294967295。
contenttype
请求格式固定值为json。

请求包示例

{
    "BeginTime": 1750120000,
    "EndTime": 1757596587,
    "Order":1,
    "MemberID": "test@tencent.com"
}

请求包字段说明

字段
类型
属性
说明
BeginTime
Integer
必填
起始时间，Unix 秒级时间戳。
EndTime
Integer
必填
结束时间，Unix 秒级时间戳。（注意：只允许查询3个月范围内的数据）
Order
Integer
必填
查询结果的排序顺序：
1 表示按照时间正序返回结果。
2 表示按照时间倒序返回结果。
MemberID
String
必填
待查询的客服成员邮箱。

应答包体示例

{
    "ActionStatus": "OK",
    "ErrorCode": 0,
    "ErrorInfo": "",
    "Nick": "testStaff",
    "StatusList": [
        {
            "Timestamp": 1750120000,
            "Status": "STATUS_OFFLINE",
            "Clients": []
        },
        {
            "Timestamp": 1751511949,
            "Status": "STATUS_FREE",
            "Clients": [
                {
                    "ClientType": "Web"
                }
            ]
        }]
}

应答包字段说明

字段
类型
说明
ErrorCode
Integer
错误码：
0表示成功。
非0表示失败。
ErrorInfo
String
错误信息。
ActionStatus
String
请求处理的结果。
Nick
String
客服成员的昵称。
StatusList
Array
客服成员状态变更轨迹的数据列表。
Timestamp
Integer
客服成员状态变更时间，Unix 秒级时间戳。
Status
String
状态值，可能的值有：
STATUS_FREE：示闲
STATUS_NOT_READY：示忙
STATUS_REST：小休
STATUS_OFFLINE：离线
Clients
Array
客户端列表。
ClientType
String
客户端类型，可能的值有：
Web：Web 工作台
Mobile：微信小程序工作台

错误码说明

除非发生网络错误（例如502错误），否则该接口的 HTTP 返回码均为200。真正的错误码，错误信息是通过应答包体中的 ErrorCode、ErrorInfo 来表示的。
公共错误码（60000到79999）参见 错误码 文档。
本 API 私有错误码如下：
错误码
描述
141000
该应用非智能客服应用。
141002
内部错误，请重试。
141004
参数非法。
141009
接口限频。

接口调试工具

通过 REST API 在线调试工具 调试本接口。
中国站
目录