Webhooks — Recevez vos événements en temps réel
Recevez des notifications HTTP en temps réel quand un événement se produit sur vos liens : clic, création, mise à jour, expiration et bien plus. Conformité RGPD incluse.
10 types d'événements
Payload riche
Chaque webhook contient des données détaillées sur l'événement, incluant les informations du visiteur :
Géolocalisation
Pays, continent et coordonnées approximatives du visiteur.
Appareil et navigateur
Type d'appareil (mobile/desktop), navigateur, système d'exploitation et user-agent.
Informations du lien
URL courte, URL de destination, clé, tags et métadonnées du lien concerné.
Sécurité
| Signature HMAC-SHA256 | Chaque requête est signée avec un secret HMAC-SHA256 unique. Vérifiez l'en-tête X-Houla-Signature pour authentifier l'origine. |
| HTTPS obligatoire | Les webhooks ne sont envoyés qu'à des endpoints HTTPS pour garantir le chiffrement des données en transit. |
| Retry automatique | En cas d'échec de livraison, Hou.la réessaie automatiquement jusqu'à 5 fois avec un backoff exponentiel. |
| Timeout configurable | La connexion expire après 10 secondes. Votre endpoint doit répondre avec un code 2xx. |
| Désactivation automatique | Après 10 échecs consécutifs, le webhook est automatiquement désactivé pour éviter les requêtes inutiles. |
Conformité RGPD
- Anonymisation IP — Optez pour l'anonymisation des adresses IP dans les payloads.
- Exclusion de géo — Désactivez la géolocalisation dans les données transmises.
- Exclusion du user-agent — Supprimez le user-agent des payloads pour limiter le tracking.
Options avancées
Batching intelligent
Regroupez les événements par lots pour réduire le nombre de requêtes HTTP et optimiser la charge serveur.
Sampling
Activez l'échantillonnage pour ne recevoir qu'un pourcentage des événements sur les liens à fort trafic.
Filtrage par lien
Limitez les notifications aux liens spécifiques qui vous intéressent au lieu de recevoir tous les événements.
Filtrage par tag
Filtrez les webhooks par tag pour ne recevoir que les événements des liens d'une campagne spécifique.
Comparatif : Hou.la vs la concurrence
| Fonctionnalité | hou.la | Dub.co | Rebrandly | Bitly |
|---|---|---|---|---|
| Webhooks disponibles | ||||
| Types d'événements | ||||
| HMAC-SHA256 | ||||
| Batching intelligent | — | — | ||
| Conformité RGPD | — | — | ||
| Filtrage par tag | — | — | ||
| Signature HMAC | SHA-256 | SHA-256 | — | — |
Comment configurer un webhook ?
Accéder au Manager
Connectez-vous à votre compte hou.la et rendez-vous dans la section "Webhooks" du Manager.
Créer un webhook
Cliquez sur "Nouveau webhook", donnez-lui un nom descriptif et entrez l'URL HTTPS de votre endpoint.
Choisir les événements
Sélectionnez les événements qui vous intéressent parmi les 10 types disponibles.
Configurer la sécurité
Copiez le secret HMAC-SHA256 généré automatiquement et configurez-le sur votre serveur pour vérifier les signatures.
Tester et activer
Utilisez le bouton "Tester" pour envoyer un événement de test et vérifier que votre serveur répond correctement.
Fonctionnalités Hou.la
Des outils puissants pour optimiser votre présence en ligne