Asistente de citas con IA y herramientas

npm install @botmesh/core @botmesh/ai @anthropic-ai/sdk @botmesh/baileys

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

// Catálogo y agenda. En producción, léelos de tu base de datos.
const SERVICIOS = {
  corte: { nombre: 'Corte de pelo', precio: 25 },
  barba: { nombre: 'Arreglo de barba', precio: 15 },
  tinte: { nombre: 'Tinte', precio: 60 },
}
const HORARIOS = ['lun 10:00', 'lun 15:00', 'mar 11:00', 'mié 17:30']

const citas = [] // en memoria para el ejemplo; en producción usa tu base de datos
const estaLibre = (horario) => !citas.some((c) => c.horario === horario && c.estado === 'reservada')
const citasDe = (chat) => citas.filter((c) => c.chat === chat && c.estado === 'reservada')
const vista = ({ id, servicio, horario }) => ({ id, servicio: SERVICIOS[servicio].nombre, horario, precio: SERVICIOS[servicio].precio })

// `enum` rechaza un servicio o una hora inventados antes de preguntar nada al cliente.
const RESERVA = {
  type: 'object',
  properties: {
    servicio: { type: 'string', enum: Object.keys(SERVICIOS) },
    horario: { type: 'string', enum: HORARIOS },
  },
  required: ['servicio', 'horario'],
  additionalProperties: false,
}

const tools = {
  // Las herramientas de solo lectura corren sin confirmación.
  consultar_disponibilidad: {
    description: 'Lista los servicios con su precio y los horarios libres.',
    handler: () => ({
      servicios: Object.entries(SERVICIOS).map(([clave, s]) => ({ clave, nombre: s.nombre, precio: s.precio })),
      libres: HORARIOS.filter(estaLibre),
    }),
  },
  mis_citas: {
    description: 'Lista las citas reservadas del cliente con su id.',
    handler: (_args, { ctx }) => citasDe(ctx?.from).map(vista),
  },
  // Herramientas con efectos: el cliente confirma antes.
  reservar_cita: {
    title: 'Reservar cita',
    description: 'Reserva un servicio en un horario libre.',
    schema: RESERVA,
    confirm: true,
    dedupe: 'args', // la misma reserva nunca se hace dos veces seguidas
    // La confirmación muestra lo que calcula TU código, nunca un precio escrito por el modelo.
    confirmLines: ({ servicio, horario }) => [`• ${SERVICIOS[servicio].nombre}, ${horario}`, `Precio: $${SERVICIOS[servicio].precio}`],
    handler: ({ servicio, horario }, { ctx }) => {
      if (!estaLibre(horario)) return { error: `${horario} ya está ocupado. Consulta consultar_disponibilidad.` }
      const cita = { id: `C-${citas.length + 1}`, chat: ctx?.from, servicio, horario, estado: 'reservada' }
      citas.push(cita)
      return vista(cita)
    },
  },
  cancelar_cita: {
    title: 'Cancelar cita',
    description: 'Cancela una cita reservada por su id (de mis_citas).',
    schema: { type: 'object', properties: { id: { type: 'string' } }, required: ['id'] },
    confirm: true,
    confirmLines: ({ id }) => [`• Cita ${id}`],
    handler: ({ id }, { ctx }) => {
      const cita = citasDe(ctx?.from).find((c) => c.id === id)
      if (!cita) return { error: `No hay ninguna cita reservada ${id}. Consulta mis_citas.` }
      cita.estado = 'cancelada'
      return { id, estado: 'cancelada' }
    },
  },
}

const PERSONA = [
  'Eres el asistente de reservas de la barbería Fade & Co.',
  'Usa consultar_disponibilidad para servicios, precios y horarios libres: nunca los inventes.',
  'Reserva, lista y cancela citas solo con las herramientas. Responde en pocas palabras.',
].join(' ')

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

  bot.plug(slashCommandsPlugin, {
    greeting: '💈 ¡Hola! Soy el asistente de reservas de Fade & Co. Pídeme una cita, tus reservas o una cancelación.',
  })

  bot.plug(aiPlugin({
    provider: 'anthropic',
    apiKey: process.env.ANTHROPIC_API_KEY,
    model: 'claude-sonnet-5-5',
    persona: PERSONA,
    tools,
    maxSteps: 4, // como mucho 4 llamadas al modelo por mensaje del cliente
  }))

  // Registro de auditoría: cada herramienta ejecutada (los argumentos pueden tener datos personales).
  bot.on('ai.tool', (e) => {
    if (e.type === 'tool.result') bot.logger.info({ tool: e.tool, ms: e.durationMs }, 'ai tool ran')
  })

  return bot
})

export default createBot

// `node bot.js` conecta con WhatsApp; `npx botmesh dev bot.js` se salta este bloque.
if (isMainModule(import.meta)) {
  const bot = await createBot(new BaileysProvider({ session: 'citas-bot' }))
  bot.on('ready', () => console.log('✅ Conectado'))
  await bot.start()
}

npx botmesh dev bot.js --env-file .env   # .env tiene la línea ANTHROPIC_API_KEY=sk-ant-...

user › ¡hola! ¿me das un corte de pelo el lunes?
bot › ¡Claro! Un corte de pelo cuesta $25. El lunes tengo libres las 10:00 y las 15:00. ¿Cuál te va mejor?
user › a las 15:00, por favor
bot › Voy a: Reservar cita
      • Corte de pelo, lun 15:00
      Precio: $25
      ¿Confirmas?
        [1] Sí
        [2] No
      (:click <n> to choose)
user › sí
bot › ¡Listo! Tu corte quedó reservado para el lun 15:00 (cita C-1). ¡Te esperamos! 💈
user › sí, resérvame el corte a las 15:00
bot › Esa cita ya está reservada (C-1, lun 15:00), así que no la reservé dos veces.
user › mejor cancélala
bot › Voy a: Cancelar cita
      • Cita C-1
      ¿Confirmas?
        [1] Sí
        [2] No
      (:click <n> to choose)
user › no
bot › De acuerdo, mantengo tu cita del lun 15:00.