send_private_msg
Send a single immediate private QQ message to a specified friend or user, supporting text, CQ codes, or rich media message segments; use group messaging tools for group chats.
Instructions
向指定 QQ 好友或私聊用户发送单条即时私聊消息 (OneBot 11: send_private_msg)。
适用场景:向个人 QQ 账号发送文本、CQ 码或富媒体消息段。不适用与替代:若目标是 QQ 群聊,请改用 send_group_msg;若需发送本地文件附件,请改用 upload_private_file。
参数约束与交互:message 支持含 CQ 码的字符串或 OneBot 标准消息段数组(如 [{"type":"face","data":{"id":"14"}}]);仅当希望将 [CQ:...] 原样作为纯文本输出时才将 auto_escape 设为 True。
行为与返回:非幂等外部发送操作(调用即真实发出消息);前置要求当前账号已在线且与目标存在好友或临时会话关系,成功返回 status='ok' 及 data.message_id(可用于后续 delete_msg 撤回),被风控或非好友时返回非 0 retcode。
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"user_id": "<user_id>",
"message": "<message>"
},
"name": "send_private_msg"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| message | Yes | 消息正文;可传普通字符串、内嵌 CQ 码字符串或 OneBot 11 消息段对象数组 | |
| user_id | Yes | 接收方个人 QQ 号(5~11 位正整数) | |
| auto_escape | No | 为 True 时忽略文本中的 CQ 码语法并按纯文本字面量发送;为 False 时解析 CQ 码,默认 False |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | No | 接口返回的业务负载数据(对象或数组,具体字段依工具而定) | |
| status | No | 执行状态标识,成功为 'ok'(或特定生命周期状态),失败为 'failed' 或 'error' | |
| message | No | 状态说明或错误诊断详情 | |
| retcode | No | OneBot 11 响应状态码,0 表示成功,非 0 表示协议端或网络错误 |