Significado de Webhook
Sustantivo masculino. Del inglés web, «red», y hook, «gancho».
Un webhook es un mecanismo por el que una aplicación avisa automáticamente a otra, mediante una petición a una dirección de internet acordada, en el momento exacto en que ocurre un evento concreto.
A diferencia de consultar repetidamente si algo ha cambiado, con un webhook es la aplicación de origen la que toma la iniciativa de avisar en cuanto sucede el evento.
Qué es un webhook
Cuando una aplicación necesita saber si algo ha cambiado en otra —si llegó un pago, si se creó un usuario nuevo—, la forma más simple es preguntarlo una y otra vez a intervalos regulares, una técnica llamada sondeo. El problema es que ese sondeo desperdicia recursos: la mayoría de las veces la respuesta es «nada ha cambiado», y aun así consume tiempo de red y de procesador en ambos extremos, además de introducir un retraso entre que algo ocurre y que se detecta.
Un webhook invierte esa lógica: en lugar de que la aplicación interesada pregunte repetidamente, la aplicación de origen envía automáticamente los datos del evento, en el instante en que ocurre, a una dirección de internet que la aplicación receptora ha configurado de antemano. Eso elimina el desperdicio del sondeo y reduce el retraso casi a cero, pero exige que la aplicación receptora tenga un punto de recepción disponible en todo momento, listo para atender el aviso en cualquier instante.
Lo emplean sobre todo servicios que necesitan comunicarse entre sí de forma automática: sistemas de pago, herramientas de gestión de proyectos, plataformas de mensajería y cualquier integración entre aplicaciones distintas.
Origen de la palabra webhook
Del inglés web, «red», y hook, «gancho», con el sentido de un punto donde «engancharse» a un evento que ocurre en otro sistema para reaccionar a él automáticamente.
El término se acuñó dentro del desarrollo web, como una forma de nombrar un patrón que ya se usaba de manera informal para conectar aplicaciones distintas mediante avisos automáticos. Se popularizó con el crecimiento de los servicios en internet que necesitaban integrarse entre sí sin depender de un desarrollo a medida para cada combinación de sistemas, y hoy es un mecanismo habitual en la comunicación entre aplicaciones.
Webhook frente a otras formas de comunicación
| Rasgo | Sondeo | Webhook |
|---|---|---|
| Quién inicia el contacto | La aplicación interesada, preguntando repetidamente. | La aplicación de origen, en cuanto ocurre el evento. |
| Retraso hasta enterarse | Depende de la frecuencia de las consultas. | Prácticamente inmediato. |
| Consumo de recursos | Alto, por las consultas repetidas sin cambios. | Bajo, solo se envía cuando hay algo que avisar. |
| Requisito para el receptor | Ninguno especial, solo hacer las consultas. | Tener un punto de recepción disponible en todo momento. |
Ejemplos de uso de webhook
El sistema de pagos envía un webhook en cuanto se confirma una transacción, para que la tienda actualice el pedido al instante.
Configuró un webhook para recibir un aviso automático cada vez que alguien completara el formulario de contacto.
El servicio dejó de recibir avisos porque el punto de recepción del webhook había dejado de estar disponible.
Los desarrolladores usaron un webhook para conectar la herramienta de gestión de tareas con el chat del equipo.
El registro mostró que el webhook se activó correctamente en el momento exacto del evento.
Sinónimos y palabras relacionadas
Sinónimos: gancho web, notificación automática entre sistemas.
Antónimos: sondeo, consulta periódica.
No es lo mismo que:
- API: con una API, la aplicación interesada pregunta activamente cuándo quiere; con un webhook, es la otra aplicación la que avisa por iniciativa propia. Ver significado de API.
- Microservicio: un microservicio es una pieza independiente de una aplicación; el webhook es solo una forma en que dos servicios —microservicios o no— pueden avisarse entre sí. Ver significado de microservicio.
- Notificación push: avisa directamente a un usuario en su dispositivo; el webhook avisa a otro sistema informático, no a una persona.
Preguntas frecuentes sobre el webhook
¿En qué se diferencia un webhook de consultar una API repetidamente?
En quién toma la iniciativa: con la consulta repetida, o sondeo, la aplicación interesada pregunta una y otra vez si algo cambió; con un webhook, es la aplicación de origen la que avisa automáticamente en cuanto ocurre el evento, sin que nadie tenga que preguntar.
¿Qué necesita una aplicación para recibir webhooks?
Necesita un punto de recepción accesible desde internet, disponible en todo momento, capaz de recibir la petición que envía la aplicación de origen y procesar los datos del evento que contiene.
¿Qué pasa si el receptor de un webhook no está disponible en el momento del aviso?
Depende del servicio que lo envía: algunos reintentan el envío pasado un tiempo, y otros dan el aviso por perdido si el receptor no responde a la primera, lo que puede provocar que la información no llegue nunca.