NapCat
  1. 发送私聊消息
NapCat
  • 默认模块
    • NapCat 接口文档
    • 消息接口
      • 发送群聊消息
        • 发送群艾特
        • 发送群图片
        • 发送群JSON
        • 发送群系统表情
        • 发送群视频
        • 发送群回复
        • 发送群聊音乐卡片
        • 发送群语音
        • 发送群文件
        • 发送群聊超级表情 骰子
        • 发送群聊超级表情 猜拳
        • 发送群聊自定义音乐卡片
      • 发送私聊消息
        • 发送私聊图片
          POST
        • 发送私聊系统表情
          POST
        • 发送私聊语音
          POST
        • 发送私聊视频
          POST
        • 发送私聊回复
          POST
        • 发送私聊音乐卡片
          POST
        • 发送私聊JSON
          POST
        • 发送私聊自定义音乐卡片
          POST
        • 发送私聊超级表情 骰子
          POST
        • 发送私聊超级表情 猜拳
          POST
        • 发送私聊文件
          POST
      • 发送私聊文本
        POST
      • 撤回消息
        POST
      • send_msg
        POST
      • 获取消息详情
        POST
      • 设置消息已读
        POST
      • 设置私聊已读
        POST
      • 消息转发到私聊
        POST
      • 设置群聊已读
        POST
      • 消息转发到群
        POST
      • _设置所有消息已读
        POST
    • 群组扩展
      • 设置群搜索
      • 删除群相册媒体
      • 点赞群相册媒体
      • 设置群添加选项
      • 发表群相册评论
      • 设置群机器人添加选项
      • 获取群相册媒体列表
      • 获取群相册列表
      • 设置群备注
      • 上传图片到群相册
      • 获取群信息ex
      • 群打卡
      • 群打卡
    • 用户接口
      • 获取cookies
      • 点赞
      • 处理好友请求
      • 最近消息列表
      • 获取好友列表
      • 设置好友备注
    • 用户扩展
      • 获取好友分组列表
      • 获取点赞列表
      • 获取单向好友列表
      • 设置自定义在线状态
    • 扩展接口
      • 获取clientkey
      • OCR 图片识别
      • .OCR 图片识别
      • 英译中
      • 批量踢出群成员
      • 获取AI语音人物
      • 设置头像
      • 创建收藏
      • 设置个性签名
      • 设置群头衔
    • Go-CQHTTP
      • 设置账号信息
      • 获取群历史消息
      • 检查链接安全性
      • 获取合并转发消息
      • 获取当前账号在线客户端列表
      • 上传群文件
      • .对事件执行快速操作
      • 创建群文件文件夹
      • 删除群文件
      • 获取好友历史消息
      • 删除群文件夹
      • 上传私聊文件
      • 发送合并转发消息
      • 获取群文件系统信息
      • 下载文件到缓存目录
      • 发送群合并转发消息
      • 发送私聊合并转发消息
      • 设置群头像
      • 获取群根目录文件列表
      • 获取群子目录文件列表
      • 获取账号信息
      • _发送群公告
      • 删除好友
      • _获取在线机型
      • _设置在线机型
      • 获取群荣誉
      • 获取群 @全体成员 剩余次数
    • 流式接口
      • 下载文件流
      • 上传文件流
    • AI 扩展
      • 获取AI语音
      • 发送群AI语音
    • 流式传输扩展
      • 清理流式传输临时文件
      • 下载语音文件流
      • 下载图片文件流
      • 测试下载流
    • 文件接口
      • 获取文件信息
      • 获取语音消息详情
      • 获取图片消息详情
      • 获取群文件链接
      • 获取私聊文件链接
    • 文件扩展
      • 移动群文件
      • 转存为永久文件
      • 重命名群文件
      • 创建闪照任务
      • 获取闪照文件列表
      • 获取闪照文件链接
      • 发送闪照消息
      • 获取文件分享链接
      • 获取文件集信息
      • 获取在线文件消息
      • 发送在线文件
      • 发送在线文件夹
      • 接收在线文件
      • 拒绝在线文件
      • 取消在线文件
      • 下载文件集
      • 获取文件集 ID
    • 核心接口
      • 发送戳一戳
      • 设置群待办
      • 发送私聊戳一戳
      • 发送群聊戳一戳
    • 消息扩展
      • 获取消息表情点赞列表
      • 获取推荐好友/群聊卡片
      • 分享群 (Ark)
      • 分享用户 (Ark)
      • 贴表情
      • 获取推荐群聊卡片
      • 获取贴表情详情
      • 点击按钮
    • 群组接口
      • 发送群文本
      • 获取群详细信息
      • 获取被过滤的加群请求
      • 群踢人
      • 群禁言
      • 获取群精华消息
      • 全体禁言
      • 设置群管理
      • 设置群成员名片
      • 设置群精华消息
      • 设置群名
      • 删除群精华消息
      • 退群
      • _获取群公告
      • 处理加群请求
      • 获取群信息
      • 获取群列表
      • _删除群公告
      • 获取群成员信息
      • 获取群成员列表
      • 获取群禁言列表
      • 获取群过滤系统消息
    • 系统接口
      • 获取被过滤好友请求
      • 获取 CSRF Token
      • 处理被过滤好友请求
      • 获取 QQ 相关接口凭证
      • 获取packet状态
      • 获取版本信息
      • 检查是否可以发送图片
      • 检查是否可以发送语音
      • 获取群系统消息
      • 重启服务
      • 清空缓存
      • 获取登录号信息
      • 获取状态
    • 系统扩展
      • 获取机器人账号范围
      • 获取收藏列表
      • 账号退出
      • 发送自定义组包
      • 设置输入状态
      • nc获取rkey
      • 获取rkey
      • 获取rkey服务
      • 设置在线状态
      • 获取收藏表情
      • 获取用户状态
      • 获取小程序卡片
    • 频道接口
      • get_guild_list
      • get_guild_service_profile
    • NapCat
      • 消息相关
        • 发送群聊消息
        • 发送私聊消息
      • 群聊相关
      • 密钥相关
      • 个人操作
      • 系统操作
      • 账号相关
      • 文件相关
      • 其他
        • 保留
          • send_private_msg
          • send_group_msg
        • 接口
          • unknown
        • bug
    • 数据模型
      • 接口定义
        • Sender
        • User
        • Group
        • GroupMember
        • GroupFile
        • GroupFileFolder
        • Message
        • UserSex
        • GroupMemberRole
      • 数据类型
        • 群荣誉信息
        • 消息详情
        • group_id
        • user_id
        • number | string
        • message_id
        • 好友信息
        • 群文件信息
        • 群文件夹信息
        • 点赞信息
        • 系统信息
      • 消息类型
        • 文本消息
        • MessageMixType
        • 艾特消息
        • mface
        • text
        • poke
        • contact
        • record
        • file
        • video
        • reply
        • face
        • music
        • json
        • dice
        • rps
        • markdown
        • forward
        • messageData
        • 表情消息
        • 图片消息
        • FileBase
        • image
        • at
        • node
        • 回复消息
        • JSON消息
        • 语音消息
        • 视频消息
        • markdown消息
        • 音乐卡片消息
        • 自定义音乐卡片消息
        • 一级合并转发消息
        • 文件消息
        • 获取合并转发消息
        • 消息forward
        • 发送forward
        • 二级合并转发消息
        • MessageData[]
      • 其他
        • sender
        • result
  • 导入模块
    • NapCat 接口文档
    • 账号相关
      • 设置消息已读
      • 设置私聊已读
      • 设置群聊已读
      • 最近消息列表
      • _设置所有消息已读
      • 点赞
      • 处理好友请求
      • 获取账号信息
      • 获取好友列表
      • 获取好友分组列表
      • 设置账号信息
      • 删除好友
      • 获取推荐好友/群聊卡片
      • 获取推荐群聊卡片
      • 设置在线状态
      • 设置自定义在线状态
      • 设置头像
      • 创建收藏
      • 设置个性签名
      • 获取收藏表情
      • 获取点赞列表
      • 获取用户状态
      • 获取小程序卡片
      • 获取单向好友列表
      • 获取登录号信息
      • 获取状态
      • 获取当前账号在线客户端列表
      • _获取在线机型
      • _设置在线机型
      • 获取被过滤好友请求
      • 处理被过滤好友请求
      • 设置好友备注
    • 消息相关
      • 发送群聊消息
        • 发送群文本
        • 发送群艾特
        • 发送群回复
        • 发送群图片
        • 发送群系统表情
        • 发送群骰子
        • 发送群猜拳
        • 发送群文件
        • 发送群视频
        • 发送群JSON
        • 发送群语音
        • 发送群合并转发消息
        • 消息转发到群
        • 发送群聊戳一戳
        • 发送群聊音乐卡片
      • 发送私聊消息
        • 发送私聊文本
        • 发送私聊图片
        • 发送私聊系统表情
        • 发送私聊骰子
        • 发送私聊猜拳
        • 发送私聊JSON
        • 发送私聊回复
        • 发送私聊文件
        • 发送私聊语音
        • 发送私聊视频
        • 发送私聊合并转发消息
        • 消息转发到私聊
        • 发送私聊戳一戳
        • 发送私聊音乐卡片
      • 发送戳一戳
      • 撤回消息
      • 获取群历史消息
      • 获取消息详情
      • 获取合并转发消息
      • 贴表情
      • 获取好友历史消息
      • 获取贴表情详情
      • 发送合并转发消息
      • 获取语音消息详情
      • 获取图片消息详情
      • 发送群AI语音
    • 群聊相关
      • 设置群添加选项
      • 设置群机器人添加选项
      • 批量踢出群成员
      • 设置群备注
      • 设置群头衔
      • 获取群详细信息
      • 群踢人
      • 获取群系统消息
      • 群禁言
      • 获取群精华消息
      • 全体禁言
      • 设置群头像
      • 设置群管理
      • 设置群成员名片
      • 设置群精华消息
      • 设置群名
      • 删除群精华消息
      • _删除群公告
      • 退群
      • _发送群公告
      • 设置群搜索
      • _获取群公告
      • 处理加群请求
      • 获取群信息
      • 获取群列表
      • 获取群成员信息
      • 获取群成员列表
      • 获取群荣誉
      • 获取群信息ex
      • 获取群 @全体成员 剩余次数
      • 获取群禁言列表
      • 获取群过滤系统消息
      • 群打卡
      • 群打卡
      • 设置群代办
    • 密钥相关
      • 获取cookies
      • 获取 CSRF Token
      • 获取 QQ 相关接口凭证
      • nc获取rkey
      • 获取rkey
      • 获取clientkey
      • 获取rkey服务
    • 个人操作
      • 检查是否可以发送图片
      • 检查是否可以发送语音
      • OCR 图片识别
      • .OCR 图片识别
      • 英译中
      • 设置输入状态
      • .对事件执行快速操作
      • 获取AI语音人物
      • 获取AI语音
      • 点击按钮
    • 系统操作
      • 获取版本信息
      • 获取packet状态
      • 发送自定义组包
      • 获取机器人账号范围
      • 账号退出
    • 流式操作
      • 清理流临时文件
      • 流式下载测试
      • 流式上传文件
      • 流式下载文件
      • 流式下载语音文件
      • 流式下载图片
    • 文件相关
      • 上传群文件
      • 上传私聊文件
      • 获取群根目录文件列表
      • 获取群子目录文件列表
      • 获取群文件系统信息
      • 获取文件信息
      • 获取群文件链接
      • 获取私聊文件链接
      • 创建群文件文件夹
      • 删除群文件
      • 删除群文件夹
      • 移动群文件
      • 重命名群文件
      • 转存为永久文件
      • 下载文件到缓存目录
      • 清空缓存
      • 删除群相册文件
      • 点赞群相册
      • 查看群相册评论
      • 获取群相册列表
      • 上传图片到群相册
      • 获取群相册总列表
    • 其他
      • 保留
        • send_msg
        • send_private_msg
        • send_group_msg
      • 接口
        • unknown
        • get_guild_list
        • get_guild_service_profile
        • 检查链接安全性
      • bug
        • 获取收藏列表
        • 获取被过滤的加群请求
    • 数据模型
      • 接口定义
        • Sender
        • result
        • GroupFile
        • GroupFileFolder
        • Group
        • GroupMember
        • User
        • UserSex
        • GroupMemberRole
        • Message
      • 数据类型
        • 群荣誉信息
        • 消息详情
        • number | string
        • 点赞信息
        • 系统信息
      • 消息类型
        • MessageMixType
        • face
        • reply
        • dice
        • image
        • text
        • forward
        • at
        • music
        • json
        • video
        • record
        • file
        • node
        • rps
        • MessageData[]
        • messageData
        • mface
        • markdown
        • contact
        • poke
        • FileBase
  1. 发送私聊消息

发送私聊JSON

POST
/send_private_msg
发送群消息

请求参数

Body 参数application/json

示例

返回响应

🟢200成功
application/json
Body

请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST '/send_private_msg' \
--header 'Content-Type: application/json' \
--data-raw '{
    "user_id": "123456",
    "message": [
        {
            "type": "json",
            "data": {
                "data": "{}"
            }
        },
        
    ]
}'
响应示例响应示例
{
    "status": "ok",
    "retcode": 0,
    "data": {
        "message_id": 696124706
    },
    "message": "",
    "wording": ""
}
修改于 2026-01-27 14:30:22
上一页
发送私聊音乐卡片
下一页
发送私聊自定义音乐卡片
Built with