botmeshFramework de bots agnóstico de transporte

Flujos, hooks, plugins y conversaciones detrás de un mismo IProvider — WhatsApp (Baileys / Cloud API) y Telegram, más Messenger, Instagram y Discord experimentales. Simple, declarativo, en TypeScript. En alpha, aún sin publicar en npm.

Empezar

Ver ejemplos

API Reference

🚆

Agnóstico de transporte

Un motor, muchos transportes. @botmesh/core corre cualquier IProvider: @botmesh/baileys (WhatsApp Web), @botmesh/meta (Cloud API oficial de WhatsApp), @botmesh/telegram — más providers experimentales de Messenger, Instagram y Discord.

💬

Declarativo

bot.when('hola', ctx => ctx.reply('¡Hola! 👋')) — sin boilerplate, sin callbacks anidados. Escribe lo que quieres que pase.

🔀

Flujos conversacionales

flow().say().ask().choose() compila a una conversación async real — validación, reintentos, branching y timeouts, sin un motor de pasos aparte.

🪝

Hooks (middleware)

before / after / onError — intercepta cualquier evento, igual que Express. Logging, rate limiting, métricas, lo que quieras.

🧩

Plugins

Empaqueta y reutiliza funcionalidad. Incluye slashCommandsPlugin listo para usar (/start, /help, /reset, /cancel, /id, /ping).

🔌

Inyección de dependencias

bot.provide('db', myDb) — disponible como ctx.tools.db en cualquier handler. Sin globales, sin acoplamiento.

⏰

Scheduler integrado

Cron, intervalos y delays con sintaxis humana. bot.every('30 seconds', ...) o bot.schedule('0 9 * * 1-5', ...).

📦

Stores conectables

MemoryStore por defecto; @botmesh/sqlite-store y @botmesh/redis-store para persistencia — o implementa el IStore genérico para lo que sea.

📸

Media completo

Foto, video, audio, voz, sticker, archivo, ubicación, contacto, encuesta — todo con una sola línea.

🔷

TypeScript nativo

Tipos en todo el ecosistema. Autocompletado y type-checking en cada handler, flow y plugin.

¿Para quién es esto?

Si sabes JavaScript básico puedes crear un bot de WhatsApp funcional en menos de 5 minutos. No necesitas saber TypeScript para empezar — los ejemplos son copia-pega-listos.