Ir al contenido principal

Workflows de n8n

AI-School puede iniciar workflows de n8n mediante un webhook de producción. Esto es útil cuando quieres activar un proceso automatizado fuera de AI-School, por ejemplo crear una tarea, actualizar un registro CRM, iniciar un flujo de informes o enviar datos de formulario a otro sistema.

Ejemplo: noticia en el sitio web de la escuela​

Supongamos que la escuela ha creado un workflow de n8n que publica una noticia en su sitio WordPress. En AI-School, el usuario solo introduce un texto breve, por ejemplo unas frases sobre una semana de proyectos, una jornada deportiva o una jornada de puertas abiertas. Con ese texto se inicia el workflow en n8n.

Después, el workflow de n8n puede, por ejemplo:

  1. Convertir el texto breve en un borrador cuidado con un nodo LLM y un prompt que encaje con el tono de la escuela.
  2. Crear una ilustración adecuada con un segundo nodo LLM, por ejemplo usando los colores de la escuela y un estilo ilustrativo reconocible.
  3. Preparar o publicar el texto y la imagen como entrada de blog en el sitio WordPress.

Así colaboran AI-School y n8n: en AI-School, el usuario elige el workflow e introduce la información necesaria. n8n ejecuta después los pasos automatizados y se encarga de que la noticia quede correctamente en el sitio web.

¿Qué hace esta integración?​

Inicias un workflow de n8n desde la vista general de workflows. Si el workflow tiene campos, los rellenas primero. Sin campos, el workflow se inicia inmediatamente.

  • Si el workflow no tiene campos, el webhook se activa inmediatamente.
  • Si el workflow tiene campos, primero se abre un diálogo. El usuario completa el formulario y después inicia el workflow con el botón.
  • Los valores introducidos se envían como JSON en una solicitud POST al webhook de n8n.

Crear un workflow de n8n en AI-School​

Un administrador registra el workflow así:

  1. Ve a Asistentes.
  2. Abre Workflows.
  3. Elige Nuevo workflow n8n.
  4. Introduce el nombre del workflow y la URL de producción de n8n.
  5. Configura Header authentication con un nombre de header y un valor secreto.
  6. Opcionalmente añade los campos que deben enviarse en la solicitud POST.
  7. Guarda el workflow.

Campos​

  • Los campos son opcionales.
  • Cada campo tiene un único nombre y un tipo.
  • Los tipos admitidos son texto corto, texto largo, número, sí/no y fecha.
  • Los campos obligatorios deben completarse antes de iniciar el workflow.
  • El nombre del campo se convierte en la clave del cuerpo JSON enviado a n8n.

Crear un workflow compatible en n8n​

  1. Crea un nuevo workflow en n8n.
  2. Añade un Webhook Trigger como primer nodo.
  3. Configura HTTP Method como POST.
  4. Configura Header authentication en n8n. Usa el mismo nombre y valor de header que en la aplicación.
  5. Copia la Production URL del webhook. No uses la URL de prueba.
  6. Activa el workflow en n8n.
  7. Usa el cuerpo JSON recibido en los siguientes nodos de n8n.

Ejemplo de cuerpo JSON​

Si defines campos llamados prompt, customerName y date, n8n recibe un cuerpo JSON como este:

{
  "prompt": "Create a short summary of the request.",
  "customerName": "Example organization",
  "date": "2026-09-22"
}

Limitaciones importantes​

  • Solo se admiten Webhook Triggers.
  • Solo se admiten URLs de webhook de producción.
  • Se rechazan las URLs de prueba con /webhook-test/.
  • Solo se admite POST.
  • Solo se admite generic header authentication.
  • El valor del header se trata como secreto en la aplicación.
  • El tenant se determina en el servidor a partir del usuario conectado, no desde un valor enviado por el navegador.

Solución de problemas​

  • 404 o webhook no registrado: activa el workflow en n8n y usa la URL de producción.
  • Error de autenticación: comprueba que el nombre y el valor del header sean exactamente iguales en ambos sistemas.
  • Datos faltantes: comprueba que los nombres de campos en la aplicación coincidan con las claves que espera n8n.
  • No hay solicitud en n8n: verifica que el workflow empiece con un Webhook Trigger y use POST.
WhatsApp