Infraestructura IA Multiagente de Gestión Inmobiliaria con n8n

Resumen del proyecto

Este proyecto es un sistema de backend complejo, sin interfaz de usuario (headless), construido íntegramente sobre la plataforma de automatización de flujos de trabajo n8n. El sistema funciona como el "cerebro" operativo de una plataforma de gestión inmobiliaria: sustituye tareas manuales por automatizaciones inteligentes.

El núcleo es una arquitectura de múltiples agentes de IA, donde cada agente es un conjunto especializado de flujos de trabajo (workflows) en n8n. Un agente "Orquestador" principal recibe todas las peticiones, utiliza IA para comprender la intención del usuario y delega la tarea al agente especialista que corresponde.

El sistema se diseñó con la visión de una plataforma IA SaaS (software como servicio), donde la lógica de n8n gestiona permisos y segrega el acceso a los datos según tres roles clave: Leads (público), Clientes (residentes) y Administradores.

Tecnologías utilizadas

• n8n: la plataforma central para construir, probar y ejecutar todos los flujos de automatización. Se utiliza para la orquestación de agentes, la lógica de negocio y la integración de servicios.

• Modelos de lenguaje (IA): integrados en los flujos de n8n para potenciar a los agentes. Se utilizan para:

  • Procesamiento de intenciones (NLU): en el agente Orquestador, para entender qué quiere el usuario.
  • Ejecución de tareas: en los sub-agentes, para procesar datos o generar respuestas.

• APIs y webhooks: n8n actúa como pegamento central, conectándose a APIs de terceros (CRM, Google Calendar, Supabase) y usando webhooks para recibir y enviar notificaciones en tiempo real.

• Base de datos (Supabase/PostgreSQL): los flujos de n8n se conectan a una base de datos central para realizar operaciones CRUD (crear, leer, actualizar, eliminar) de forma segura.

• Nodos de n8n utilizados:

  • Nodos core: Start, IF, Switch, Merge, Code (para lógica compleja).
  • Nodos de IA: (ej. OpenAI, Mistral) para dotar de inteligencia a los agentes.
  • Nodos de integración: HTTP Request, Webhook, Google Calendar, PostgreSQL/Supabase, Send Email/SMTP.
  • Nodos de tareas: Cron (tareas programadas), Read PDF, Edit Image.

Características del sistema y arquitectura multiagente

La arquitectura se compone de un orquestador central y agentes especialistas, todos implementados como flujos de n8n.

• Agente Orquestador (gateway inteligente):

  • Es el punto de entrada principal (vía webhook o API).
  • Utiliza un nodo de IA para analizar la intención de la solicitud del usuario.
  • Verifica el rol del usuario (Lead, Cliente, Admin) para validar permisos.
  • Enruta la solicitud al flujo de n8n del agente especialista correcto.

• Agentes especialistas (workflows de n8n):

  • 🏢 Agente Ben y Fulcher (gestión): flujos para consultar disponibilidad de unidades, agendar visitas (conectándose al agente CRM) y gestionar contratos y renovaciones (conectándose al agente Ava).
  • 🛠️ Agente Alex (operaciones): flujos que implementan un sistema de tickets de soporte. Permite a los residentes crear y ver sus tickets, y a los admins gestionarlos todos (CRUD completo).
  • ⚡️ Agente Ava (ejecución): flujos de "backend" no conversacionales, disparados por otros agentes. Usa nodos de generación de PDF y envío de email para crear y enviar facturas y contratos automáticamente.
  • 💰 Agente Rico (finanzas): conjunto de flujos seguros, accesibles solo por el rol Admin, para operaciones CRUD sobre balances y datos financieros en la base de datos.
  • 📬 Agente CRM: flujos que se integran con APIs de calendario (agendar visitas/mantenimiento) y contactos (gestionar la base de datos de usuarios).

• Sistema proactivo (webhooks y cron):

  • Nodos Cron de n8n disparan tareas programadas, como el flujo del agente Ava para la facturación mensual automática.
  • Los flujos usan HTTP Request para enviar webhooks a sistemas externos (por ejemplo, notificar a un canal de Slack) cuando ocurren eventos clave (nuevo ticket de soporte, pago registrado).

Beneficios y logros

• Automatización de procesos de negocio (BPA): procesos inmobiliarios complejos automatizados de principio a fin, reduciendo drásticamente la carga de trabajo manual.
• Orquestación de IA (AIOps): un sistema de IA multiagente funcional construido con n8n como plataforma de orquestación central.
• Arquitectura escalable (IA SaaS): el diseño de flujos basado en roles sienta las bases de una plataforma SaaS multi-tenant segura y escalable, con la lógica de negocio y los permisos centralizados en el backend de automatización.
• Eficiencia de desarrollo: el enfoque "low-code" de n8n permitió construir un backend complejo de forma rápida y eficiente, centrando el esfuerzo en la lógica de integración y de negocio.

Soluciones relacionadas

• Agente telefónico con IA para inmobiliarias — atender llamadas 24/7, calificar compradores y agendar visitas.
• Automatización para inmobiliarias — capturar los leads de los portales, pasarlos al CRM y precalificarlos con IA.