发送群聊消息。
调用
const result = await api.send_group_msg(self_id, group_id, message)
参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
self_id |
number | 是 | 在线 Bot QQ 号 |
group_id |
number | 是 | 目标群聊 ID |
message |
Segment[] | 是 | 消息段数组 |
支持 text、at、image、voice、video 和 face 等群聊消息段,详见消息段。
video 必须作为消息数组中的唯一消息段单独发送。
返回值
{
success: true,
msg_seq: 123,
msg_random: 456,
}
msg_seq 与 msg_random 可用于 recall_group_msg。
示例
await api.send_group_msg(123456789, 987654321, [
{ type: 'text', data: { text: '你好 🎉 [bq190]' } },
{ type: 'at', data: { uin: '112233445' } },
])
text 直接支持 Unicode emoji,并会把 [bq190] 解析为 QQ 自带的 190 号表情。需要精确控制表情消息段时,也可以使用 { type: 'face', data: { kind: 'qq_face', face_id: '190' } }。