Vivoldi Webhook — Diffusion d’Événements en Temps Réel
Recevez en temps réel les événements de clics sur les liens, utilisation de coupons et récompenses de tampons, même dans des environnements à fort trafic.
Vérification des signatures HMAC-SHA256, prévention des événements dupliqués et nouvelles tentatives automatiques — tout est conçu pour offrir une fiabilité de niveau entreprise sans configuration supplémentaire.
Qu’est-ce que le Webhook Vivoldi ?
Le Webhook Vivoldi est un système d’intégration serveur à serveur en temps réel qui envoie directement les données d’événements vers votre endpoint dès qu’un événement se produit.
Sans nécessiter d’API polling séparé, les données sont immédiatement transmises aux endpoints enregistrés dans Vivoldi, permettant une synchronisation des données rapide et en temps réel.
💡 Pourquoi utiliser les Webhooks ?
La méthode traditionnelle d’API polling nécessite l’envoi régulier de requêtes au serveur, ce qui peut entraîner un trafic API inutile ainsi que des retards dans la détection des événements.
Vivoldi Webhook appelle votre serveur uniquement lorsqu’un événement se produit réellement, permettant des réactions immédiates sans requêtes inutiles.
Il est idéal pour les workflows sensibles au temps comme les mises à jour CRM, le traitement des paiements et l’automatisation marketing.
Fonctionnement du Webhook
Les Webhooks Vivoldi fonctionnent en quatre étapes : détection de l’événement → génération de la signature → envoi HTTPS → confirmation de réception.
Détection de l’événement
Lorsqu’un événement se produit sur un lien, un coupon ou une carte de fidélité avec les Webhooks activés, Vivoldi le détecte immédiatement.
Génération de la signature
Avant l’envoi, Vivoldi génère une signature HMAC-SHA256 pour le payload et l’ajoute aux en-têtes de la requête.
Votre serveur peut vérifier cette signature afin de confirmer que la requête provient bien de Vivoldi.
Envoi HTTPS
Vivoldi envoie une requête POST à la Callback URL enregistrée. Le délai d’attente de la réponse est de 5 secondes.
Confirmation de réception
Si votre serveur renvoie une réponse 2xx, l’envoi est considéré comme réussi. En l’absence de réponse ou si une erreur HTTP est renvoyée, Vivoldi passe au processus de nouvelle tentative décrit ci-dessous.
Où configurer les Webhooks ?
Configurer un Webhook global ne suffit pas à déclencher automatiquement l’envoi des événements. Les paramètres globaux définissent la Callback URL et la Secret Key par défaut utilisées pour l’envoi des événements. Les événements ne sont envoyés que si les Webhooks sont activés pour le lien, le coupon ou la carte de fidélité concerné.
Si un Webhook spécifique est configuré pour un groupe de liens, un groupe de coupons ou une carte de fidélité, cette configuration est prioritaire sur les paramètres globaux. Même si les Webhooks global et individuel sont tous deux activés, chaque événement n’est envoyé qu’une seule fois.
Que se passe-t-il en cas d’échec de l’envoi ?
L’envoi est considéré comme ayant échoué si le code d’état de la réponse n’est pas 2xx ou si aucune réponse n’est reçue dans un délai de 5 secondes.
Les requêtes ayant échoué sont relancées quel que soit le code d’état de la réponse. Un seul échec d’envoi ne suffit donc pas à désactiver le Webhook.
Un échec d’envoi ne désactive pas immédiatement le Webhook.
Vivoldi envoie d’abord une notification par e-mail pour signaler l’échec, puis accorde un délai de grâce de 60 minutes.
Si le serveur destinataire redevient opérationnel pendant ce délai, le Webhook reste actif et les envois se poursuivent.
| Étape | Délai | Action |
|---|---|---|
| Nouvelle tentative immédiate | Après 1 s · 2 s | Des tentatives supplémentaires sont effectuées pour gérer les erreurs réseau temporaires. En comptant l’envoi initial, un total de 3 tentatives est effectué. |
| Nouvelle tentative différée | Après 10 min · 20 min | Des tentatives supplémentaires sont effectuées pour prendre en compte un redémarrage du serveur destinataire ou une interruption temporaire. En comptant l’envoi initial, jusqu’à 5 tentatives sont effectuées. |
| Notification d’avertissement | Environ 30 min | Le Webhook n’est pas désactivé à cette étape. Une notification par e-mail est envoyée avec les informations sur la destination concernée et la cause de l’échec. |
| Délai de grâce | 60 min | Si le serveur destinataire redevient opérationnel pendant le délai de grâce, l’envoi reprend automatiquement sans désactiver le Webhook. Les événements liés aux coupons et aux cartes de fidélité survenus pendant cette période sont également envoyés dans l’ordre. |
| Désactivation automatique | Environ 90 min | Si les échecs d’envoi persistent après le délai de grâce, l’état du Webhook passe à Désactivé par le système et une notification est envoyée par e-mail. |
Si des échecs répétés se produisent depuis le même endpoint destinataire, l’envoi est temporairement suspendu et Vivoldi effectue des envois de test afin de vérifier si le serveur est de nouveau opérationnel.
Les requêtes sont gérées afin d’éviter leur accumulation continue sur un serveur destinataire qui ne répond pas. Les interruptions courtes, comme les déploiements côté client ou les incidents temporaires, sont automatiquement résolues.
Les événements d’utilisation de coupons et d’attribution de tampons ne sont jamais perdus.
Comme il s’agit d’événements importants qui ne se produisent qu’une seule fois, ils sont conservés dans une file d’attente pendant les nouvelles tentatives d’envoi ou en cas de limitation du nombre de requêtes, puis transmis dans l’ordre dès que l’envoi peut reprendre.
Les événements de clic sur les liens se produisent de manière répétée et toutes les données analytiques sont enregistrées dans Vivoldi. Par conséquent, aucune tentative d’envoi supplémentaire n’est effectuée pendant les restrictions temporaires d’envoi.
Lorsqu’un Webhook est désactivé automatiquement
Le statut des Webhooks est géré selon trois états.
Utilisez le filtre Webhook sur la page de liste pour consulter les Webhooks par statut.
- Actif Le Webhook fonctionne normalement et les événements sont envoyés.
- Désactivé Le Webhook a été désactivé manuellement par l’utilisateur.
- Désactivé par le système Le Webhook a été automatiquement désactivé par Vivoldi en raison d’échecs d’envoi répétés. Une notification par e-mail est envoyée lors de la désactivation.
Le statut Désactivé par le système peut être réactivé depuis le tableau de bord après résolution du problème du serveur destinataire.
Après la réactivation, l’envoi reprend pour les nouveaux événements. Les événements survenus pendant la désactivation du Webhook sont traités selon la politique précédente.
Fonctionnalités Principales du Webhook
Automatisation en temps réel
Automatisez vos flux de travail marketing, CRM et paiement grâce à la mise à jour instantanée des visites de liens, de l’utilisation des coupons et de la collecte ou de l’échange de tampons.
Sécurité Enterprise
Protégez les événements de Liens, Coupons et Tampons contre toute falsification ou attaque par rejeu grâce aux signatures HMAC-SHA256, au hachage du contenu et à la vérification des horodatages.
Fiabilité opérationnelle
Garantissez le traitement fiable des événements de Liens, Coupons et Tampons, même en cas d’incident système, grâce à la livraison au moins une fois, aux relances automatiques, aux notifications par e-mail et à la logique de désactivation.
Disponibilité selon le forfait
Les Webhooks sont disponibles avec les forfaits Premium et supérieurs. Le nombre de Webhooks disponibles est limité selon le nombre de cibles sur lesquelles ils peuvent être activés.
| Gratuit · Personnel | Premium | Business | Business Plus | Enterprise | |
|---|---|---|---|---|---|
| Utilisation des Webhooks | — | ✓ | ✓ | ✓ | ✓ |
| Liens individuels | — | 1 | 5 | 1 pour 1,000 liens par mois (jusqu’à 50) |
Illimité |
| Groupes de liens | — | — | — | — | Illimité |
| Coupons individuels | — | Illimité | Illimité | Illimité | Illimité |
| Groupes de coupons | — | — | Illimité | Illimité | Illimité |
| Cartes de fidélité | — | 1 | 5 | 1 pour 1,000 liens par mois (jusqu’à 50) |
Illimité |
| Requêtes par minute / heure | — | 240 / 12,000 | 384 / 20,000 | À partir de 614 / 32,000 | À partir de 960 / 48,000 |
La limite de requêtes des Webhooks est fixée à 80 % de la limite des requêtes API.
Avec le forfait Business Plus, le nombre de Webhooks disponibles augmente selon la limite mensuelle de création de liens sélectionnée.
Le forfait Enterprise est proposé avec un accord personnalisé selon vos besoins d’utilisation.
Consultez les limites de requêtes par forfait pour connaître les valeurs détaillées.
Les Webhooks de groupes de liens sont exclusivement disponibles avec le forfait Enterprise.
Lorsqu’un Webhook est activé pour un groupe de liens, il est automatiquement appliqué à tous les liens inclus dans ce groupe.
Le passage à un forfait supérieur étend immédiatement les limites d’utilisation des Webhooks.
En cas de passage à un forfait inférieur avec des cibles dépassant la nouvelle limite, les cibles les plus anciennes sont automatiquement désactivées en premier. La liste des cibles désactivées est envoyée par e-mail.
Même si le compte passe au forfait gratuit après la fin de la période d’abonnement, les paramètres des Webhooks sont conservés et reprennent automatiquement sans configuration supplémentaire lors d’une nouvelle souscription à un forfait payant.
✨ Intégration en temps réel de niveau Enterprise
Optimisé pour les environnements d’entreprise traitant de grands volumes d’événements liés aux liens, coupons et tampons.
Grâce à une infrastructure haute disponibilité et à des systèmes de queueing fiables, Vivoldi assure une intégration stable avec vos plateformes CRM, de paiement et d’analyse, sans perte d’événements, même lors de pics soudains de trafic.