Webhooks
Les webhooks vous permettent de recevoir des événements de consentement sous forme de requêtes HTTP POST vers votre propre endpoint. Utilisez les webhooks pour synchroniser l'état du consentement avec votre backend, CRM ou entrepôt de données.
Configurer un webhook
- Allez dans Tableau de bord → Propriété → Webhooks → Ajouter un endpoint
- Entrez l'URL de votre endpoint (doit être HTTPS)
- Sélectionnez les événements à envoyer
- Copiez votre secret webhook (utilisé pour la vérification de signature)
- Enregistrer
Événements
| Événement | Déclencheur |
|---|---|
consent.created | L'utilisateur donne son consentement pour la première fois |
consent.updated | L'utilisateur modifie ses décisions de consentement |
consent.expired | Le consentement enregistré atteint sa date d'expiration |
consent.reset | Une réinitialisation de consentement à l'échelle de la propriété est appliquée |
Format du payload
{
"event": "consent.created",
"delivery_id": "del_abc123",
"timestamp": "2026-03-09T12:00:00Z",
"property_id": "prop_xyz",
"data": {
"receipt_id": "rec_def456",
"policy_id": "pol_ghi789",
"policy_version": 3,
"choices": {
"necessary": true,
"analytics": true,
"marketing": false,
"functional": true
},
"region": "FR",
"user_agent_hash": "sha256:abc...",
"ip_hash": "sha256:def..."
}
}
Vérifier les signatures
Vérifiez toujours l'en-tête X-ConsentForge-Signature avant de traiter. Voir des exemples de code dans Sécurité des webhooks.
Tester les webhooks
Utilisez le bouton Tester dans les paramètres de webhook du tableau de bord pour envoyer un exemple de payload à votre endpoint. Vous pouvez également utiliser webhook.site pour les tests locaux.
Voir l'historique de livraison
Tableau de bord → Propriété → Webhooks → Journal de livraison affiche toutes les tentatives de livraison avec les codes de statut et les corps de réponse.