send_group_red_packet

向指定群聊发送 QQ 群红包，支持拼手气、普通、专属、语音和口令五种类型。

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

仅 Android。金额单位为分。red_packet.type 支持 normal、lucky、exclusive、voice、command；专属红包使用 target_user_ids。dry_run=true 仍会向上游创建订单，但不执行余额支付。实际支付需要 payment_password；支付结果未确认时请勿自动重试，以免重复扣款。

适用协议

Android（手机 / 平板）；不支持 Linux QQ。

调用方式

向已认证的 WebSocket 连接发送：

{
  "type": "action",
  "id": "example-1",
  "action": "send_group_red_packet",
  "params": {
    "self_id": 123456789,
    "protocol_id": 0,
    "group_id": 987654321,
    "red_packet": {
      "type": "normal",
      "total_amount": 100,
      "total_num": 1,
      "wishing": "祝你开心"
    },
    "dry_run": true
  }
}

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

参数

参数	类型	必填	说明
self_id	integer	是	当前框架内的账号 QQ 号
protocol_id	integer	是	账号协议配置 ID；从 get_protocol_list 获取，必须显式传入，0 也是有效 ID
group_id	integer	是	目标群号
red_packet	object	是	红包参数对象，详见下方结构
red_packet.type	string	见说明	操作类型，见使用说明
red_packet.total_amount	integer	见说明	红包总金额，单位分
red_packet.total_num	integer	见说明	红包总份数
red_packet.wishing	string	见说明	祝福语
red_packet.target_user_ids	integer[]	见说明	专属红包接收 QQ 列表
payment_password	string	条件	支付密码，仅实际支付时使用
dry_run	boolean	否	默认 false；true 创建订单但不付款

返回值

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

字段	类型	说明
status	string	处理状态
order_created	boolean	是否已创建付款订单
payment_performed	boolean	是否执行支付
group_id	integer	目标群号
total_amount	integer	红包总金额，单位分
total_num	integer	红包总份数