Cómo funciona

Principios

1. Núcleo determinístico, IA como intérprete. La IA entiende al cliente y llama herramientas. El motor calcula disponibilidad, pre-reserva, confirma y cobra. La IA nunca inventa un horario ni un precio.
2. La base de datos garantiza las reglas. El sobreturno es imposible porque PostgreSQL rechaza asignaciones superpuestas, no porque la app "chequea antes".
3. API primero. Panel, página de reserva, bot de WhatsApp y MCP usan los mismos servicios. Si algo no se puede hacer por API, falta en la API.
4. La credencial define el negocio. Una clave o sesión siempre pertenece a un workspace.

Arquitectura

Canales:    WhatsApp · Página de reserva · Panel · REST / MCP
                 │
Gateway:    credencial → workspace · scopes · límites · webhooks firmados
                 │
Núcleo:     conversaciones + IA │ motor de agenda │ automatizaciones │ pagos │ conocimiento
                 │
Datos:      PostgreSQL (seguridad por fila, constraints de exclusión, jobs) · Redis
Externos:   modelos de IA (OpenRouter) · transcripción de audio · proveedor de WhatsApp · Pix

La vida de un mensaje

1. Llega. El proveedor de WhatsApp llama a nuestro webhook. Verificamos la firma HMAC, descartamos duplicados por id de mensaje y lo guardamos. Respondemos en menos de 200 ms.
2. Se entiende. Los audios se transcriben. Identificamos cliente y conversación. Si una persona tomó el control, el bot no responde.
3. La IA pide. El modelo recibe el contexto del negocio, la fecha y hora locales, un estado estructurado de la conversación y los últimos mensajes. Solo puede llamar herramientas como find_slots, hold_slot o confirm_hold.
4. El motor decide. Cada llamada se valida contra un schema estricto y las reglas del negocio, y después se ejecuta. Los errores vuelven como datos estructurados (por ejemplo slot_taken con alternativas) para que la IA vuelva a preguntar.
5. Respuesta exacta. Fechas, horas, servicios, precios y direcciones salen de plantillas completadas con el resultado real.
6. Eventos. booking.confirmed y compañía disparan automatizaciones (recordatorios) y tus webhooks.

A dónde seguir

• Reservas y pre-reservas explica las garantías.
• WhatsApp e IA explica qué puede y qué no puede hacer la IA.