Ir al contenido principal
miji.be

Webhook

Mecanismo que envía automáticamente una solicitud HTTP a una URL predefinida cuando ocurre un evento determinado. Se utiliza para integraciones en tiempo real.

4 nov 2026 / Lectura de aproximadamente 1 min

Analítica

Un webhook es un mecanismo por el cual, cuando se produce un evento concreto en un servicio, se envía automáticamente una solicitud HTTP (normalmente POST) a una URL registrada previamente. Es como dejar un número de teléfono diciendo "avísame si pasa algo": permite la integración entre servicios basada en eventos.

El concepto opuesto al webhook es el polling. Con polling, el cliente pregunta periódicamente "¿hay novedades?", lo que genera tráfico incluso cuando no hay cambios. Con un webhook, la notificación solo se envía cuando ocurre un evento.

En los servicios de URL cortas que ofrecen webhooks, un ejemplo de uso es recibir una notificación cada vez que se hace clic en un enlace. Por ejemplo, se puede enviar un aviso a un canal de Slack cuando alguien hace clic en un enlace de campaña importante, o acumular automáticamente los datos de clics en una base de datos propia.

Hay varios aspectos a tener en cuenta al implementar webhooks. Primero, el endpoint receptor se expone mediante HTTPS. Stripe exige que los endpoints registrados sean URL HTTPS de acceso público (según su documentación a octubre de 2026). Segundo, es necesario contemplar la lógica de reintentos en caso de que el envío falle. El número y el plazo de los reintentos varían según el servicio, y los eventos que se produzcan mientras el receptor está caído pueden perderse. Tercero, se verifica el origen del webhook comprobando la firma (por ejemplo, HMAC-SHA256).

Entre los servicios que usan webhooks están GitHub (notificaciones de push), Stripe (confirmación de pagos) y Slack (publicación de mensajes).

¿Te resultó útil este artículo?

Términos relacionados

Límite de tasa de API

Una restricción sobre el número de solicitudes de API que un cliente puede realizar dentro de un período de tiempo especificado.

API key

Cadena de texto que autentica y controla el acceso a una API. Se utiliza para identificar al usuario y limitar el uso.

Analítica de clics

La analítica de clics mide y analiza las interacciones de los usuarios con enlaces. Incluye métricas como CTR, fuentes de tráfico, dispositivos y ubicación geográfica de los visitantes.

Servidor

El ordenador que proporciona datos y servicios a través de la red. La base que sostiene desde la visualización de los sitios web hasta el reparto del correo.

HTTPS

La versión segura de HTTP que cifra los datos transmitidos entre un navegador y un servidor web utilizando TLS.

Reintento de webhook

Mecanismo que, cuando falla la entrega de una notificación webhook, la reenvía dejando intervalos, por ejemplo con retroceso exponencial. Se usa para hacer llegar más tarde a sistemas externos los eventos de clic de URLs cortas.

Artículos relacionados

Guía de API de acortadores de URL - Generación programática de URLs cortas

Una guía práctica para usar APIs de acortadores de URL. Aprende sobre formatos de solicitud, estructuras de respuesta, autenticación y patrones de implementación.

Cómo acortar las largas URL de GitHub para optimizar tu flujo de trabajo de desarrollo

Gestiona con URL acortadas las largas URL de Issues, PRs y archivos en GitHub. Uso en READMEs, notificaciones CI/CD y alternativas tras el cierre de git.io.

Cómo aprovechar las URL acortadas en Slack y Teams - Vista previa de enlaces y fiabilidad en equilibrio

Resolvemos los problemas de compartir URL largas en Slack y Teams con enlaces acortados. OGP, enlaces de marca, bots y análisis de clics por canal.

Preguntas frecuentes

¿Cuál es la diferencia entre un webhook y una API?
Una API es de tipo "pull": tú envías una solicitud para obtener información. Un webhook es de tipo "push": el servidor te envía una notificación cuando ocurre un evento. La API se usa cuando necesitas datos bajo demanda; el webhook, cuando quieres recibir la información en el momento en que ocurre un evento.
¿Se pierden los datos si falla la recepción de un webhook?
Depende del servicio. Stripe reintenta las entregas fallidas durante un máximo de tres días en modo live, mientras que GitHub no las reenvía automáticamente (se pueden reenviar a mano) (según la documentación de ambas empresas a octubre de 2026). Otra opción de diseño es guardar primero los webhooks recibidos en una cola de mensajes (como Amazon SQS) y procesarlos después.
¿Cómo se protege un webhook?
Se verifica el origen de la solicitud comprobando la firma. Por ejemplo, GitHub envía una firma HMAC (SHA-256) en la cabecera X-Hub-Signature-256, y el receptor calcula el mismo hash con la clave secreta compartida y compara ambos. Además, el endpoint se expone por HTTPS, y otra opción es limitar las direcciones IP de origen con una lista de permitidas.

Pon los términos en práctica

Acorta una URL gratis