Les webhooks sont un outil permettant d'avertir vos systèmes externes lorsqu'une nouvelle participation se produit dans le cadre de vos campagnes Qualifio. Les détails des participations sont envoyés en temps réel à une URL que vous configurez.
Regardons de plus près à quoi ressemblent les événements que vous recevrez sur le webhook 2.0.
Qu'est-ce qu'un webhook ?
La mécanique de base des webhooks peut être considérée comme une notification "push". Au contraire d'une API, il n'est pas nécessaire d'interroger vos données toutes les quelques minutes pour savoir s'il y a de nouvelles informations. Les webhooks poussent immédiatement l'information vers l'application de votre choix, via une URL appelée point de terminaison (endpoint).
Dans Qualifio, les webhooks sont déclenchés pour chaque nouvelle participation. Lorsque cela se produit, Qualifio envoie vers votre point de terminaison une notification (en termes techniques, une requête POST au format JSON) contenant des données sur la participation. Ensuite, vous pouvez faire ce que vous voulez avec les données de participation que vous récupérez.
Comment mettre en place un webhook ?
Pour cette forme d'intégration, l'aide d'un développeur est souvent nécessaire. Il est également possible d'utiliser les webhooks avec Zapier.com, afin d'envoyer les informations vers n'importe quel service supporté par cette plateforme, sans vous y connaître en programmation.
- Tout d'abord, allez à la page Webhook dans Qualifio. Pour ce faire, rendez-vous sur la page Intégrations, dans la section du même nom.
- Sur la page Webhook 2.0 :
a. Nom de cette intégration : entrez un nom d'affichage pour le webhook.
b. Définissez comment vous voulez traiter les participations incomplètes.
c. Webhook host : saisissez l'URL du système vers lequel les événements seront envoyés. Pour sécuriser votre webhook, nous vous recommandons d'utiliser une URL https:// pour votre point de terminaison.
d. Authorisation header : il est possible d'authentifier les requêtes webhook en envoyant les informations de ces champs dans les en-têtes. Pour plus d'informations, consultez Configuration de l'authentification pour le webhook.
e. Webhook secret : Qualifio peut éventuellement signer les événements 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 webhook.
f. Une fois que vous avez ajouté votre nouveau webhook, cliquez sur Sauvegarder au bas de la page.
Vous voyez, c'est simple !
Gérer les webhooks
Si vous souhaitez être informé(e) uniquement lorsqu'une participation a lieu sur un site spécifique ou dans le cadre de campagnes spécifiques, veuillez consulter la section Paramétrer le push de données dans Qualifio.
Dans l'étape Paramètres de vos campagnes, vous pouvez voir la liste des push actifs. Vous devez être administrateur pour gérer cela.
Exemple d'événement (payload)
Une fois qu'un webhook est déclenché, une charge utile (payload) est livrée à l'URL spécifiée. Voici un exemple de payload.
Chaque événement suit une structure JSON similaire avec des informations associées à la participation : https://integrations.qualifio.com/schemas/webhook/v2/index.html
Pensez à créer des variables de mapping et à les relier à vos questions, champs de formulaire et opt-ins afin de récupérer facilement les différentes valeurs dans la charge utile de la webhook (sous l'objet "variables").
Test de votre webhook
Bien que nous n'offrions pas de fonctionnalité native pour tester votre webhook, il existe toute une série de services gratuits pour cela. Nous utilisons notamment webhook.site. Vous pouvez y obtenir une URL d'essai, configurer Qualifio pour envoyer des webhooks à cette URL, puis examiner les données reçues. De cette façon, vous pouvez tester votre webhook.
Foire aux questions sur les webhooks
Combien de temps faut-il pour que Qualifio mette à jour le webhook ?
Les paramètres du webhook peuvent être mis en cache pendant 30 minutes au maximum. Lorsque vous modifiez l'URL du webhook, les données d'authentification ou d'autres paramètres, il peut donc s'écouler jusqu'à 30 minutes avant que vos modifications soient prises en compte.
Qualifio fournit-il des webhooks en temps réel ?
Oui, à ceci près que nous vous envoyons un seul événement par participation. Ainsi, lorsque de nombreuses participations ont eu lieu dans un court laps de temps, n'oubliez pas que cela pourrait retarder la transmission des informations. Nous ne garantissons pas que les notifications soient reçues en temps réel (plutôt en temps quasi-réel).
Comment interpréter une différence entre les statistiques Qualifio et les données poussées ?
Il se peut que vous remarquiez des différences entre les statistiques Qualifio (statistiques de campagne ou Global Stats) et les données obtenues par le biais de webhooks. En effet, dans les statistiques Qualifio, nous considérons une participation comme terminée à condition que le formulaire ait été soumis (campagnes identifiées). Dans le cadre des webhooks, une participation sera considérée comme terminée si l'écran de sortie a été affiché.
Voilà pour la vue d'ensemble. Cette page n'a pas la prétention d'être exhaustive ; il s'agit plutôt d'une introduction à la solution que représentent les webhooks. Poursuivez votre apprentissage en consultant notre documentation dédiée destinée aux développeurs.
Pour plus d'informations sur l'utilisation des webhooks ou si vous avez besoin d'éclaircissements, n'hésitez pas à nous contacter.