Skip to content

send_group_temp_msg(已移除) ​

已移除

该 API 已移除,暂不支持调用。调用将返回 API_REMOVED;下方保留原参数与响应说明供查阅。

通过共同群聊向群成员发送 QQ 原生临时会话消息。目标 QQ 不需要与发送账号建立好友关系。

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

通过指定群向成员发送临时会话消息。支持 text、image、voice、video、face、ark、reply;目标必须是本账号所在群中的真实成员。临时会话媒体请使用 upload_friend_image / upload_friend_voice / upload_friend_video 并传入相同 group_id、user_id。不能复用普通私聊或另一群临时会话的媒体引用。

适用协议

Android(手机 / 平板)/ Linux QQ。

调用方式 ​

向已认证的 WebSocket 连接发送:

json
{
  "type": "action",
  "id": "example-1",
  "action": "send_group_temp_msg",
  "params": {
    "self_id": 123456789,
    "protocol_id": 0,
    "group_id": 987654321,
    "user_id": 234567890,
    "message": [
      {
        "type": "text",
        "data": {
          "text": "你好"
        }
      }
    ]
  }
}

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

参数 ​

参数类型必填说明
self_idinteger是当前框架内的账号 QQ 号
protocol_idinteger是账号协议配置 ID;从 get_protocol_list 获取,必须显式传入,0 也是有效 ID
group_idinteger是目标群号
user_idinteger是目标 QQ 号
messageobject[]是消息段数组,结构见消息段参考

返回值 ​

引用回复使用事件顶层数字 message_id,或接收引用段中的非空 reply_reference_id;接收段内的旧字符串 message_id 与 source_msg_uid 都是原始 QQ 标识,不能代替本地引用编号。详见消息段规则。

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

字段类型说明
successboolean操作是否成功
message_idinteger消息事件或发送结果中的框架消息编号
msg_seqinteger上游消息序列号
msg_randominteger上游消息随机数
client_seqinteger客户端序列号

萌卡 · 自托管 QQ 机器人框架