Cómo usar n8n: crea, prueba y publica tu primer flujo con Webhook
Aprende a usar n8n creando un endpoint de saludo con Webhook, Edit Fields y Respond to Webhook: pruébalo, publícalo, depúralo y compártelo con tu equipo.
Comprobado con la documentación de n8n el .
Cómo usar n8n: qué vas a crear y qué necesitas
La forma más rápida de aprender a usar n8n es construir algo pequeño. En este tutorial crearás un endpoint similar a una API: alguien envía una petición a una dirección web y tu flujo devuelve un saludo corto. Usa tres nodos: Webhook, Edit Fields (Set) y Respond to Webhook. Después lo pruebas, lo publicas y lo preparas para un equipo.
Una duda habitual de quien empieza es qué es en la práctica un flujo de n8n, y el significado del término es sencillo. Es una cadena de nodos. Un disparador inicia una ejecución, los nodos intermedios dan forma a los datos y un nodo final hace algo con ellos. Aquí el disparador es una petición HTTP entrante y el resultado vuelve a quien la envió.
Necesitas una instancia de n8n, ya sea n8n Cloud o autoalojada. La documentación de n8n indica que, si te autoalojas en localhost, tienes que ejecutar n8n en modo túnel antes de que el nodo Webhook pueda recibir peticiones. Este tutorial no cubre los comandos del túnel; consúltalos en la documentación de autoalojamiento de n8n. También necesitarás un terminal con curl, u otro cliente HTTP, para enviar peticiones de prueba.
Un apunte antes de empezar: estos pasos proceden de la documentación oficial de n8n. No se han probado de primera mano para este artículo.
Sources: Workflow development | Nodes | n8n Docs, Common issues | Nodes | n8n Docs
Pasos 1-3: construye la cadena Webhook, Edit Fields y Respond to Webhook
Aprender a usar n8n empieza por construir el flujo en orden, desde el disparador, que aquí es el nodo Webhook que inicia el flujo. La configuración de credenciales para las opciones de autenticación del nodo Webhook se explica en otra página de la documentación.
El paso de Edit Fields viene con una advertencia. La receta documentada de Edit Fields para esto usa el modo de respuesta When Last Node Finishes, no Respond to Webhook. Los pasos siguientes aplican la misma configuración de campos a este flujo, así que trátalo como una sugerencia y comprueba el resultado al probar.
- Añade un nodo Webhook y elige una opción de autenticación (Basic, Header, JWT o ninguna).
- En el nodo Webhook, configura Respond como Using Respond to Webhook node.
- Conecta un nodo Edit Fields (Set). Añade un campo String con un nombre y un valor de saludo, y activa Keep Only Set.
- Conecta un nodo Respond to Webhook al final. Se ejecuta una vez, con el primer elemento entrante.
Sources: Webhook | Nodes | n8n Docs, Respond to Webhook | Nodes | n8n Docs, Common issues | Nodes | n8n Docs
Pasos 4-5: prueba con la URL de test y luego publica
Empieza con la URL de prueba y publica solo cuando recibas la respuesta que esperas. El diagrama muestra el orden que debes seguir.
De la petición de prueba al endpoint en vivo
- Escuchar: Selecciona Listen for test event en el nodo Webhook.
- Enviar: Llama a la URL de prueba con curl dentro de la ventana de 120 segundos.
- Comprobar: Confirma que vuelve el saludo y que los datos aparecen en el editor.
- Publicar: Guarda y publica el flujo para que n8n registre el webhook de producción.
- Monitorizar: Llama a la URL de producción y revisa las ejecuciones en la pestaña Executions.
Parte de aprender a usar n8n es saber que los datos de producción no aparecen en el editor, así que revisa la pestaña Executions para ver las ejecuciones en vivo. Si van a llamar al endpoint personas ajenas a tu equipo, sugerimos activar la opción de autenticación del paso 1 antes de publicar.
Sources: Common issues | Nodes | n8n Docs, Webhook | Nodes | n8n Docs, Workflow development | Nodes | n8n Docs
Solución de problemas habituales con webhooks
La mayoría de los problemas en esta fase se deben a tiempos, errores o tamaño de la petición. La tabla recoge las causas documentadas, con nuestras sugerencias de qué probar.
| Síntoma | Causa probable | Qué probar |
|---|---|---|
| La petición de prueba no se captura | Se cerró la ventana de escucha de 120 segundos | Selecciona Listen for test event de nuevo y reenvía |
| Respuesta HTTP 500 | El flujo falló antes de ejecutar Respond to Webhook | Abre la ejecución fallida y corrige el nodo que dio error |
| HTTP 524 en n8n Cloud | Sin respuesta en 100 segundos (timeout de Cloudflare) | Responde antes o acorta el trabajo previo a la respuesta |
| Petición grande rechazada | Carga útil por encima del límite predeterminado de 16MB | Autoalojado: sube el límite con N8N_PAYLOAD_SIZE_MAX |
Sources: Common issues | Nodes | n8n Docs, Respond to Webhook | Nodes | n8n Docs, Webhook | Nodes | n8n Docs
Cuando un equipo depende de ello: proyectos, roles y credenciales
Según la documentación de n8n, el RBAC y los proyectos están disponibles en todos los planes de n8n Cloud y en las ediciones autoalojadas Registered Community, Business y Enterprise. Los proyectos agrupan flujos y credenciales y dan a cada usuario un rol en cada proyecto. El número de proyectos y roles depende de tu plan.
Sugerimos construir un flujo compartido dentro de un proyecto de equipo y no en un espacio personal. Ten cuidado al mover flujos o credenciales entre proyectos: el traslado elimina todo el uso compartido existente. Un flujo también puede dejar de funcionar si las credenciales que necesita no están disponibles en el nuevo proyecto.
Sources: Organize work in projects | Administer | n8n Docs
