跳转到正文
群聊消息

红包

群聊消息中的 redpack 消息段字段与原样回传要求。

群聊消息中的红包消息段,type 为 "redpack"。调用红包接口时传入本条群消息的 group_id。

redpack 字段说明

当前仅支持接收,发送暂不支持 redpack 消息段。

字段类型说明
titlestring红包标题文案
listidstring非空字符串,调用红包接口时原样回传
authkeystring非空字符串,调用红包接口时原样回传
channeluint64无符号整数,调用红包接口时原样回传
pay_flaguint64无符号整数,调用红包接口时原样回传
hb_fromuint64无符号整数,调用红包接口时原样回传

上述凭据字段均须来自同一个红包,不得自行构造或混用,也不要将含红包凭据的完整消息写入日志。配合同次消息的 self_id、platform、user_id、group_id(私聊传 0)调用 pre_grab_red_packet 或 grab_red_packet。

GroupMessage 公共字段

字段类型说明
self_iduint64_t收到消息的 Bot 账号
platformconst char *所属平台 PLATFORM_*
group_iduint64_t群号
user_iduint64_t发送人 QQ 号
msg_sequint64_t消息序号
msg_uiduint64_t消息唯一编号
randomuint64_t消息随机数
msg_timeuint64_t发送时间(Unix 秒)
leveluint64_t发送人的群成员等级,没有时为 0
group_nameconst char *群名称
nicknameconst char *发送人昵称(设置了群名片时为群名片)
roleconst char *发送人身份:"owner" 群主、"admin" 管理员、"member" 成员
titleconst char *发送人头衔,没有时为 ""
messageconst char *消息段 UTF-8 JSON 数组(Segment[])

本页目录