send_friend_msg

发送好友消息。

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

支持 text、image、voice、video、face、ark、reply。message 与 source_message_id 二选一。媒体需先上传到同一账号、协议及目标会话；不接受群媒体或另一好友的 file_id。

适用协议

Android（手机 / 平板）/ Linux QQ。

调用方式

向已认证的 WebSocket 连接发送：

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

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

参数

参数	类型	必填	说明
self_id	integer	是	当前框架内的账号 QQ 号
protocol_id	integer	是	账号协议配置 ID；从 get_protocol_list 获取，必须显式传入，0 也是有效 ID
user_id	integer	是	目标 QQ 号
message	object[]	二选一	消息段数组，结构见消息段参考
source_message_id	integer	否	当前账号消息缓存中的引用编号，与 message 二选一

返回值

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

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

字段	类型	说明
success	boolean	操作是否成功
message_id	integer	消息事件或发送结果中的框架消息编号
msg_seq	integer	上游消息序列号
msg_random	integer	上游消息随机数
client_seq	integer	客户端序列号