Cómo funciona

Arquitectura, principios y la vida de un mensaje, desde que llega por un canal hasta que se convierte en una tarea, una acción o un aviso.

Actualizado:

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.

De la entrada a la acción

Entradas → motor → interpretación → acciones. Este es el recorrido de una conversación, no una cadena obligatoria: el panel y la API llaman al motor directamente; los formularios van a una persona. La IA vuelve al motor para validar cada propuesta antes de actuar.

Entradas → Motor Fiuit → IA interpreta → Acciones y salidas

La IA no ejecuta por su cuenta: pide herramientas y el motor valida permisos, disponibilidad y confirmaciones. Las reservas y las tareas comparten una verdad operativa. Los avisos dependen de tus reglas y del canal; el chat web responde durante la conversación, sin recordatorios proactivos. El bot de clientes reserva servicios con horario; las tareas de cola las crea el equipo desde el panel o la API. Creación de entregas en cola por chat: próximamente.

WhatsApp → reserva «¿Tenés turno mañana para corte con Juan?»

Fiuit consulta horarios reales, ofrece opciones y retiene la elegida por 10 minutos. Pide los datos que faltan y confirmación; recién entonces el motor confirma la reserva. Juan la ve en su agenda.

Telegram → reserva con horario «¿Tienen mesa para cuatro mañana a las 20:00?»

Fiuit consulta los horarios del servicio, retiene la opción elegida por 10 minutos y pide los datos y la confirmación. Cuando el cliente confirma, el motor registra la reserva y el equipo la ve en su agenda.

El equipo crea la entrega desde el panel con un servicio de cola, el cliente y la dirección, sin elegir un horario. Después puede asignar, tomar y completar la tarea desde Trabajo. Los avisos dependen de las reglas activadas. Crear entregas en cola automáticamente por chat: próximamente.

La vida de un mensaje

  1. Entra y se ordena. El canal verifica el origen y descarta mensajes repetidos. El motor conserva el contexto en Mensajes y respeta las pausas. Formularios: entrada para atención humana, sin bot automático.
  2. Se respeta el contexto. Se identifica al cliente y la conversación. Si una persona tomó el control, el bot no responde. Las acciones del equipo y la API tienen sus propios permisos y no necesitan pasar por la IA.
  3. La IA interpreta. En los canales conversacionales, el modelo entiende la intención, consulta datos del negocio mediante herramientas y pide lo que falta. El audio se transcribe solo donde el canal lo soporta.
  4. Propuesta y confirmación. El motor comprueba reglas, permisos y disponibilidad. Una opción elegida queda retenida 10 minutos; el cliente confirma antes de convertirla en reserva. Si algo cambió, se ofrecen alternativas.
  5. El motor ejecuta. Las operaciones idempotentes evitan repetir una acción al reintentarla. La base impide reservas superpuestas. Fechas, precios y confirmaciones se comunican con datos reales del sistema, en plantillas.
  6. Trabajo, avisos y diálogo. Una reserva creada por chat o una entrega en cola registrada por el equipo desde el panel aparece como tarea para el equipo. Las reglas activas generan avisos y acciones permitidas. Fiuit también responde consultas y deriva a una persona; no todo mensaje necesita crear una tarea.

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.

Reglas

Una regla 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