Webhooks

Resumen

Un webhook invierte el flujo típico de una API. En un API REST, el cliente pregunta —polling— «¿hay algo nuevo?». Con un webhook, el cliente registra una URL y el servidor envía una solicitud HTTP —usualmente POST— a esa URL cuando ocurre un evento relevante. El cliente pasa de preguntar cada 60 segundos a ser notificado instantáneamente.

Importa porque es el mecanismo más simple de integración entre sistemas. No requiere colas de mensajes, ni brokers, ni protocolos especiales: solo HTTP. GitHub notifica a tu servidor de CI con un webhook cuando hacés push. Stripe notifica a tu backend cuando un pago se completa. Paypal, Twilio, Slack —todos usan webhooks—.

Alcance y supuestos

Cubre el concepto de webhooks, patrones de entrega —at-least-once, retries, orden— y seguridad —firma de payloads—. Asume familiaridad con HTTP.

Modelo mental

Una alerta de tu banco por SMS. En lugar de entrar a la app cada hora a ver si te llegó un depósito, configurás una alerta: «avisame cuando reciba una transferencia». El banco te manda el SMS —el webhook— solo cuando el evento ocurre.

Uso práctico

• ✅ Notificaciones en tiempo real entre servicios.
• ❌ Eventos que requieren orden estricto o procesamiento masivo —ahí mensajería como Kafka es mejor—.

Ejemplo trabajado: webhook de GitHub a CI

GitHub envía un POST a https://ci.example.com/hooks/github con un JSON que incluye el commit SHA, el autor y el repositorio. El servidor de CI verifica la firma HMAC del payload para asegurarse de que viene de GitHub, y dispara el pipeline. Si el CI está caído, GitHub reintenta con backoff.

Evidencia

• Los webhooks son ubicuos en plataformas SaaS. GitHub, Stripe y Twilio documentan extensamente sus sistemas de webhooks.