Webhooks

Les webhooks vous permettent de recevoir des événements de consentement sous forme de requêtes POST HTTP vers votre propre endpoint. Utilisez les webhooks pour synchroniser l'état du consentement avec votre backend, CRM ou entrepôt de données.

Configuration d'un webhook

1. Accédez à Tableau de bord → Propriété → Webhooks → Ajouter un endpoint
2. Saisissez l'URL de votre endpoint (doit être HTTPS)
3. Sélectionnez les événements à envoyer
4. Copiez votre secret webhook (utilisé pour la vérification de signature)
5. Enregistrez

Événements

Événement	Déclencheur
consent.created	L'utilisateur donne son consentement pour la première fois
consent.updated	L'utilisateur modifie ses choix de consentement
consent.expired	Le consentement stocké atteint sa date d'expiration
consent.reset	Réinitialisation du consentement au niveau de la propriété appliquée

Format de la charge utile

{
  "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": "DE",
    "user_agent_hash": "sha256:abc...",
    "ip_hash": "sha256:def..."
  }
}

Vérification des signatures

Vérifiez toujours l'en-tête X-ConsentForge-Signature avant de traiter. Consultez Sécurité des webhooks pour des exemples de code.

Test des webhooks

Utilisez le bouton Tester dans les paramètres webhook du tableau de bord pour envoyer un exemple de charge utile à votre endpoint. Vous pouvez également utiliser webhook.site pour les tests locaux.

Consultation de l'historique des livraisons

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.