Ejemplos - botmesh

Bots completos para copiar, ejecutar y adaptar. Casi todos los ejemplos son un único archivo bot.js que muestra un conjunto de funciones de botmesh, con una transcripción capturada de una ejecución real y enlaces a la guía de cada función que usa. Un test ejecuta el código de cada ejemplo y comprueba su transcripción, así que lo que lees es lo que obtienes.

Ejecutar cualquier ejemplo

Prepara un proyecto una vez, como en Inicio rápido (Node.js 22.12+, "type": "module", npm install @botmesh/core @botmesh/baileys).
Guarda el código del ejemplo como bot.js.
Chatea con él en la terminal, sin teléfono:
npx botmesh dev bot.js
Conéctalo de verdad con node bot.js (un QR para WhatsApp), o cambia el provider para Telegram. El código del bot no cambia entre canales.

Principiante

Ejemplo	Nivel	Etiquetas	Funciones	Qué vas a construir
Bot de saludo	Principiante	Comandos	`WELCOME`, triggers de texto y regex, `ctx.pass()`, comandos slash, catch-all	Un bot que da la bienvenida una vez, saluda, repite y lista sus comandos
Bot de FAQ	Principiante	Triggers	Coincidencia normalizada, listas, `contains`, regex, precedencia	Respuestas por palabra clave a preguntas frecuentes, con fallback
Enviar mensajes	Principiante	Triggers	Formas de trigger, `ctx.quote()`, `ctx.react()`, datos del remitente	Todas las formas de responder a un texto
Bot de menú	Principiante	Flujos, Botones	`flow().choose()`, sub-flujos `then`, `bot.conversation()`, botones por canal	El menú de una pizzería que funciona en todos los canales
Bot de encuestas	Principiante	Encuestas, Reacciones	`ctx.poll()`, `bot.on('poll')`, `bot.send()`, `ctx.react()`	Encuestas nativas respondidas con el recuento en vivo
Respuestas con media	Principiante	Media	Foto, archivo, video, voz, sticker, ubicación, contacto; `bot.onType()`, `loadMediaOf()`	Un bot que envía cada tipo de media y reacciona a imágenes
Bot de recordatorios	Principiante	Scheduler	`bot.delay()`, `bot.schedule()` con zona horaria, `task.cancel()`, `bot.send()`	Recordatorios puntuales y un consejo diario a las 9:00
Flujo de registro	Principiante	Flujos, Formularios	`.ask()` con `validate`, `.do()`, `c.state`, `.timeout()`, `/cancel`	Un alta validada que guarda al usuario

Intermedio

Ejemplo	Nivel	Etiquetas	Funciones	Qué vas a construir
Flujo de compra	Intermedio	Flujos	`.choose()`, sub-flujos `then`, `goto`, estado calculado, timeouts	Una tienda pequeña con cantidad, confirmación y dirección
Soporte con timeout	Intermedio	Conversaciones	`bot.conversation()`, `c.waitText()`, `c.choose()`, `ConversationTimeout`, `ConversationCancelled`	Un servicio de soporte que abre tickets y maneja sesiones abandonadas
Plugin: rate limiter	Intermedio	Plugins, Hooks	`definePlugin()`, `before('message')`, `abort()`, `onDispose()`	Un plugin reutilizable que limita los mensajes por usuario
Reserva de citas	Intermedio	WhatsApp, Formularios, SQLite	`.persistent()`, `.form()`, `validate` + `maxAttempts`, `SQLiteStore`, `ctx.user`	Un flujo de reservas que valida, confirma y se retoma tras un reinicio
Seguimiento de pedidos	Intermedio	WhatsApp, Datos de usuario	namespaces de `ctx.user`, `bot.conversation()`, `MemoryStore` con archivo	Consultas de pedidos que recuerdan lo que sigue cada usuario
Handoff humano	Intermedio	WhatsApp, Soporte	`ctx.handoff()`, `bot.resume()`, eventos de handoff, comandos de agente, `bot.delay()`	Un bot de soporte que pasa chats a agentes y los recupera
Bot multi-idioma	Intermedio	WhatsApp, Telegram, i18n	`bot.locale()`, `ctx.t()`, `detect`, `ctx.setLang()`, plurales	Un bot que responde a cada usuario en español o en inglés
Bot de grupo	Intermedio	WhatsApp, Telegram, Grupos	conversaciones por participante, `scope`, menciones, `groupMode`, comandos solo para admins	Un quiz de grupo con marcador y comandos de administración
WhatsApp y Telegram a la vez	Intermedio	WhatsApp, Telegram, SQLite	`defineBot`, dos providers, espacios de nombres del store, ids estables	Un archivo de bot que atiende dos canales desde un proceso

IA

Usan @botmesh/ai con Anthropic por defecto; cada página muestra cómo cambiar a OpenAI, Gemini o un modelo local de Ollama. La API key siempre sale de una variable de entorno.

