黑盒语音接口
  1. 消息接口
黑盒语音接口
  • 教程
  • 开发者服务协议
  • 使用交流
  • 更新日志
  • 开发计划
  • 资源
    • 请求速率限制
    • Websocket
    • Bot命令
  • WEBSOCKET 连接请求
    • 连接到黑盒语音服务
  • HTTP接口
    • 消息接口
      • 发送消息接口的参数
      • 发送消息接口的返回值
      • 发送图片形式的频道消息
      • 发送Markdown文档
      • 更新指定频道消息
      • 删除指定的频道消息
      • 对某条频道消息增加/取消回应(小表情)
      • 发送卡片消息
      • 给用户发送私聊消息
      • 发送频道图片消息
        POST
      • 发送频道消息
        POST
      • 发送卡片消息
        POST
      • 发送频道消息@全体成员/@在线成员
        POST
      • 更新指定的频道消息
        POST
      • 删除指定的频道消息
        POST
      • 对某条频道消息增加/取消回应(小表情)
        POST
      • 给用户发送私聊消息
        POST
    • 媒体文件上传
      • 上传媒体文件的参数解析
      • 上传媒体文件
    • 房间角色接口
      • 权限相关说明
      • 接口说明
      • 获取房间角色列表
      • 创建角色
      • 更新角色
      • 删除角色
      • 对指定用户授予指定权限
      • 对指定用户剥夺指定权限
    • 房间表情
      • 房间表情包
      • 获取房间上传的表情包
      • 房间删除表情包
      • 房间更新表情包名称
    • 房间接口
      • 房间相关接口文档
      • 修改房间内昵称
      • 分页获取加入的房间列表
      • 获取房间信息
      • 退出房间
      • 房间踢人
      • 获取房间用户列表
  • 服务端推送事件
    • 事件说明
    • 通用推送字段
    • 机器人命令
      • 用户使用Bot命令
    • 频道消息事件
      • 频道消息事件
    • 房间消息事件
      • 房间消息事件
  1. 消息接口

发送消息接口的返回值

一 发送成功#

{
    "msg": "",
    "result": {
        "chatmobile_ack_id": "",
        "heychat_ack_id": "0",
        "msg_id": "1836295184143134720",
        "msg_seq": "1836295184143134720"
    },
    "status": "ok"
}
发送成功后,返回成功的结果
result 参数解析
字段名类型作用建议使用场景
chatmobile_ack_idstring移动端使用返回的通用结果机器人接口不需要这个参考值
heychat_ack_idstring机器人发送的heychat_ack_id会返回回来
msg_idstring发送成功的msg_id
msg_seqstring消息的有序值机器人接口不需要这个参考值

二 发送失败#

result 参数解析
字段名作用
msgstring
resultobject
statusstring

2.1 权限不足#

{
    "msg": "权限不足,无法发言",
    "result": {},
    "status": "failed"
}

2.2 发送消息重复#

{
    "msg": "消息已发送,请勿重复发送",
    "result": {},
    "status": "failed"
}

2.3 在没有加入的房间发送消息#

{
    "msg": "请加入房间后再发送消息",
    "result": {},
    "status": "failed"
}
修改于 2024-10-14 09:59:38
上一页
发送消息接口的参数
下一页
发送图片形式的频道消息
Built with