# Qué es un webhook y para qué sirve en la práctica Source: https://baqueiro.es/codigo-que-trabaja-por-ti/que-es-un-webhook-y-para-que-sirve/ Published: 2025-04-23T06:56:00+00:00 Updated: 2025-04-23T06:56:00+00:00 Author: Baqueiro Desarrollo Web Language: es Usage: Atribución requerida: se permiten citas con un enlace visible hacia atrás --- **TL;DR** - Un webhook es un aviso automático que un sistema envía a otro cuando ocurre un evento concreto. Es la diferencia entre preguntar sin parar «¿ha pasado algo?» y recibir una llamada cuando pasa. - Es el mecanismo que hay detrás de la mayoría de las automatizaciones entre aplicaciones: un pago completado en Stripe, un pedido nuevo en WooCommerce, un usuario que se registra en tu plataforma. - Entenderlo te ayuda a evaluar con criterio las propuestas de integración y a hacer las preguntas correctas a tus proveedores técnicos. En algún momento de una reunión sobre integración de sistemas o automatización de procesos, alguien dice la palabra webhook. Y hay 2 reacciones: la del técnico, que asiente porque sabe de qué se habla, y la de la directora de operaciones o el responsable de negocio, que también asiente, pero sin tener del todo claro qué es un webhook ni por qué importa. Este artículo es para el segundo perfil. No explica cómo se programa un webhook. Explica qué es, qué problema resuelve y por qué aparece en cualquier conversación seria sobre integración de aplicaciones. ## La diferencia entre una API y un webhook Para entender un webhook ayuda compararlo con una API, que es el concepto más conocido. Si no lo tienes claro, puedes leer antes [qué es una API y por qué debería importarte](https://baqueiro.es/codigo-que-trabaja-por-ti/que-es-una-api-y-por-que-deberia-importarte-aunque-no-seas-tecnico/). Una API funciona con un esquema de pregunta y respuesta: tu sistema pregunta y el sistema externo responde. Para saber si hay pedidos nuevos, tu sistema tiene que preguntar a la tienda cada cierto tiempo: «¿hay pedidos nuevos?». Si los hay, los recibe. Si no, recibe una respuesta vacía y vuelve a preguntar más tarde. Es como llamar a alguien cada 10 minutos para ver si tiene noticias para ti. Un webhook invierte esa lógica: en lugar de que tu sistema pregunte, el sistema externo te avisa cuando algo ocurre. La tienda tiene configurado un webhook que dice «cuando llegue un pedido nuevo, envía los datos a esta dirección». Cuando entra el pedido, el aviso llega solo. Es como darle a alguien tu número para que te llame cuando tenga noticias. En la práctica, los webhooks son más eficientes, porque no hay consultas inútiles cuando no pasa nada, y más inmediatos, porque el aviso llega en el momento del evento y no en la siguiente ronda de consultas. Una precisión para no liarse en las reuniones: el webhook no sustituye a la API, la complementa. Lo habitual es que el webhook avise de que algo ha pasado y que, si hace falta más información, tu sistema la pida después a través de la API. ## Cómo funciona un webhook en la práctica Un webhook funciona en 3 pasos: **Paso 1: configuración.** En el sistema que va a enviar el aviso (una pasarela de pago, una tienda online, un CRM) se definen 2 cosas: el evento que lo dispara y la dirección (URL) a la que se enviará. Por ejemplo: «cuando se complete un pago, enviar los datos a https://tusistema.com/webhook/pagos». **Paso 2: el evento ocurre.** Cuando el cliente completa el pago, el sistema envía automáticamente un mensaje HTTP a esa dirección con los datos del evento: el identificador del pedido, el importe, los datos del cliente y el estado de la transacción. **Paso 3: tu sistema recibe y procesa.** El sistema que escucha en esa dirección recibe los datos y hace lo que corresponda: actualizar el estado del pedido, enviar un correo de confirmación, avisar al almacén o registrar el cobro en contabilidad. Todo esto ocurre en segundos, de forma automática y sin intervención humana. Un detalle que separa una implementación sólida de una frágil: el receptor debe confirmar enseguida que ha recibido el aviso y hacer el trabajo pesado después. Si tarda demasiado en contestar, el emisor puede dar el envío por fallido y repetirlo, y entonces el mismo evento llega 2 veces. ## Ejemplos habituales de uso de webhooks ### Pagos y transacciones Stripe y PayPal usan webhooks para notificar eventos de pago, y Redsys hace algo equivalente con su notificación online al comercio. Cuando un cliente paga, el aviso pone en marcha lo que viene después: generar la factura, enviar la confirmación, actualizar el inventario o activar el acceso en una plataforma de suscripción. Sin webhook, habría que consultar periódicamente el estado de cada transacción o revisarlo a mano. ### Formularios y leads Cuando alguien rellena un formulario de contacto en WordPress, un webhook (nativo del plugin de formularios o mediante un complemento) puede enviar esos datos al instante a un CRM: crear el contacto, asignarlo al comercial que corresponda según el tipo de consulta y activar una secuencia de correos de bienvenida. Todo en el momento en que se pulsa «enviar». ### Gestión de inventario Si la tienda online y el sistema de gestión de almacén están conectados con webhooks, cuando el stock de un producto baja de un mínimo, el aviso genera automáticamente una orden de reposición. Sin webhook, alguien tiene que revisar el stock a mano o esperar a que la próxima sincronización detecte el cambio. ### Notificaciones internas Los webhooks también sirven para la comunicación interna. Cuando se registra un cliente nuevo en tu plataforma, un webhook puede enviar un mensaje a un canal de Slack del equipo comercial con sus datos. Cuando se produce un error crítico en producción, puede alertar al equipo técnico de inmediato, sin que nadie tenga que estar vigilando una pantalla. ## Por qué importa entender los webhooks si no eres técnico Las integraciones entre sistemas aparecen en casi todas las propuestas de desarrollo y en cualquier conversación sobre automatizar procesos. Entender la diferencia entre una integración basada en consultas periódicas y una basada en webhooks te permite hacer mejores preguntas. «¿La integración usa webhooks o consultas periódicas?» no es una pregunta técnica: es una pregunta sobre lo actualizados que estarán tus datos y lo eficiente que será el sistema. Una integración que consulta cada 10 minutos puede bastar en muchos casos. En otros, como confirmaciones de pago, alertas de stock o avisos críticos, esos 10 minutos tienen un impacto real en la operativa. Si quieres pensar qué procesos de tu empresa merecen este tipo de conexión, te puede servir leer [qué datos de tu negocio deberían actualizarse solos](https://baqueiro.es/automatizacion/datos-negocio-actualizarse-solos/). ## Checklist: preguntas sobre webhooks en una propuesta de integración - ¿La integración propuesta usa webhooks o consultas periódicas a una API? - ¿Cuánto tardan los datos en pasar de un sistema al otro? - ¿Qué pasa si el webhook falla? ¿Hay reintentos automáticos? - ¿Qué pasa si el mismo aviso llega 2 veces? ¿Se evita duplicar pedidos, cobros o facturas? - ¿Se registran los eventos recibidos para poder revisarlos si algo sale mal? - ¿La dirección del webhook está protegida para evitar envíos fraudulentos? ## Preguntas frecuentes ### ¿Los webhooks son seguros? Depende de cómo estén implementados. Un webhook mal protegido puede aceptar datos de cualquiera que conozca la dirección, no solo del sistema autorizado. Las buenas implementaciones verifican una firma: el sistema emisor incluye una firma criptográfica en cada mensaje y el receptor comprueba que corresponde al emisor autorizado antes de procesar nada. Stripe, por ejemplo, firma todos sus webhooks. ### ¿Qué pasa si mi sistema no está disponible cuando llega un webhook? Los emisores bien diseñados incluyen reintentos: si el receptor devuelve un error o no responde, vuelven a enviar el aviso varias veces, con intervalos cada vez más largos. Stripe, por ejemplo, reintenta los envíos fallidos durante un máximo de 3 días. Aun así, en procesos críticos conviene que el receptor sea fiable y que exista una conciliación periódica que recupere los eventos que se hayan podido perder durante una caída. ### ¿Puedo usar webhooks sin saber programar? En algunos casos, sí. Herramientas como Zapier o Make pueden recibir webhooks y procesarlos sin código: creas un disparador de tipo webhook, obtienes una dirección y la pegas en el sistema que quieres conectar. Si lo haces, deja por escrito qué escenario recibe cada aviso y quién lo mantiene, porque [el coste oculto de las automatizaciones mal documentadas](https://baqueiro.es/automatizacion/coste-automatizaciones-mal-documentadas/) aparece justo cuando algo falla. Para un receptor a medida que ejecute lógica de negocio propia, como actualizar tu base de datos o lanzar procesos internos, necesitas desarrollo. En Baqueiro implementamos webhooks e integraciones entre sistemas con código propio cuando la lógica lo requiere, sin depender de plataformas de automatización externas. Si tienes procesos que deberían comunicarse solos y no lo hacen, [cuéntanoslo](https://baqueiro.es/contacto/).