帮你快速理解、总结文档立即下载
文档中心>腾讯云智能体开发平台>API 文档>应用运营相关接口>查询消息列表

查询消息列表

最近更新时间：2026-08-20 19:50:23
我的收藏

本页目录：

1. 接口描述

接口请求域名： adp.tencentcloudapi.com 。

查询应用的对话消息记录列表，支持按渠道类型、反馈类型、意图、调用结果等条件过滤，并支持游标分页与按创建时间排序

默认接口请求频率限制：20次/秒。

推荐使用 API Explorer
点击调试
API Explorer 提供了在线调用、签名验证、SDK 代码生成和快速检索接口等能力。您可查看每次调用的请求内容和返回结果以及自动生成 SDK 调用示例。

2. 输入参数

以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见 公共请求参数。

参数名称 必选 类型 描述
Action 是 String 公共参数，本接口取值：DescribeMsgRecordList。
Version 是 String 公共参数，本接口取值：2026-05-20。
Region 是 String 公共参数，详见产品支持的 地域列表。
AppId 是 String

应用 ID


示例值：2087429578337166592
FilterList.N 否 Array of Filter

过滤条件列表，支持：ChannelType（渠道类型，0 全部）、FeedbackType（反馈类型，-1 为全部）、QueryType、Query、CategoryId、ReplyMethod、StartTime、EndTime（秒时间戳）、Cursor（游标信息，上一页取响应 PrevCursor，下一页取响应 NextCursor）、Direction（方向，next 下一页，prev 上一页）、CallResult（调用结果，默认 0 为全部，1 为成功，2 为失败）、FailReason、Intent
PageNumber 否 Integer

页码，从 0 开始；不传时按 0 处理


示例值：1
PageSize 否 Integer

每页数量，最大 100；不传或传 0 时按默认分页大小处理


示例值：10
Sort 否 Sort

排序条件，只支持按 CreateTime 排序

3. 输出参数

参数名称 类型 描述
HasMore Boolean

是否有更多页


示例值：false
MsgRecordList Array of MsgRecord

消息记录列表
NextCursor String

下一页游标信息


示例值：{"cursor_time":"2026-08-12 14:43:24","skipped":6}
PrevCursor String

上一页游标信息


示例值：{"cursor_time":"2026-08-12 17:13:29","skipped":0}
TotalCount String

符合条件的总记录数，用于前端分页显示


示例值：6
RequestId String 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。

4. 示例

示例1 用例1

输入示例

POST / HTTP/1.1
Host: adp.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: DescribeMsgRecordList
<公共请求参数>

{
    "AppId": "2087429578337166592",
    "FilterList": [
        {
            "Name": "StartTime",
            "ValueList": [
                "1786118400"
            ]
        }
    ]
}

输出示例

{
    "Response": {
        "HasMore": false,
        "MsgRecordList": [
            {
                "Answer": "# 《逆天仙途》\n\n## 第一章：废柴逆命\n\n---\n\n苍莽山脉深处，云雾缭绕如海。\n\n落云城外，一座破旧的柴房内，少年林渊盘膝而坐，双目紧闭，额上青筋暴起，豆大的汗珠顺着脸颊滚落。\n\n\"又失败了。\"\n\n他缓缓睁开眼，眸中满是苦涩。十六岁，练",
                "AppId": "2087429578337166592",
                "CategoryId": "0",
                "CreateTime": "1786526009",
                "Intent": "其他问题",
                "IntentCategory": "default",
                "IsSmart": false,
                "Question": "帮我写一个修仙小说 不调用任何工具",
                "RecordId": "Gwx_20260812_171328_602_BAZ2vswt",
                "ReplyMethod": 10,
                "Result": {
                    "CallResult": 3,
                    "CustomerVariable": "**",
                    "FailReason": "0",
                    "FirstTokenLatency": 2685,
                    "InputToken": 1991,
                    "OutputToken": 44,
                    "TotalToken": 2035,
                    "TotalTokenLatency": 6444
                },
                "Score": 0,
                "SessionId": "c0a10dbb-b9fa-4aae-89fd-7f0d44a8eec0",
                "Source": {
                    "ChannelType": 2,
                    "FromId": "1319",
                    "FromType": 2,
                    "UserAvatar": "https://qidian-qbot-1251316161.cos.ap-guangzhou.myqcloud.com/public/avatar_sheep01.png",
                    "UserId": "1932008810606356480",
                    "UserNickname": "ty_02@tt.com"
                },
                "TraceId": "34e89fa8029842ebaaac03cd31192d23"
            }
        ],
        "NextCursor": "{\"cursor_time\":\"2026-08-12 14:43:24\",\"skipped\":6}",
        "PrevCursor": "{\"cursor_time\":\"2026-08-12 17:13:29\",\"skipped\":0}",
        "TotalCount": "6",
        "RequestId": "b3eedba2-e542-4e7e-aa84-0b2d46f8ec1f"
    }
}

5. 开发者资源

腾讯云 API 平台

腾讯云 API 平台 是综合 API 文档、错误码、API Explorer 及 SDK 等资源的统一查询平台，方便您从同一入口查询及使用腾讯云提供的所有 API 服务。

API Inspector

用户可通过 API Inspector 查看控制台每一步操作关联的 API 调用情况，并自动生成各语言版本的 API 代码，也可前往 API Explorer 进行在线调试。

SDK

云 API 3.0 提供了配套的开发工具集（SDK），支持多种编程语言，能更方便的调用 API。

命令行工具

6. 错误码

以下仅列出了接口业务逻辑相关的错误码，其他错误码详见 公共错误码。

错误码 描述
InternalError 内部错误。
InvalidParameter 参数错误。
中国站