Les webhooks permettent à deux systèmes d'interagir entre eux. Vous pouvez utiliser un webhook pour lier à votre programme Qualifio à d'autres services afin de recevoir des notifications sur des événements qui se produisent dans votre programme de fidélité.
Cela fonctionne comme suit : lorsqu'un événement a lieu, Qualifio crée une notification détaillée et envoie celle-ci à l'URL que vous avez définie.
Techniquement parlant, pour chaque événement, Qualifio envoie une requête POST à votre URL avec les détails de l'événement au format JSON.
Maintenant que nous comprenons brièvement comment fonctionnent les webhooks, pourquoi les utiliser ?
Pourquoi configurer un webhook ?
L'avantage du webhook, c'est qu'il envoie des notifications en temps réel, ouvrant ainsi de nombreuses possibilités pour automatiser vos tâches marketing.
Voici quelques exemples d'utilisation de webhooks :
- Déclencher des e-mails suite à un événement. Vous pouvez utiliser un webhook pour établir une connexion avec votre logiciel d'automatisation marketing et déclencher un scénario automatisé suite à un événement. Par exemple, envoyer un e-mail à vos nouveaux membres disant "Merci d'avoir rejoint le club, vous venez de gagner 10 points de fidélité" ; les informer lorsqu'ils atteignent un certain niveau ; ou leur envoyer un message avec leur solde de points tous les mois.
- Synchroniser les données des membres entre deux systèmes. Les charges utiles des webhooks contiennent toutes les données relatives à l'événement déclencheur, y compris des informations sur le membre, comme son identifiant et son adresse e-mail. Cela signifie que vous pouvez envoyer des données actualisées à votre CRM, par exemple si la date de naissance d'un membre est modifiée.
Comment configurer un webhook ?
Premiers pas
Définissez une URL pour recevoir les notifications d'événements dans votre solution, c'est-à-dire l'URL vers laquelle les charges utiles seront envoyées. Vous aurez besoin de cette URL pour configurer le webhook.
Zapier est un outil d'automatisation no-code qui vous permet de connecter Qualifio à un autre service via un webhook. Vous pouvez générer une URL unique en utilisant cette plateforme d'intégration.
Après avoir obtenu une URL webhook (via Zapier ou autre), il faut procéder en trois étapes :
Étape 1 : Créer une intégration de webhook
Commencez par configurer votre premier webhook à l'aide de la page Intégrations. Qualifio permet de définir plusieurs webhooks.
Vous devez être un administrateur pour gérer les webhooks.
Pour configurer une nouvelle intégration webhook, vous devez vous rendre dans le back-office de votre programme et :
- Accéder aux Intégrations de votre compte.
- Cliquer sur Connecteurs.
- Cliquer sur Configurer une intégration.
- Saisir un nom pour le webhook.
- Dans l'onglet Variables globales, saisir l'URL webhook.
Qualifio peut éventuellement signer les événements de webhook qu'il envoie à votre point de terminaison en incluant une signature dans l'en-tête de chaque événement. Spécifiez un secret pour vérifier les événements que Qualifio envoie à vos points de terminaison.
Sur la même page, vous pouvez maintenant activer votre intégration webhook en faisant glisser le bouton "Active" dans le coin supérieur droit vers l'état activé (le bouton va alors devenir bleu).
Étape 2 : Gérer des règles de push et choisir les types de notifications
Vous pouvez personnaliser les notifications qui vous informent des événements qui se produisent dans votre programme.
Pour choisir les notifications que vous souhaitez recevoir, vous devez :
- Ouvrir les Intégrations et cliquer sur Règles de push de données.
- Sélectionner un ou plusieurs programme(s). Notez que les règles de push sont spécifiques au programme : la configuration que vous indiquez peut s'appliquer à un ou plusieurs programme(s).
- Dans la colonne Événements, choisir le type d'événements dont vous voulez que Qualifio vous informe. Cette manipulation permettra à la solution tierce d'être avertie lorsqu'un des événements sélectionnés se produira (voir ci-dessous).
- Sous Destinations du push, sélectionner une ou plusieurs intégrations.
- Cliquer sur le bouton d'ajout.
- Cliquer sur Sauvegarder.
Les types d'abonnement aux événements suivants sont disponibles :
- Création de profil est déclenché lorsqu'un membre s'inscrit au programme de fidélité.
- Changement de niveau est déclenché lorsqu'un membre monte ou descend d'un niveau.
- Gain de points est déclenché lorsqu'un membre gagne des points.
- Dépense de points est déclenché lorsqu'un membre échange ses points contre une récompense.
- Ajustement du solde (+) est déclenché lorsque le solde de points d'un membre est ajusté manuellement pour un montant positif (crédit via le CRM).
- Ajustement du solde (-) est déclenché lorsque le solde de points d'un membre est ajusté manuellement pour un montant négatif (débit via le CRM).
- Offre de récompense est déclenché quand un membre se voit offrir une récompense gratuite (via le CRM).
- Ajout d'un identifiant est déclenché lorsqu'un nouvel identifiant est ajouté au profil d'un membre. Exemple : lorsqu'un membre lie son compte Facebook via le widget des réseaux sociaux, Qualifio récupère son identifiant Facebook et l'ajoute à son profil CRM.
Pour en savoir plus sur les événements que vous recevez sur les webhooks qui ont été liés à votre programme, voir cette FAQ portant sur les webhooks.
Étape 3 : Tester l'inscription webhook et analyser vos logs
Pour consulter les rapports d'événements du webhook, connectez-vous avec votre compte administrateur. Choisissez Paramètres dans le menu supérieur, puis choisissez Rapports d'événements.
Les rapports d'événements vous montrent à la fois la requête webhook envoyée et la réponse webhook reçue. Ce système de suivi est utile pour la correction des événements liées aux webhooks.
Comment sécuriser mon webhook ?
Valider votre notification d'événement webhook
Un message ne provenant pas de Qualifio peut potentiellement compromettre votre application.
Qualifio peut signer les événements de webhook qu'il envoie à vos applications. Nous ajoutons alors un en-tête appelé "X-Qualifio-Signature" à chaque requête.
La valeur de cet en-tête est une signature SHA-256 (algorithme de chiffrement) générée à l'aide de votre secret et de la charge utile de la requête.
Vous pouvez choisir de valider la notification du webhook en calculant la signature et en la comparant avec la valeur de l'en-tête. Pour plus d'informations, voir Vérification des signatures webhook.
Mettre en liste blanche nos addresses IP
Pour ajouter une couche supplémentaire de sécurité, vous pouvez également choisir de créer une liste blanche d'adresses IP.
Ce mécanisme permettra de vous assurer que les requêtes webhook proviennent bien de Qualifio. Il est particulièrement utile si votre serveur bloque le trafic de toutes les adresses IP, à moins qu'elles n'aient été placées sur une liste blanche.