¿Qué son los webhooks?

Un webhook es un callback HTTP mediante el cual un sistema notifica a otro que algo ha ocurrido. En lugar de que el receptor consulte periódicamente si hay cambios (polling), el sistema origen envía un mensaje pequeño a una URL registrada cuando ocurre un evento, como un nuevo pedido, una actualización de stock o la publicación de contenido.

Definición

Un envío de webhook normalmente contiene un tipo de evento, una marca de tiempo, un payload que describe la entidad modificada y una firma para la autenticación. El receptor confirma la recepción del mensaje con un código HTTP de éxito y lo procesa de forma asíncrona. Los emisores fiables reintentan en caso de fallo, deduplican por id de evento y ofrecen un panel con el historial de envíos y la posibilidad de reenviarlos.

Por qué es importante

Los webhooks son el tejido conectivo del comercio composable. Permiten que servicios independientes reaccionen a los cambios sin necesidad de polling, lo que mantiene los sistemas sincronizados y reduce la latencia entre los eventos y las acciones posteriores. Cuando el inventario cae a cero en el OMS, un webhook puede disparar en segundos la reindexación en el buscador, la revalidación de página en el storefront y las notificaciones en la herramienta de marketing.

Consideraciones operativas

Los consumidores de webhooks deben ser idempotentes, ya que los reintentos pueden generar envíos duplicados. Deben verificar las firmas para evitar solicitudes falsificadas y gestionar la contrapresión (backpressure) cuando llegan ráfagas de eventos. En una plataforma de gestión de frontend, los webhooks suelen impulsar la invalidación de caché, la regeneración estática y las notificaciones posteriores, por lo que monitorizar la salud de los webhooks es una parte crítica de las operaciones.

Relacionado

Explora Composable Headless Frontend · Composable Digital Experience Platform.