get_recent_contact

根据框架当前进程已经接收或观察到的群聊、私聊事件生成近期会话，不读取手机 QQ 数据库，也不向 QQ 请求会话列表。

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

读取当前账号与协议的本地消息缓存，按会话去重，count 默认 20，范围 1–100；不代表 QQ 云端全部最近联系人。

适用协议

Android / Linux QQ；查询当前账号实例已接收的消息缓存。

调用方式

向已认证的 WebSocket 连接发送：

json

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

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

参数	类型	必填	说明
`self_id`	`integer`	是	当前框架内的账号 QQ 号
`protocol_id`	`integer`	是	账号协议配置 ID；从 get_protocol_list 获取，必须显式传入，0 也是有效 ID
`count`	`integer`	否	读取条数

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

data 为数组，下表描述每个元素。

字段	类型	说明
`type`	`string`	操作类型，见使用说明
`group_id`	`integer`	目标群号
`user_id`	`integer`	目标 QQ 号
`last_message`	`object`	本地缓存中该会话的最后一条消息
`last_message.message_id`	`integer`	消息事件或发送结果中的框架消息编号
`last_message.self_id`	`integer`	当前框架内的账号 QQ 号
`last_message.protocol_id`	`integer`	账号协议配置 ID；从 get_protocol_list 获取，必须显式传入，0 也是有效 ID
`last_message.message_type`	`string`	会话类型
`last_message.group_id`	`integer`	目标群号
`last_message.user_id`	`integer`	目标 QQ 号
`last_message.sender`	`object`	发送者信息
`last_message.sender.user_id`	`integer`	目标 QQ 号
`last_message.msg_seq`	`integer`	上游消息序列号
`last_message.msg_random`	`integer`	上游消息随机数
`last_message.time`	`integer`	业务时间戳
`last_message.message`	`string`	消息段数组，结构见消息段参考
`last_message.raw_message`	`string`	消息纯文本预览