Ejemplo	Nivel	Etiquetas	Funcionalidades	Qué hace
Asistente de preguntas frecuentes con IA	Principiante	IA, Límites	autoresponder, persona, triggers de función, `/reset`	Responde dudas de una tienda con un LLM, rechaza lo que no es del tema y deja las respuestas fijas fuera del modelo.
Asistente de citas con IA	Intermedio	IA, Herramientas	tool calling, `confirm: true`, `confirmLines`, `dedupe`, `enum`	Reserva, lista y cancela citas con tus funciones, con una confirmación antes de cada cambio.
IA con tus preguntas frecuentes	Intermedio	IA, RAG	retriever de `rag`, `appendSources`, `warmup()`	Responde a partir de un FAQ en Markdown, cita la sección que usó y admite lo que no sabe.
Respuestas de IA en streaming	Intermedio	IA, Streaming, Telegram	`stream`, borradores / ediciones / trozos, coste y latencia	Muestra la respuesta mientras el modelo la escribe, ajustada para coste y latencia.
Enrutador con IA	Avanzado	IA, Flujos	`generate()`, `replyInChat()`, flujos, `bot.trigger()`	Clasifica el texto libre con el modelo, lleva los pagos a flujos deterministas y deja la charla a la IA.
IA con escalado a humano	Avanzado	IA, Herramientas, Handoff	tool calling, `ctx.handoff()`, `bot.resume()`, comandos de escape	Pasa el chat a una persona con un resumen para el agente y lo recupera con `/bot`.

Avanzado

Ejemplo	Nivel	Etiquetas	Funcionalidades	Qué construyes
Servidor de webhooks para la Cloud API	Avanzado	WhatsApp, Cloud API, Webhooks, Seguridad	Webhooks de `@botmesh/meta`, firmas sobre el body crudo, ventana de 24 h, plantillas	Un servidor `node:http` para la Cloud API oficial, con plantilla de respaldo
Bot listo para producción	Avanzado	Producción, Docker, SQLite, Durabilidad	`SQLiteStore`, durabilidad, flujos persistentes, salud y métricas, apagado ordenado, logs	Un bot de soporte empaquetado como proyecto pequeño con Dockerfile
Resumen diario programado	Avanzado	Scheduler, Broadcast, Zonas horarias	Scheduler durable, zonas horarias, `bot.broadcast`, altas y bajas con `ctx.user`	Un resumen a las 08:00 en la zona horaria del bot, una vez al día aunque haya reinicios
Probar tu bot	Avanzado	Testing, Vitest, Transcripciones doradas	`createTestBot`, `expectReply`, transcripciones doradas, reproducción	Un archivo de Vitest completo que graba y reproduce una conversación
Crear un plugin: FAQ con herramientas	Avanzado	Plugins, Inyección de dependencias	`definePlugin`, `install`/`uninstall`, `ctx.onDispose`, `provide`	Un plugin de FAQ reutilizable que comparte sus contadores como herramienta

Cobertura de funcionalidades

Qué ejemplos muestran cada funcionalidad principal. Todos los ejemplos corren también en el simulador de la terminal y, salvo el servidor de webhooks de la Cloud API, en WhatsApp (Baileys) y Telegram con el mismo código del bot.

Funcionalidad	Ejemplos
Flujos (DSL `flow()`)	Flujo de registro, Bot de menú, Flujo de compra, Reserva de citas, Enrutador con IA, Probar tu bot, Webhooks de la Cloud API
Preguntas, menús y formularios (`ask`, `choose`, `form`)	Flujo de registro, Bot de menú, Flujo de compra, Soporte con timeout, Reserva de citas, Seguimiento de pedidos
Triggers y comandos	Bot de saludo, Bot de FAQ, Enviar mensajes, Bot de grupo, Plugin de FAQ
Media (enviar y recibir)	Respuestas con media
Encuestas	Bot de encuestas
Botones	Bot de menú, Asistente de citas con IA
Hooks	Rate limiter, Bot multi-idioma
Plugins	Rate limiter, Plugin de FAQ
i18n	Bot multi-idioma
Datos de usuario (`ctx.user`)	Seguimiento de pedidos, Reserva de citas, Resumen diario, WhatsApp y Telegram
Handoff humano	Handoff humano, IA con escalado a humano
Grupos	Bot de grupo
Scheduler	Bot de recordatorios, Resumen diario, Handoff humano
Broadcast	Resumen diario
Stores	Reserva de citas, Seguimiento de pedidos, WhatsApp y Telegram, Bot listo para producción, Resumen diario
Durabilidad	Bot listo para producción
Multicanal (un bot, varios providers)	WhatsApp y Telegram
Webhooks y WhatsApp Cloud API	Webhooks de la Cloud API
Telegram	WhatsApp y Telegram, IA en streaming, Bot de grupo, Bot multi-idioma
Chat con IA	Asistente de FAQ con IA, IA con tus preguntas frecuentes, Enrutador con IA
Herramientas de IA con confirmación	Asistente de citas con IA, IA con escalado a humano
Historial de IA y RAG	IA con tus preguntas frecuentes, Asistente de FAQ con IA, Enrutador con IA
Streaming de IA	IA en streaming
Testing	Probar tu bot, IA en streaming
Simulador en la terminal (`npx botmesh dev`)	Bot de saludo, Bot de encuestas, Probar tu bot

Salvo el servidor de webhooks de la Cloud API, el código de cada ejemplo es el mismo en WhatsApp (Baileys) y Telegram: solo cambia el provider. Cuando un canal muestra algo distinto (botones, stickers), la página del ejemplo lo dice, y la matriz de capacidades da los detalles.

​Ejecutar cualquier ejemplo

​Principiante

​Intermedio

​IA

​Avanzado

​Cobertura de funcionalidades

Ejecutar cualquier ejemplo

Principiante

Intermedio

IA

Avanzado

Cobertura de funcionalidades