IPFlow Docs
Integraciones (Tools)

[Avanzado] Integración con n8n

Dispara flujos de trabajo hiper-complejos (Webhooks) desde el cerebro de la IA.

Integración con n8n (Webhooks)

Antes de empezar
Necesitás tener al menos un agente creado y funcionando. Si aún no lo hiciste, seguí la guía de tu primer agente.

IPFlow es un director de orquesta excelente para conversaciones, pero a veces necesitas interactuar con el ERP de tu empresa, crear una factura en Stripe, y luego guardar un registro en Google Sheets.

Para orquestaciones de software tan complejas, utilizamos n8n (o herramientas similares como Zapier/Make).


El Puente entre IPFlow y n8n

Tienes dos formas de hacer que IPFlow se comunique con n8n:

1. El Método Invisible (Etiquetas / Labels)

Esta es la forma más común y segura. No requiere activar ninguna herramienta en el agente.

  1. Creas un Webhook en Chatwoot (o directamente en n8n) que escuche "Cada vez que se agregue una etiqueta a una conversación".
  2. En IPFlow, le dices al agente en su Prompt: "Si el cliente confirma la compra, asígnale la etiqueta compra_lista".
  3. La IA asigna la etiqueta en Chatwoot -> Chatwoot envía la señal a n8n -> n8n ejecuta el flujo para cobrar.

Ventaja: Si n8n se cae, el agente no se crashea, simplemente la etiqueta queda puesta a la espera de ser procesada.

2. El Método de Herramienta Directa (Webhooks Tool)

Si necesitas que la IA espere una respuesta de n8n para seguir hablando, debes usar el Webhook Tool de IPFlow.

Por ejemplo, si un cliente dice "¿Cuál es el estatus de mi pedido #1234?":

  1. La IA ejecuta la Herramienta "Consultar Pedido" enviando el número 1234 al Webhook de n8n.
  2. La conversación se pausa (1-3 segundos).
  3. n8n busca en tu base de datos de envíos, y responde: {"estado": "En tránsito", "fecha": "Mañana"}.
  4. La IA recibe ese paquete de datos, lo lee, y le escribe al cliente: "Hola, revisé tu pedido y me figura que está en tránsito. Te llega mañana."

Configuración del Webhook Tool

  1. Crea tu flujo en n8n empezando con un nodo Webhook. Copia la URL de prueba (Test URL).
  2. Asegúrate de que el nodo final de tu flujo en n8n sea una respuesta Webhook válida en formato JSON.
  3. Ve a IPFlow > Configuración del Agente > Integraciones > Custom Webhooks.
  4. Agrega la URL y dale una descripción clara para que la IA sepa qué hace ese webhook (Ej. "Utiliza esto para buscar pedidos de clientes en la base de datos usando su DNI o Número de Orden").
Tiempo Límite (Timeout)

Si vas a usar a n8n como una herramienta directa, tu flujo de n8n debe responder en menos de 10 segundos. Si el flujo es muy pesado y tarda más, la IA de IPFlow asumirá que el sistema falló y le dirá al cliente que hubo un error de conexión. Para procesos lentos, usa el método de Etiquetas.