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 y confirma. 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 "chequee antes".
3. Una verdad operativa, muchas vistas. Una tarea es un solo objeto; la ves en Hoy, en lista, en calendario o en el mapa.
4. API primero. El panel, el bot, el MCP y Wagy usan los mismos servicios. Si algo no se puede hacer por API, falta en la API.
5. La credencial define el negocio. Una clave o sesión siempre pertenece a un proyecto.

Arquitectura

Canales:    WhatsApp · Chat web · Telegram · Panel · Wagy · API · MCP
                 │
Gateway:    credencial → proyecto · permisos · límites · pausas · webhooks firmados
                 │
Núcleo:     conversaciones + IA │ motor de agenda y tareas │ flujos │ conocimiento
                 │
Datos:      PostgreSQL (seguridad por fila, constraints de exclusión) · Redis
Externos:   modelos de IA · transcripción de audio · proveedores de canal · mapas

La vida de un mensaje

1. Llega. El canal (WhatsApp, chat web o Telegram) entrega el mensaje. Se verifica la firma o la clave, se descartan duplicados y se guarda en el Inbox. Si el canal está pausado, se aplica la pausa antes de hacer nada más.
2. Se entiende. Los audios se transcriben. Se identifica al cliente (un cliente puede tener varias identidades: teléfono, Telegram) y la conversación. Si una persona tomó el control, el bot no responde. Las reglas del canal (por ejemplo pedir teléfono y email en el chat web) se aplican antes de llamar a la IA.
3. La IA pide. El modelo recibe el contexto del negocio, la fecha y hora locales y los últimos mensajes. Solo puede llamar herramientas: buscar horarios, pre-reservar, confirmar, consultar el conocimiento, guardar una ubicación compartida o derivar a una persona.
4. El motor decide. Cada llamada se valida contra las reglas del negocio y recién después se ejecuta. Si algo cambió, el motor devuelve alternativas y la IA vuelve a preguntar.
5. Respuesta exacta. Fechas, horas, servicios, precios y direcciones salen de plantillas completadas con el resultado real.
6. Trabajo y eventos. La reserva es una tarea con etapas. Cada cambio de etapa o acción genera eventos que disparan flujos, avisos al equipo (por Telegram o WhatsApp) y webhooks.

Tareas, etapas y acciones

Cada negocio define las etapas por las que pasa su trabajo y las acciones que mueven una tarea de una a otra (tomar, soltar, completar, "no estaba"). Una acción puede tener efectos: asignar a quien la ejecuta, liberar, cerrar con un resultado. Mirá Trabajo y acciones.

Flujos

Un flujo dice "cuando pase esto, si se cumple esta condición, hacé aquello": enviar un mensaje, avisar al equipo, esperar, ejecutar una acción. Las condiciones son expresiones simples sobre la tarea, el cliente o la hora.

Seguridad

Cada negocio está aislado en la propia base de datos, los secretos van cifrados y cada cambio queda en un registro de auditoría. Vos sos el responsable de los datos de tus clientes; Fiuit los trata en tu nombre.

A dónde seguir

• Reservas y pre-reservas: las garantías de la agenda.
• Bot y IA: qué puede y qué no puede hacer el asistente.