Webhooks: qué son y cómo usarlos con n8n para conectar tus herramientas
Qué es un webhook, en qué se diferencian la URL de prueba y la de producción en n8n y cómo responder bien para conectar tu web, tu CRM y tus pagos.
Un cliente paga en tu tienda a las 11 de la noche. A esa hora nadie está mirando el correo, pero el cliente espera su confirmación por WhatsApp y tu equipo necesita verlo en el CRM al día siguiente. Lo que hace que todo eso pase solo, sin que nadie copie datos, casi siempre es un webhook.
¿Qué es un webhook?
Es una dirección web que recibe datos automáticamente en el momento en que algo pasa en otra herramienta. En lugar de que tu sistema pregunte cada cinco minutos “¿hay algo nuevo?”, la otra aplicación te avisa sola: “acaba de entrar un pago”, “se llenó un formulario”, “se creó un lead”.
La documentación de n8n lo explica así: el nodo Webhook recibe datos de apps y servicios cuando ocurre un evento y con eso inicia un flujo. También puede devolver datos al final del flujo, así que funciona casi como una API propia. Si estás empezando, primero lee qué es n8n.
¿Para qué lo usaría en mi negocio?
Para que una herramienta le avise a otra sin intervención humana. Estos son usos frecuentes:
| Evento en una herramienta | Lo que hace el flujo en n8n |
|---|---|
| Un pago aprobado en tu pasarela | Confirma al cliente y actualiza el CRM |
| Un formulario enviado en tu web | Crea el lead y avisa al asesor |
| Un cambio de etapa en el CRM | Envía la siguiente comunicación |
| Una cita agendada | Programa el recordatorio |
La velocidad importa: un lead que recibe respuesta en minutos tiene más opciones de convertirse, como explicamos en responder rápido a tus leads.
¿Qué diferencia hay entre la URL de prueba y la de producción?
Son dos direcciones distintas, y la de producción solo funciona cuando publicas el flujo. Según n8n, la URL de prueba se registra cuando eliges escuchar un evento de prueba o ejecutas el flujo desde el editor, y los datos que llegan se ven ahí mismo. La URL de producción se registra al publicar el flujo, y sus datos no aparecen en el editor: los revisas en la pestaña de ejecuciones.
Error común: pegar la URL de prueba en tu pasarela de pagos o en tu formulario. Funciona mientras tienes el editor abierto y deja de funcionar después. En la herramienta externa siempre va la URL de producción, con el flujo publicado.
¿Qué debo configurar en el nodo Webhook?
El método HTTP, la ruta, la autenticación y la forma de responder. La documentación de n8n indica que el nodo acepta los métodos DELETE, GET, HEAD, PATCH, POST y PUT. La ruta se genera al azar para evitar choques, pero puedes definir una propia, incluso con parámetros como /:variable.
Para la seguridad, el nodo permite autenticación básica, por encabezado o con JWT. El tamaño máximo de cada petición es de 16 MB, y en instalaciones propias se puede cambiar con la variable N8N_PAYLOAD_SIZE_MAX.
Ojo: un webhook sin autenticación recibe datos de cualquiera que conozca la URL. Si el flujo crea registros o envía mensajes, protégelo con alguno de los métodos que ofrece n8n.
¿Cómo respondo a quien llama el webhook?
El nodo Webhook te deja elegir entre responder de inmediato, cuando termina el último nodo o con el nodo Respond to Webhook. Si respondes de inmediato, n8n devuelve el código de respuesta con el mensaje “Workflow got started”. Si esperas al último nodo, devuelve lo que ese nodo produjo.
Con el nodo Respond to Webhook tienes control total: puedes devolver JSON, texto, un archivo, un token JWT, una redirección o nada, y fijar el código de estado y los encabezados. La documentación aclara que, si el flujo falla antes de llegar a ese nodo, se devuelve un error con estado 500. Por eso vale la pena configurar avisos cuando un flujo de n8n falla.
¿Qué cuido antes de ponerlo a trabajar?
Prueba con datos reales, publica el flujo y revisa las ejecuciones los primeros días. Confirma que la herramienta externa tiene la URL de producción, que la autenticación coincide en los dos lados y que sabes dónde ver un error. Si conectas tu web con el CRM, esta pieza encaja con un embudo de captura con página, formulario y agenda.
En resumen
Volviendo al pago de las 11 de la noche: con un webhook bien configurado en n8n, la confirmación sale sola, el CRM se actualiza y tu equipo amanece con todo en orden. La clave está en usar la URL de producción, protegerla y responder bien. Si quieres que conectemos tus herramientas por ti, mira nuestro servicio de automatización con n8n.
Preguntas frecuentes
¿Qué es un webhook en palabras simples?
Es una dirección web que recibe datos automáticamente cuando ocurre un evento en otra aplicación, como un pago aprobado o un lead nuevo, sin que tengas que ir a consultarlo.
¿Por qué mi webhook de n8n funciona en pruebas y no en producción?
Porque son dos URL distintas. Según n8n, la URL de prueba se registra al escuchar un evento de prueba en el editor, y la de producción solo se registra cuando publicas el flujo.
¿Qué tamaño de datos acepta el webhook de n8n?
La documentación de n8n indica un máximo de 16 MB por petición. En instalaciones propias se puede cambiar con la variable N8N_PAYLOAD_SIZE_MAX.
¿Cómo protejo un webhook para que no lo use cualquiera?
El nodo Webhook de n8n permite autenticación básica, por encabezado o con JWT. Si lo dejas sin autenticación, cualquiera que conozca la URL puede enviarle datos.
¿Puedo devolver una respuesta personalizada a quien llama el webhook?
Sí. Con el nodo Respond to Webhook puedes devolver JSON, texto, un archivo, una redirección o ninguna respuesta, con el código de estado que elijas.
No te quedes con la teoría: aplícalo a tu negocio
Implementamos Automatización con n8n de punta a punta, con tu operación real. La primera conversación no tiene costo.
