黑盒语音机器人帮助文档
    黑盒语音机器人帮助文档
    • 教程
    • 开发者服务协议
    • 使用交流
    • 更新日志
    • 开发计划
    • 基础框架须知
    • 资源
      • 请求速率限制
      • Websocket
      • Bot命令
    • WEBSOCKET 连接请求
      • 连接到黑盒语音服务
    • HTTP接口
      • 消息接口
        • 发送消息接口的参数
        • 发送消息接口的返回值
        • 发送图片形式的频道消息
        • 发送Markdown文档
        • 更新指定频道消息
        • 删除指定的频道消息
        • 对某条频道消息增加/取消回应(小表情)
        • 发送卡片消息
        • 给用户发送私聊消息
        • 发送频道图片消息
        • 发送频道消息
        • 发送卡片消息
        • 发送频道消息@全体成员/@在线成员
        • 更新指定的频道消息
        • 删除指定的频道消息
        • 对某条频道消息增加/取消回应(小表情)
        • 给用户发送私聊消息
      • 媒体文件上传
        • 上传媒体文件的参数解析
        • 上传媒体文件
      • 房间角色接口
        • 权限相关说明
        • 接口说明
        • 获取房间角色列表
        • 创建角色
        • 更新角色
        • 删除角色
        • 对指定用户授予指定权限
        • 对指定用户剥夺指定权限
      • 房间表情
        • 房间表情包
        • 获取房间上传的表情包
        • 房间删除表情包
        • 房间更新表情包名称
      • 房间接口
        • 房间相关接口文档
        • 修改房间内昵称
        • 分页获取加入的房间列表
        • 获取房间信息
        • 退出房间
        • 房间踢人
        • 语音频道之间移动用户
        • 踢出语音频道中的用户
        • 禁言/解禁用户
        • 频道内麦克风静音/解禁
        • 房间内麦克风静音/解禁
        • 房间内扬声器静音/解禁
        • 获取用户所在频道
        • 获取语音频道内在线成员列表
        • 创建频道邀请链接
        • 频道设置修改
        • 频道名编辑
        • 设置频道密码
        • 修改权限组或成员权限
        • 获取房间用户列表
        • 获取用户频道权限
        • 创建频道
        • 删除频道
      • 在线媒体流
        • 在线媒体流说明文档
        • 推流至语音频道
        • 停止推流至语音频道
      • OAuth
        • OAuth使用说明
        • 获取授权码
        • 获取AccessToken
        • 刷新AccessToken
        • 获取用户信息
        • 获取用户房间内语音时长
        • 获取用户房间内语音游戏时长
        • 获取用户信息-自动触发授权
    • 服务端推送事件
      • 事件说明
      • 通用推送字段
      • 机器人命令
        • 用户使用Bot命令
      • 频道消息事件
        • 频道消息事件
      • 房间消息事件
        • 房间消息事件
    • 自定义卡片消息
      • 自定义卡片编辑器
      • 物料组件
        • 卡片
        • 文本
        • 标题
        • 图片
        • 按钮组
        • 分割线
        • 倒计时

    基础框架须知

    接口通信基础说明#

    接口通信基础框架,BOT 开发者对接黑盒语音机器人开放平台提供的接口能力,开发出一款可用的机器人
    接口通信基础框架

    接口鉴权#

    在每次调用HTTP接口请求的时候,需要在 header 内引入 token 进行调用权限验证, token可在机器人开发平台创建bot后获取
    示例
    {
      "headers": {
        "token": "ODYzNzY0NDM7MTc1NTc1OTk1NzYyODYzNjQ0NzsxNTU0MDM2NTkxNzk2OTM1OTY5"
      }
    }
    

    心跳#

    服务端需要定期发送心跳以保证连接存活 推荐以30s为周期进行心跳,发送文本PING,心跳发送成功之后会收到PONG作为响应
    修改于 2025-08-22 07:35:55
    上一页
    开发计划
    下一页
    请求速率限制
    Built with