查询消息列表

1. 接口描述

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

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

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

2. 输入参数

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

3. 输出参数

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。

• Tencent Cloud SDK 3.0 for Python: CNB, GitHub, Gitee
• Tencent Cloud SDK 3.0 for Java: CNB, GitHub, Gitee
• Tencent Cloud SDK 3.0 for PHP: CNB, GitHub, Gitee
• Tencent Cloud SDK 3.0 for Go: CNB, GitHub, Gitee
• Tencent Cloud SDK 3.0 for Node.js: CNB, GitHub, Gitee
• Tencent Cloud SDK 3.0 for .NET: CNB, GitHub, Gitee
• Tencent Cloud SDK 3.0 for C++: CNB, GitHub, Gitee
• Tencent Cloud SDK 3.0 for Ruby: CNB, GitHub, Gitee

命令行工具

• Tencent Cloud CLI 3.0

6. 错误码

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