company logo

Centre d'aide

Aller sur Sarbacane
Accéder à Sarbacane
Powered by
Toutes les collectionsCampagnes emailingParamétrage des campagnesComment configurer un webhook dans Sarbacane Campaigns ?

Comment configurer un webhook dans Sarbacane Campaigns ?

Recevez automatiquement dans votre application (CRM, site…) les clics, ouvertures, désinscriptions et NPAI de vos campagnes.

Dans Sarbacane Campaigns, un webhook prévient automatiquement et instantanément votre application ou votre site quand un événement se produit sur l'une de vos campagnes. Par exemple, vous êtes averti d'un clic sur un lien pour faire remonter l'information dans votre CRM. Sarbacane envoie chaque événement à votre URL au format JSON. Cette fonction s'adresse aux développeurs et aux intégrateurs.

Prérequis

  • Un abonnement Sarbacane Campaigns Premium ou supérieur.

  • Être propriétaire ou administrateur du compte, ou utilisateur avec ce droit dans Autorisations.

  • Une URL de votre application, en https, capable de recevoir les notifications.

Étapes

  1. Dans le menu de gauche de Sarbacane Campaigns, cliquez sur Paramètres.

  2. Dans le menu des paramètres, cliquez sur API & webhooks, puis ouvrez l'onglet Webhooks.

  3. Vérifiez que l'interrupteur Les Webhooks sont activés est activé.

  4. Sur la ligne Ajouter un webhook, cliquez sur Créer.

  5. Dans la fenêtre Créer votre Webhook, renseignez Nom et URL sur laquelle vous souhaitez recevoir les notifications.

  6. Cochez les événements voulus : Statuts (Email hardbounce, Email softbounce, Email délivré, Email protégé), Comportements (Clic, Ouverture, Désinscription, Plainte) ou Formulaire (Nouvelle réponse soumise au formulaire).

  7. En bas de la fenêtre, cliquez sur Enregistrer.

Note : Email protégé désigne les emails retenus par un répondeur automatique, qui demande à l'expéditeur de s'authentifier avant de délivrer le message (Altospam, Mail in black…).

Pour modifier ou supprimer un webhook : menu ••• du webhook, Éditer ou Supprimer. Le format des notifications est détaillé dans Documentation Webhooks (onglet Webhooks).

Résultat attendu

Le webhook apparaît dans la liste avec son nom et son URL. Votre application reçoit une notification à chaque événement coché.

Dépannage

Le message « Une erreur est survenue lors de la création du Webhook. » s'affiche

Vérifiez que l'URL est complète et commence par https://, et que votre application est en ligne et accessible.

Mon application ne reçoit aucune notification

Vérifiez que Les Webhooks sont activés est activé, que les bons événements sont cochés et que l'URL répond.

Je ne trouve pas API & webhooks

La fonction est réservée aux abonnements Premium et supérieurs.

Articles liés

  • Comment créer une clé API dans Sarbacane Campaigns ?

Cette réponse vous a-t-elle aidé ?
😞
😐
😁