Cómo Usar Webhooks en n8n: Guía Completa con Ejemplos

Webhooks en n8n es uno de los usos más prácticos de n8n. Los webhooks son uno de los mecanismos más poderosos que ofrece n8n para recibir datos en tiempo real desde cualquier aplicación externa. En esta guía completa aprenderás qué son, cómo configurarlos y cómo usarlos en tus automatizaciones.

¿Qué es un Webhook?

Un webhook es una URL especial que tu workflow de n8n «escucha». Cuando una aplicación externa envía datos a esa URL, tu workflow se activa automáticamente y procesa la información recibida.

La diferencia con el polling (consulta periódica) es que los webhooks son reactivos: n8n solo se activa cuando hay algo nuevo, lo que los hace mucho más eficientes.

¿Cuándo usar Webhooks en n8n?

  • Cuando una aplicación necesita notificar a n8n de un evento (nuevo pago, formulario enviado, etc.)
  • Para integrar aplicaciones que no tienen nodo nativo en n8n
  • Para recibir datos en tiempo real en lugar de consultar cada X minutos
  • En integraciones con Stripe, PayPal, GitHub, Typeform, y cientos más

Tipos de Nodo Webhook en n8n

Webhook (Trigger)

Es el nodo principal. Genera una URL única que activa el workflow cuando recibe una petición HTTP. Soporta métodos GET, POST, PUT, DELETE y HEAD.

Webhook (Respond)

Permite responder a quien hizo la petición al webhook con datos personalizados. Útil para crear APIs simples con n8n.

Cómo Configurar un Webhook en n8n

Paso 1: Agregar el nodo Webhook

En tu canvas, haz clic en «+» y busca «Webhook». Agrégalo como el primer nodo de tu workflow.

Paso 2: Configurar el método HTTP

Selecciona el método HTTP que usará la aplicación que te enviará datos. En la mayoría de casos será POST.

Paso 3: Copiar la URL del Webhook

n8n te genera dos URLs: una de prueba (Test URL) y una de producción (Production URL). Usa la URL de prueba mientras desarrollas el workflow y la de producción cuando lo actives.

Paso 4: Configurar la aplicación externa

Pega la URL del webhook en la configuración de la aplicación que enviará los datos. Por ejemplo, en Typeform lo pegas en «Integrations > Webhooks».

Paso 5: Probar el webhook

Activa el modo de escucha en n8n haciendo clic en «Listen for Test Event» y luego envía datos desde la aplicación externa. n8n capturará los datos y podrás ver su estructura.

Ejemplo Práctico: Webhook con Typeform

Supongamos que quieres guardar en Google Sheets todas las respuestas de un formulario de Typeform. El workflow sería:

  1. Webhook Trigger: Recibe los datos del formulario
  2. Set: Extrae los campos que necesitas (nombre, email, respuestas)
  3. Google Sheets: Agrega una nueva fila con los datos
  4. Send Email: Envía una confirmación al usuario (opcional)

Acceder a los Datos del Webhook

Los datos que llegan al webhook están disponibles en el nodo como items. Puedes acceder a ellos usando expresiones de n8n:

  • {{ $json.body.email }} – Accede al campo «email» del cuerpo de la petición
  • {{ $json.headers['content-type'] }} – Accede a los headers
  • {{ $json.query.page }} – Accede a parámetros de query string

Seguridad en Webhooks

Es importante proteger tus webhooks para que solo las aplicaciones autorizadas puedan activarlos. n8n ofrece varias opciones:

  • Header Auth: Requiere que la aplicación envíe un token en los headers
  • Basic Auth: Autenticación con usuario y contraseña
  • Validación manual: Verificar una firma o token en el cuerpo de la petición

Webhook vs Schedule Trigger: ¿Cuál usar?

Usa Webhook cuando: necesitas reaccionar a eventos en tiempo real, la aplicación soporta webhooks, o los datos llegan de forma irregular.

Usa Schedule Trigger cuando: la aplicación no soporta webhooks, necesitas ejecutar tareas en horarios fijos, o quieres hacer polling a una API.

Conclusión

Los webhooks son fundamentales en n8n para crear automatizaciones reactivas y eficientes. Una vez que los dominas, podrás integrar casi cualquier aplicación con tu instancia de n8n y procesar datos en tiempo real sin polling.