Configurer un webhook

Les webhooks permettent à votre application de recevoir les données en temps réel d'un ou de plusieurs événements se produisant sur la plateforme Dialog Insight. Par exemple, recevoir les données d'un nouveau contact pour l'ajouter à votre application.

Pré-requis

Avant de procéder à la configuration, il est important de prendre connaissance des informations suivantes : L'utilisation et la configuration sont destinées à des utilisateurs avancés qui sont familiers avec la programmation. Vous, ou toute autre personne compétente, devez configurer une adresse URL de réception dans votre application afin que les notifications d'événements puissent y être envoyées. Pour voir comment se présentent les notifications de différents types d'événements, il est suggéré de créer une URL de test dans Request Bin.

Chemin d'accès

Projet > Gestion des données > Connexions externes

 Comment faire

1. Cliquez sur Créer un webhook.
2. Entrez l'URL de réception.
3. Cochez les événements dont vous voulez recevoir les données.
4. Pour chaque événement, vous pouvez voir un exemple du code JSON envoyé, tester la réception des données directement sur votre URL et, pour les erreurs de messages, spécifier les types de communication et d'envoi concernés. Par défaut, tous les types de communication et les envois unitaires pour l'événement en question sont surveillés.
   
   Description des filtres applicables aux messages       

   Filtre	Description
   Tous les types	Tous les types de communication seront suivis.
   Des types spécifiques	Seuls les types de communications sélectionnés seront suivis.
   Envoi unitaire (confirmation, service Web, test)	Seuls les envois unitaires seront suivis.
   Envoi par lot ou campagne	Les envois en lot ainsi que les campagnes seront suivis.

5. Au besoin, validez que le webhook provient bien de Dialog Insight en utilisant la signature.
   Voir explication plus bas.
6. Si vous désirez être avisé par courriel lorsqu'un webhook est en erreur ou désactivé, sélectionnez les personnes auxquelles envoyé ce courriel dans la liste déroulante de destinataires.
7. Cliquez sur Sauvegarder.
8. Lorsque prêt à utiliser, cliquez sur Activer.

Pour plus d'informations, veuillez consulter le Guide d'utilisation des webhooks.

Recevoir un webhook

Dès qu’un webhook est configuré, Dialog Insight peut émettre une requête HTTP POST sur l’URL spécifiée à chaque fois que l’événement associé au webhook se produit.

Les paramètres de la requête POST contiennent des données (au format JSON) relatives à l’événement.

Répondre à un webhook

Votre application doit confirmer la réception de la notification avec une réponse HTTP dont le code est 200 (statut = OK) . Toute réponse en dehors de cette gamme indiquera à Dialog Insight que vous n’avez pas reçu votre webhook.

Dialog Insight fera jusqu'à 5 tentatives d'envoi sur un période d'environ 2 heures.

Valider la signature (optionnel)

Si vous le désirez, vous pouvez valider que le webhook provient bien de Dialog Insight grâce à la signature qui est incluse dans l'en-tête de chaque envoi. Cette en-tête HTTP est nommée "X-DI-Signature".

Fonctionnement : 

1. Le webhook est envoyé à votre URL.
2. Votre page récupère l'en-tête HTTP nommée "X-DI-Signature".
3. Votre page valide la valeur "X-DI-Signature" avec la clé publique XML ou PEM (obtenue à la page de configuration de votre webhook).
4. Si la comparaison est valide, vous traitez les données reçues, autrement vous rejetez l'appel.

Vous trouverez ci-après des exemples de vérification de signature C# et un autre en PHP.