机器人
机器人和其他成员一样
在工作区设置中创建机器人并为其分配角色——它使用与应用相同的 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();机器人
5 分钟创建第一个机器人
令牌、REST、事件、webhook、语音、限制和错误码——详见文档。