Ir al contenido
Calab

Bots

Un bot es un miembro más

Crea un bot en los ajustes del espacio de trabajo y dale un rol: funciona con la misma API que la app — chat, comandos y voz.

Los permisos vienen de los roles, como para las personas: un bot solo ve las salas a las que tiene acceso.

Bots

  • Chat

    Lee y escribe mensajes, responde, reacciona, envía archivos y stickers y escribe mensajes directos. Eventos en tiempo real por WebSocket.

  • Voz

    Entra en una sala de voz a través de LiveKit: oye a los participantes y habla — texto a voz, eco, música. En Node, Python o Go.

  • Comandos

    Registra /comandos: el editor los sugiere al escribir «/». Un mensaje /cmd llega al bot con sus argumentos.

  • Webhook

    Sin conexión abierta: los eventos llegan como POST firmados con HMAC y se reintentan si fallan.

@calaba/bot-sdk

Un bot de eco en 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();
Este y tres ejemplos más — eco de voz, texto a voz y un oyente en Python — están en examples/bots.

Bots

Tu primer bot en 5 minutos

Token, REST, eventos, webhook, voz, límites y códigos de error — en la documentación.