get_group_msg_history

从 QQ 服务器读取指定群聊的历史消息。该接口使用 Android QQ 的 MessageSvc.PbGetGroupMsg，返回的 message_id 可以继续用于 get_msg、撤回、转发和标记已读。

此接口在已认证的服务连接中调用，账号须属于当前框架且处于在线状态。self_id 与 protocol_id 共同选择账号。

count 默认 20，范围 1–100。message_seq 为读取起点；返回的 message_id 可继续用于引用。

适用协议

Android（手机 / 平板）；Linux QQ 支持情况待核验。

调用方式

向已认证的 WebSocket 连接发送：

{
  "type": "action",
  "id": "example-1",
  "action": "get_group_msg_history",
  "params": {
    "self_id": 123456789,
    "protocol_id": 0,
    "group_id": 987654321
  }
}

响应通过相同 id 对应请求。连接、HTTP 调用与错误处理见通信协议。

参数

参数	类型	必填	说明
self_id	integer	是	当前框架内的账号 QQ 号
protocol_id	integer	是	账号协议配置 ID；从 get_protocol_list 获取，必须显式传入，0 也是有效 ID
group_id	integer	是	目标群号
message_seq	integer	否	历史消息序列号游标
count	integer	否	读取条数
reverse_order	boolean	否	是否反向排序，默认 false

返回值

以下为成功响应的 data，错误通过 ok: false 与 error 返回。

字段	类型	说明
messages	object[]	转发节点数组，详见下方结构
next_cursor	integer	下一批历史消息游标
has_more_before	boolean	是否还有更早的消息