跳转到正文
好友消息

合并转发

好友消息中的 forward 消息段说明、查询逐条消息与自定义上传规则。

好友消息中的合并转发卡片消息段,type 为 "forward"。

forward 字段说明

字段类型说明
service_iduint32转发卡片服务类型值,原样保留
res_idstring(可选)合并转发资源 ID,为空时省略;查询逐条内容时原样传给 get_forward_message
user_iduint64(可选)卡片发送人 QQ 号,未提供时省略;查询逐条内容时原样传给 get_forward_message
titlestring卡片标题
summarystring卡片摘要
previewstring[]预览文案数组
countuint64(可选)顶层消息条数,未提供时省略
messagesForwardMessage[](可选)内嵌展开的转发记录数组,未提供时省略

使用说明

  • 收到 forward 段时,从同一个 forward 段的 data.user_id 和 data.res_id 取出参数,连同同次回调的 self_id、platform 传给 get_forward_message 查询逐条内容(不需要群号或完整消息段)。
  • 通过 upload_forward_message 上传自定义合并转发后,返回的 result->message 含一条 forward 段,其 data.count 为顶层条数。
  • 嵌套引用已有转发时,取同一账号、平台和目标上传结果的 result->message 数组中唯一的 forward 对象,原样放入当前记录的 message 数组,不要传整个数组、只传 res_id 或添加 user_id。

FriendMessage 公共字段

字段类型说明
self_iduint64_t收到消息的 Bot 账号
platformconst char *所属平台 PLATFORM_*
user_iduint64_t发送人 QQ 号
msg_sequint64_t消息序号
msg_uiduint64_t消息唯一编号
randomuint64_t消息随机数
msg_timeuint64_t发送时间(Unix 秒)
messageconst char *消息段 UTF-8 JSON 数组(Segment[])
nicknameconst char *好友显示名:优先本 Bot 的备注,其次昵称;未取到时为 ""

本页目录