Ir al contenido principal
miji.be

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.

31 oct 2026 / Lectura de aproximadamente 1 min

Acortamiento de URL

El reintento de webhook es un mecanismo que, cuando falla la entrega de un webhook que notifica a sistemas externos eventos como los clics en URLs cortas, la reenvía dejando un intervalo determinado. Se usa para hacer llegar más tarde las entregas que fallaron por problemas de red o por un tiempo de inactividad temporal del lado receptor.

Una de las formas de decidir el tiempo de espera de los reintentos es el retroceso exponencial (Exponential Backoff). El tiempo de espera aumenta de forma exponencial: 1 segundo tras el primer fallo, 2 segundos tras el segundo, 4 segundos tras el tercero, 8 segundos tras el cuarto... Con ello, es menos probable que los reenvíos se acumulen sobre un receptor sobrecargado. Si se añade jitter (una fluctuación aleatoria), es menos probable que los reenvíos de varios webhooks se concentren en el mismo momento.

Los casos de uso típicos de los webhooks en un acortador de URL son (1) la integración de los eventos de clic con el CRM (lead scoring), (2) las notificaciones a Slack/Teams (supervisión de campañas en tiempo real), (3) la acumulación de eventos en un almacén de datos (plataforma de análisis) y (4) las alertas de seguridad (detección de patrones de clic sospechosos).

Una consideración de diseño importante es garantizar la idempotencia (Idempotency). Como los reintentos pueden hacer que un mismo evento se entregue varias veces, el lado receptor necesita implementar la eliminación de duplicados mediante el ID del evento. También hace falta diseñar el número máximo de reintentos y la Dead Letter Queue (el lugar donde se apartan los eventos que al final no se pueden entregar). En la documentación para desarrolladores de Stripe (a octubre de 2026), los reenvíos en el entorno de producción duran como máximo 3 días. En la descripción de la Events API de Slack (a octubre de 2026), se reenvía como máximo 3 veces (casi de inmediato, al cabo de 1 minuto y al cabo de 5 minutos).

¿Te resultó útil este artículo?

Términos relacionados

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.

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.

Idempotencia

Propiedad por la cual una operación produce el mismo resultado sin importar cuántas veces se ejecute. Fundamental en el diseño de APIs para gestionar reintentos de forma segura.

Arquitectura de un acortador de URL

Diseño interno de un servicio de acortamiento de URL, que abarca la generación de identificadores, el diseño de la base de datos, la estrategia de caché y el procesamiento de redirecciones.

API key

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

Flujo de clics

Registro cronológico de la secuencia de clics que un usuario realiza en un sitio web. Se utiliza para analizar patrones de comportamiento y optimizar la experiencia de usuario.

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 funcionan los acortadores de URL - El lado técnico de las redirecciones

Descubre la mecánica técnica detrás del acortamiento de URLs: generación de hash, consultas a bases de datos, redirecciones HTTP y más. Incluye ejemplos de respuestas HTTP y cálculos de codificación base-62.

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.

Pon los términos en práctica

Acorta una URL gratis