1. 首页
  2. API 文档
  3. 消息与媒体
  4. send_group_msg

send_group_msg

  • 发布于 2026-08-16
  • 13 次阅读

发送群聊消息。

调用

const result = await api.send_group_msg(self_id, group_id, message)

参数

参数 类型 必填 说明
self_id number 在线 Bot QQ 号
group_id number 目标群聊 ID
message Segment[] 消息段数组

支持 textatimagevoicevideoface 等群聊消息段,详见消息段

video 必须作为消息数组中的唯一消息段单独发送。

返回值

{
  success: true,
  msg_seq: 123,
  msg_random: 456,
}

msg_seqmsg_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' } }