Envoyer des données vers vos systèmes avec les webhooks

Un webhook envoie des données vers une URL de votre choix dès qu’un événement se produit, par exemple quand quelqu’un s’inscrit ou gagne un lot. Votre développeur met en place le système qui les reçoit. Les webhooks sont inclus à partir du forfait Basic.

Ajouter un webhook

Vous pouvez ajouter des webhooks à une campagne, dans l’éditeur sous Connecter > Webhooks, ou pour tout votre compte sous Paramètres > Webhooks.

1. Cliquez sur Ajouter un webhook.
2. Saisissez l’URL du payload. Elle doit utiliser HTTPS.
3. Choisissez le Type de contenu : application/json ou application/x-www-form-urlencoded.
4. Choisissez la Méthode : POST ou GET. Utilisez POST, sauf si votre système exige GET, qui envoie les données dans l’URL.
5. Saisissez un Secret pour signer les requêtes (recommandé).
6. Choisissez les événements sous Quels événements doivent déclencher le webhook ? :
   • « Lorsqu’un nouveau lead est créé » (au niveau du compte)
   • « Chaque fois qu’un lead participe à une campagne »
   • « Lorsqu’un lead gagne un lot »
7. Vérifiez que Active est activé et enregistrez.

Dans l’éditeur de campagne, vous pouvez aussi choisir Basic Auth sous Authentification, et utiliser Payload personnalisé pour définir vous-même les noms des champs.

Ce qui est envoyé

Le corps contient un event et un objet data avec la campagne (id et nom), les champs du lead, le canal, les consentements avec le texte, l’heure et l’adresse IP, les réponses au quiz et, pour les gagnants, le lot avec son code. Les valeurs vides sont omises.

Vérifier la signature

Si vous avez défini un secret, chaque requête comporte un en-tête X-Hub-Signature : sha1= suivi d’un HMAC-SHA1 des données encodées en JSON, avec votre secret comme clé. Calculez la même valeur de votre côté et comparez, pour être sûr que la requête vient bien de Scratcher.

Livraisons et nouvelles tentatives

Si votre URL ne répond pas ou renvoie une erreur, Scratcher réessaie deux fois : après 5 secondes, puis après une minute. Cliquez sur Afficher les livraisons (ou Voir les livraisons) pour voir chaque requête et sa réponse, n’afficher que les échecs et Réessayer une livraison. Les livraisons sont conservées 60 jours.

Activez Journaliser le corps de la réponse pour enregistrer aussi la réponse de votre système, ce qui aide au débogage.