跳到正文
Calab

机器人

机器人和其他成员一样

在工作区设置中创建机器人并为其分配角色——它使用与应用相同的 API:聊天、命令、语音。

权限来自角色,与普通成员相同:机器人只能看到允许它进入的房间。

机器人

  • 聊天

    读写消息、回复、添加表情回应、发送文件和贴纸、发送私信。事件通过 WebSocket 实时到达。

  • 语音

    通过 LiveKit 加入语音房间:听到参与者并自己说话——文字转语音、回声、音乐。支持 Node、Python 和 Go。

  • 命令

    注册 /命令——输入“/”时输入框会提示。/cmd 消息会连同解析好的参数送达机器人。

  • Webhook

    无需保持连接:事件以带 HMAC 签名的 POST 请求送达,失败时自动重试。

@calaba/bot-sdk

TypeScript 回声机器人

import { Bot } from '@calaba/bot-sdk';const bot = new Bot(process.env.BOT_TOKEN, { server: 'https://app.calab.ru' });await bot.commands([{ name: 'echo', description: 'Repeat the text' }]);// every message from someone elsebot.on('message', (m) => bot.reply(m, m.content));// "/echo hi" → "hi"bot.on('command', (c) => bot.reply(c, c.args || 'Usage: /echo <text>'));await bot.start();
此示例及另外三个示例(语音回声、文字转语音、Python 监听器)位于 examples/bots。

机器人

5 分钟创建第一个机器人

令牌、REST、事件、webhook、语音、限制和错误码——详见文档。