Definición: un webhook es un aviso automático que una aplicación envía a otra en el momento en que ocurre algo: un formulario enviado, un pedido nuevo, un pago confirmado. Técnicamente es una petición HTTP (normalmente POST, con datos en JSON) a una URL que tú defines. Sirve para conectar herramientas en tiempo real sin que nadie tenga que copiar datos a mano.
Cómo funciona
La diferencia con una API clásica es quién pregunta. Con una API, tu sistema pregunta cada cierto tiempo: “¿hay pedidos nuevos?”. Con un webhook, es la aplicación de origen la que avisa cuando pasa algo. El proceso:
- En la herramienta de origen (formulario, WooCommerce, pasarela de pago, CRM) configuras un evento y una URL de destino.
- Cuando el evento ocurre, envía los datos a esa URL.
- El receptor (un flujo de n8n, tu servidor, otra aplicación) procesa los datos y responde con un código 200 para confirmar que los ha recibido.
- Si no recibe confirmación, muchas herramientas reintentan el envío.
Ejemplo práctico
Imagina una tienda WooCommerce con venta física y online. Cada vez que se crea un pedido, WooCommerce envía un webhook a n8n. El flujo actualiza el stock en otro sistema, registra al cliente en el CRM, envía la compra a la API de conversiones de Meta y avisa por WhatsApp si el pedido supera cierto importe. Todo ocurre en segundos, sin intervención manual. Lo mismo aplica a un formulario de contacto: cada lead llega al CRM al instante.
Errores comunes
- URLs públicas sin protección: cualquiera que conozca la URL podría enviar datos falsos. Usa una clave secreta o verifica la firma que envía el origen.
- No gestionar duplicados: con los reintentos, el mismo evento puede llegar dos veces. Controla un identificador único.
- Procesos lentos antes de responder: si el receptor tarda demasiado, el origen da el envío por fallido. Responde rápido y procesa después.
- Sin registro ni alertas: si el webhook deja de llegar, nadie se entera hasta que falta un pedido o un lead.
- Enviar más datos personales de los necesarios, algo que choca con el RGPD.
Relación con otros términos
El webhook es la pieza que conecta tu web con el CRM y las automatizaciones de n8n, y que permite medir el embudo de conversión completo, del formulario a la venta. Los configuramos a diario en nuestro servicio de automatización con IA y n8n.