{"id":261,"date":"2026-10-22T13:57:14","date_gmt":"2026-10-22T11:57:14","guid":{"rendered":"https:\/\/n8nfacil.com\/?p=261"},"modified":"2026-11-02T18:50:06","modified_gmt":"2026-11-02T17:50:06","slug":"webhook-n8n-formulario","status":"publish","type":"post","link":"https:\/\/n8nfacil.com\/en\/webhook-n8n-formulario\/","title":{"rendered":"Webhook en n8n: recibe un formulario y responde con \u00e9xito o error"},"content":{"rendered":"

Probado:<\/strong> n8n 2.44.5, 22 de octubre de 2026. Proyectos con datos ficticios.<\/p>

Un webhook permite que una petici\u00f3n entrante inicie un workflow. En este proyecto recibiremos nombre y email, quitaremos los espacios y responderemos con un JSON. Si falta un campo, devolveremos un error 400 en lugar de aceptar silenciosamente datos incompletos.<\/p>

Qu\u00e9 necesitas y qu\u00e9 vamos a probar<\/h2>

Necesitas n8n local y el proyecto 06-webhook-formulario.json. Trabajaremos con una petici\u00f3n de prueba, sin conectar un formulario p\u00fablico ni guardar datos de personas reales. El nombre y el correo del ejemplo son ficticios.<\/p>

El recorrido es Recibir formulario \u2192 Preparar campos \u2192 Campos completos. La condici\u00f3n conduce a Responder aceptado o Responder incompleto. Los dos \u00faltimos nodos controlan tanto el cuerpo de la respuesta como el c\u00f3digo HTTP.<\/p>

1. Importa y revisa el Webhook<\/h2>

Descomprime el ZIP e importa el JSON en un workflow nuevo. En Recibir formulario el m\u00e9todo es POST y la ruta es n8nfacil-formulario-demo. El modo de respuesta utiliza un nodo Respond to Webhook. Eso permite tomar una decisi\u00f3n antes de contestar.<\/p>

n8n distingue URL de prueba y URL de producci\u00f3n. Para esta gu\u00eda utiliza Test URL y pulsa Execute workflow en el lienzo para ejecutar el recorrido completo. Listen for test event dentro del nodo permite recoger solo la entrada del disparador; no equivale a probar las respuestas de los nodos finales. La URL de prueba solo funciona mientras n8n espera ese evento. No publiques el workflow para hacer este ensayo.<\/p>

2. Env\u00eda datos ficticios<\/h2>

Con n8n esperando, env\u00eda un POST a http:\/\/localhost:5678\/webhook-test\/n8nfacil-formulario-demo con Content-Type application\/json y este cuerpo: {\"nombre\":\" Ana \",\"email\":\" ANA@EXAMPLE.COM \"}<\/code>.<\/p>

En Windows puedes abrir PowerShell y ejecutar el comando incluido m\u00e1s abajo. Guarda el resultado para compararlo con la salida del workflow. Cada nueva prueba puede requerir volver a activar la escucha del webhook de prueba.<\/p>

$datos = @{ nombre = '  Ana  '; email = '  ANA@EXAMPLE.COM  ' } | ConvertTo-Json\nInvoke-RestMethod -Method Post -Uri 'http:\/\/localhost:5678\/webhook-test\/n8nfacil-formulario-demo' -ContentType 'application\/json' -Body $datos<\/code><\/pre>
Esto es una simulaci\u00f3n del env\u00edo de un formulario. Si conectas despu\u00e9s un formulario HTML con otro formato de contenido, comprueba c\u00f3mo llega su cuerpo: no des por hecho que tendr\u00e1 exactamente la misma estructura.<\/p>
3. Normaliza sin asumir el tipo de entrada<\/h2>
El nodo Preparar campos lee $json.body.nombre y $json.body.email. Solo aplica trim a valores de tipo texto; si falta el campo o llega otro tipo, produce un texto vac\u00edo. El email adem\u00e1s pasa a min\u00fasculas.<\/p>
Esta comprobaci\u00f3n evita llamar a trim sobre un dato inexistente. No valida que la direcci\u00f3n de correo exista ni que su formato sea correcto. La condici\u00f3n de este proyecto \u00fanicamente exige dos textos no vac\u00edos despu\u00e9s de limpiarlos.<\/p>
4. Devuelve una respuesta coherente<\/h2>
Campos completos comprueba que nombre y email tienen longitud mayor que cero. La rama verdadera llega a Responder aceptado, que devuelve HTTP 200 y {\"ok\":true,\"nombre\":\"Ana\",\"email\":\"ana@example.com\"}<\/code> para la entrada inicial.<\/p>
La rama falsa usa Responder incompleto y devuelve HTTP 400 con {\"ok\":false,\"error\":\"nombre y email son obligatorios\"}<\/code>. El c\u00f3digo permite que quien env\u00eda el formulario distinga un dato incompleto de una respuesta correcta sin interpretar un texto ambiguo.<\/p>
5. Prueba tambi\u00e9n el caso incompleto<\/h2>
Vuelve a activar la escucha y env\u00eda solo {\"nombre\":\"Ana\"}<\/code>. Esperamos la rama falsa y el c\u00f3digo 400. PowerShell puede presentar ese estado como un error de la petici\u00f3n: es el comportamiento esperado de esta prueba, no significa necesariamente que n8n haya fallado.<\/p>
Repite con nombre vac\u00edo o espacios si quieres ampliar el ensayo. Revisa siempre la \u00faltima ejecuci\u00f3n. Una captura verde de la prueba anterior no demuestra que la petici\u00f3n actual haya recorrido el mismo camino.<\/p>
Localhost y producci\u00f3n no son lo mismo<\/h2>
Localhost significa el propio equipo desde el que se hace la petici\u00f3n. Una web alojada en Internet no llega a tu n8n local usando esa direcci\u00f3n. Para una integraci\u00f3n real necesitar\u00e1s una URL accesible y una configuraci\u00f3n adecuada de HTTPS, autenticaci\u00f3n, validaci\u00f3n y l\u00edmites. Este tutorial no expone tu contenedor a Internet.<\/p>
Errores frecuentes y siguiente paso<\/h2>
Un 404 en la URL de prueba suele requerir revisar la ruta, el m\u00e9todo POST y si la escucha est\u00e1 activa. Si no llega una respuesta, comprueba el modo de respuesta del Webhook y las conexiones hacia los nodos Respond to Webhook. Una integraci\u00f3n posterior con Google Sheets debe a\u00f1adir sus propias reglas de validaci\u00f3n y tratamiento de duplicados.<\/p>
Fuentes de referencia: https:\/\/docs.n8n.io\/integrations\/builtin\/core-nodes\/n8n-nodes-base.webhook\/<\/a> y https:\/\/docs.n8n.io\/integrations\/builtin\/core-nodes\/n8n-nodes-base.respondtowebhook\/<\/a><\/p>
Capturas de las pruebas reales<\/h2>
\"Cuerpo
Cuerpo JSON ficticio recibido por el Webhook de prueba.<\/figcaption><\/figure>
\"Recorrido
Recorrido del formulario completo hacia la respuesta aceptada.<\/figcaption><\/figure>
\"Recorrido
Recorrido del formulario sin email hacia la respuesta de error.<\/figcaption><\/figure>
Descargar el proyecto<\/h2>
Descargar workflow en ZIP<\/a>. Descomprime e importa el JSON en un workflow nuevo. El archivo no contiene credenciales.<\/p>
Instalar n8n en Windows con Docker<\/a> \u00b7 Limpiar datos con Edit Fields<\/a> \u00b7 Practicar condiciones con IF<\/a><\/p>
Contin\u00faa aprendiendo<\/h2>
C\u00f3mo importar y exportar workflows en n8n sin perderte con el JSON<\/a> \u00b7 HTTP Request en n8n: consulta una API y selecciona los datos que necesitas<\/a><\/p>
Construye este workflow desde cero<\/h2>
Puedes crear los nodos manualmente en lugar de importar el ZIP. Los ajustes siguientes corresponden al archivo del proyecto y a la versi\u00f3n indicada al comienzo de la gu\u00eda; los nombres de los controles pueden variar en otras versiones.<\/p>
Recibir formulario \u00b7 Webhook<\/h3>
M\u00e9todo POST, Path n8nfacil-formulario-demo y respuesta mediante Respond to Webhook. Usa la Test URL y pulsa Listen for test event antes de enviar la petici\u00f3n.<\/p>
Preparar campos \u00b7 Edit Fields (Set)<\/h3>
A\u00f1ade Edit Fields (Set) y selecciona Manual Mapping. Crea los siguientes campos; utiliza Fixed para valores literales y Expression para f\u00f3rmulas. Conserva solo los campos configurados para reproducir la salida del proyecto.<\/p>
Campo<\/th>Tipo<\/th>Modo<\/th>Valor<\/th><\/tr><\/thead>
nombre<\/td>string<\/td>Expression<\/td>{{ typeof $json.body?.nombre === "string" ? $json.body.nombre.trim() : "" }}<\/code><\/td><\/tr>
email<\/td>string<\/td>Expression<\/td>{{ typeof $json.body?.email === "string" ? $json.body.email.trim().toLowerCase() : "" }}<\/code><\/td><\/tr><\/tbody><\/table><\/figure>
Las comillas de los valores de texto de la tabla indican que son cadenas: no las escribas en el campo Fixed. Conserva los espacios cuando formen parte de los datos de prueba.<\/p>
Campos completos \u00b7 IF<\/h3>
Configura las condiciones de la tabla del tutorial. Mant\u00e9n el tipo correcto del valor y conecta las salidas true y false a sus nodos de resultado.<\/p>
Responder aceptado \u00b7 Respond to Webhook<\/h3>
Selecciona Respond With: JSON. Introduce el cuerpo como expresi\u00f3n y configura el c\u00f3digo HTTP en Options \u2192 Response Code.<\/p>
{{ { ok: true, nombre: $json.nombre, email: $json.email } }}<\/code><\/pre>
C\u00f3digo HTTP: 200.<\/p>
Responder incompleto \u00b7 Respond to Webhook<\/h3>
Selecciona Respond With: JSON. Introduce el cuerpo como expresi\u00f3n y configura el c\u00f3digo HTTP en Options \u2192 Response Code.<\/p>
{{ { ok: false, error: "nombre y email son obligatorios" } }}<\/code><\/pre>
C\u00f3digo HTTP: 400.<\/p>
Conecta los nodos y revisa el recorrido<\/h3>