Vivoldi Webhook — Entrega de Eventos en Tiempo Real
Recibe eventos en tiempo real de clics en enlaces, uso de cupones y recompensas de sellos con estabilidad incluso en entornos de alto tráfico.
Desde verificación de firmas HMAC-SHA256 y prevención de eventos duplicados hasta reintentos automáticos, todo está diseñado para ofrecer confiabilidad de nivel empresarial sin configuraciones adicionales.
¿Qué es Vivoldi Webhook?
Vivoldi Webhook es un sistema de integración en tiempo real entre servidores que envía datos de eventos directamente a tu endpoint en el momento en que ocurre un evento.
Sin necesidad de realizar API polling por separado, los datos se entregan inmediatamente al endpoint registrado en Vivoldi, permitiendo una sincronización de datos rápida y en tiempo real.
💡 ¿Por qué usar Webhooks?
El método tradicional de API polling requiere enviar solicitudes periódicas al servidor, lo que puede generar tráfico API innecesario y retrasos en la detección de eventos.
Vivoldi Webhook solo llama a tu servidor cuando ocurre un evento real, permitiendo respuestas inmediatas sin solicitudes innecesarias.
Es ideal para flujos de trabajo sensibles al tiempo, como actualizaciones de CRM, procesamiento de pagos y automatización de marketing.
Flujo de Funcionamiento del Webhook
Los Webhooks de Vivoldi funcionan en cuatro pasos: detección del evento → generación de la firma → envío por HTTPS → confirmación de entrega.
Detección del evento
Cuando se produce un evento en un enlace, cupón o tarjeta de sellos con los Webhooks activados, Vivoldi lo detecta de inmediato.
Generación de la firma
Antes del envío, Vivoldi genera una firma HMAC-SHA256 para el payload y la incluye en las cabeceras de la solicitud.
Su servidor puede verificar esta firma para confirmar que la solicitud procede de Vivoldi.
Envío por HTTPS
Vivoldi envía una solicitud POST a la Callback URL registrada. El tiempo de espera de la respuesta es de 5 segundos.
Confirmación de entrega
Si su servidor devuelve una respuesta 2xx, la entrega se considera correcta. Si no se recibe respuesta o se devuelve un error HTTP, Vivoldi continúa con el proceso de reintento descrito a continuación.
¿Dónde se configuran los Webhooks?
Configurar un Webhook global no hace que los eventos se envíen automáticamente. La configuración global define la Callback URL y la Secret Key predeterminadas que se utilizarán para enviar los eventos. Los eventos solo se envían cuando los Webhooks están activados en el enlace, cupón o tarjeta de sellos correspondiente.
Si un grupo de enlaces, un grupo de cupones o una tarjeta de sellos tiene su propio Webhook configurado, esa configuración tiene prioridad sobre la configuración global. Aunque estén activados tanto el Webhook global como el individual, cada evento se envía una sola vez.
¿Qué ocurre si falla la entrega?
La entrega se considera fallida si el código de estado de la respuesta no es 2xx o si no se recibe una respuesta en un plazo de 5 segundos.
Las solicitudes fallidas se reintentan independientemente del código de estado de la respuesta, por lo que un único fallo de entrega no desactiva el Webhook.
Un fallo de entrega no desactiva el Webhook de inmediato.
Vivoldi envía primero una notificación por correo electrónico sobre el fallo y, a continuación, concede un período de gracia de 60 minutos.
Si el servidor receptor vuelve a estar operativo durante ese período, el Webhook permanece activo y la entrega continúa.
| Etapa | Momento | Acción |
|---|---|---|
| Reintento inmediato | Después de 1 s · 2 s | Se realizan reintentos para solucionar errores temporales de red. Incluyendo el envío inicial, se realizan un total de 3 intentos. |
| Reintento diferido | Después de 10 min · 20 min | Se realizan reintentos adicionales para cubrir reinicios del servidor receptor o interrupciones temporales. Incluyendo el envío inicial, se realizan hasta 5 intentos. |
| Notificación de advertencia | Aprox. 30 min | El Webhook no se desactiva en esta etapa. Se envía una notificación por correo electrónico con información sobre el destino afectado y la causa del fallo. |
| Período de gracia | 60 min | Si el servidor receptor se recupera durante el período de gracia, la entrega se reanuda automáticamente sin desactivar el Webhook. Los eventos de cupones y tarjetas de sellos generados durante este período también se entregan de forma secuencial. |
| Desactivación automática | Aprox. 90 min | Si los fallos de entrega continúan después del período de gracia, el estado del Webhook cambia a Desactivado por el sistema y se envía una notificación por correo electrónico. |
Si se producen fallos continuos desde el mismo endpoint receptor, el envío se pausa temporalmente y Vivoldi realiza envíos de prueba para comprobar si el servidor se ha recuperado.
Las solicitudes se gestionan para evitar que se acumulen continuamente en un servidor receptor que no responde. Las interrupciones breves, como despliegues del cliente o problemas temporales, se solucionan automáticamente.
Los eventos de uso de cupones y acumulación de sellos nunca se pierden.
Como son eventos importantes que solo ocurren una vez, se almacenan en una cola durante los reintentos de envío o cuando se aplican límites de solicitudes, y se entregan en orden cuando el envío puede reanudarse.
Los eventos de clic en enlaces se producen repetidamente y todos los datos analíticos se almacenan en Vivoldi. Por ello, no se realizan intentos de envío adicionales durante las restricciones temporales de entrega.
Cuando un Webhook se desactiva automáticamente
El estado de los Webhooks se gestiona mediante tres estados.
Usa el filtro de Webhooks en la página de lista para consultar los Webhooks según su estado.
- Activo El Webhook funciona correctamente y los eventos se están enviando.
- Desactivado El Webhook ha sido desactivado manualmente por el usuario.
- Desactivado por el sistema Vivoldi ha desactivado automáticamente el Webhook debido a fallos de entrega repetidos. Se envía una notificación por correo electrónico al desactivarlo.
El estado Desactivado por el sistema puede volver a activarse desde el panel de control después de solucionar el problema del servidor receptor.
Tras la reactivación, el envío se reanuda para los nuevos eventos. Los eventos generados mientras el Webhook estaba desactivado se procesan según la política anterior.
Funciones Principales del Webhook
Automatización en tiempo real
Automatiza tus flujos de trabajo de marketing, CRM y pagos con actualizaciones instantáneas de accesos a enlaces, uso de cupones y registro o canje de sellos.
Seguridad empresarial
Evita la manipulación y los ataques de repetición en los eventos de Enlaces, Cupones y Sellos mediante firmas HMAC-SHA256, hash de contenido y verificación de marca de tiempo.
Fiabilidad operativa
Procesa de forma confiable los eventos de Enlaces, Cupones y Sellos incluso ante fallos del sistema gracias a la entrega garantizada al menos una vez, reintentos automáticos, notificaciones por correo y lógica de desactivación.
Disponibilidad por plan
Los Webhooks están disponibles en los planes Premium y superiores. La cantidad disponible de Webhooks se limita según el número de destinos en los que pueden habilitarse.
| Gratis · Personal | Premium | Business | Business Plus | Enterprise | |
|---|---|---|---|---|---|
| Uso de Webhooks | — | ✓ | ✓ | ✓ | ✓ |
| Enlaces individuales | — | 1 | 5 | 1 por cada 1,000 enlaces al mes (hasta 50) |
Ilimitado |
| Grupos de enlaces | — | — | — | — | Ilimitado |
| Cupones individuales | — | Ilimitado | Ilimitado | Ilimitado | Ilimitado |
| Grupos de cupones | — | — | Ilimitado | Ilimitado | Ilimitado |
| Tarjetas de sellos | — | 1 | 5 | 1 por cada 1,000 enlaces al mes (hasta 50) |
Ilimitado |
| Solicitudes por minuto / hora | — | 240 / 12,000 | 384 / 20,000 | Desde 614 / 32,000 | Desde 960 / 48,000 |
Los límites de solicitudes de Webhooks se establecen en el 80% de los límites de solicitudes de API.
En el plan Business Plus, la cantidad de Webhooks disponibles aumenta según el límite mensual de creación de enlaces seleccionado.
El plan Enterprise se ofrece mediante un acuerdo personalizado según las necesidades de uso.
Consulta los límites de solicitudes por plan para ver los valores detallados.
Los Webhooks de grupos de enlaces son una función exclusiva del plan Enterprise.
Al activar un Webhook en un grupo de enlaces, se aplica automáticamente a todos los enlaces incluidos en ese grupo.
Al cambiar a un plan superior, los límites de uso de Webhooks se amplían inmediatamente.
Si cambias a un plan inferior y tienes destinos que superan el nuevo límite, los destinos más antiguos se desactivan automáticamente primero. La lista de destinos desactivados se enviará por correo electrónico.
Aunque la cuenta cambie al plan gratuito al finalizar el período de suscripción, la configuración de Webhooks se conserva y se reanudará automáticamente sin configuración adicional al volver a contratar un plan de pago.
✨ Integración en tiempo real de nivel empresarial
Optimizado para entornos empresariales que gestionan grandes volúmenes de eventos de enlaces, cupones y sellos.
Basado en infraestructura de alta disponibilidad y sistemas de colas confiables, Vivoldi ofrece integraciones estables con plataformas CRM, pagos y análisis sin pérdida de eventos, incluso durante picos repentinos de tráfico.