Inicio rápido

npm create botmesh my-bot                                # pregunta la plantilla
npm create botmesh my-bot -- --template telegram --yes   # o elígela de entrada
cd my-bot
npm install
npm run dev     # chatea con el bot en la terminal (sin teléfono ni credenciales)

npm start

mkdir my-bot && cd my-bot
npm init -y
npm pkg set type=module        # botmesh es solo ESM
npm install @botmesh/core @botmesh/baileys

// bot.js
import { Bot, defineBot, flow, isMainModule, slashCommandsPlugin } from '@botmesh/core'
import { BaileysProvider } from '@botmesh/baileys'

const createBot = defineBot((provider) => {
  const bot = new Bot({ provider, lang: 'es' })

  // Comandos integrados: /start /help /reset /cancel /id /ping
  bot.plug(slashCommandsPlugin)

  bot.when('hola', (ctx) => ctx.reply('👋 ¡Hola! Envía "registro" para probar un flujo.'))

  bot.use(
    flow('registro')
      .ask('¿Cómo te llamas?', 'name')
      .say((_ctx, c) => `¡Encantado, ${c.state.name}!`),
  )

  // Solo se ejecuta si nada de lo anterior manejó el mensaje
  bot.onMessage((ctx) => ctx.reply('Envía "hola", "registro" o /help.'))

  return bot
})

export default createBot

// `node bot.js` conecta con WhatsApp; `botmesh dev` se salta este bloque.
if (isMainModule(import.meta)) {
  const bot = await createBot(new BaileysProvider({ session: 'my-bot' }))
  bot.on('ready', () => console.log('✅ Conectado. Envía "hola" desde otro teléfono.'))
  await bot.start()
}

npx botmesh dev bot.js      # pnpm: pnpm exec botmesh dev bot.js

user › hola
bot › 👋 ¡Hola! Envía "registro" para probar un flujo.
user › registro
bot › ¿Cómo te llamas?
user › Ana
bot › ¡Encantado, Ana!

node bot.js

// bot.js: inicio del archivo
import { Bot, defineBot, flow, isMainModule, slashCommandsPlugin } from '@botmesh/core'
import { TelegramProvider } from '@botmesh/telegram' // en lugar de @botmesh/baileys

// ... createBot y export default igual que en el paso 2 ...

// final del archivo
if (isMainModule(import.meta)) {
  const bot = await createBot(new TelegramProvider({ token: process.env.TELEGRAM_TOKEN ?? '' }))
  bot.on('ready', () => console.log('✅ Conectado. Escribe "hola" a tu bot.'))
  await bot.start()
}

TELEGRAM_TOKEN=123456:ABC-tu-token

node --env-file=.env bot.js

import { CloudAPIProvider } from '@botmesh/meta'

const provider = new CloudAPIProvider({
  accessToken: process.env.META_TOKEN ?? '',
  phoneNumberId: process.env.META_PHONE_ID ?? '',
  verifyToken: process.env.META_VERIFY_TOKEN ?? '',
  appSecret: process.env.META_APP_SECRET, // obligatorio: verifica X-Hub-Signature-256
})