Comment fonctionnent et se configurent les webhooks Evalandgo ?

Comment fonctionnent et se configurent les webhooks Evalandgo ?

Les webhooks permettent à Evalandgo de notifier automatiquement vos systèmes externes en temps réel, à chaque étape du parcours d'un répondant. C'est le moyen idéal pour connecter vos questionnaires à vos outils (Zapier, Make, un CRM, une application maison) sans intervention manuelle.

Alert
Fonctionnalité disponible uniquement pour les clients disposant d'un abonnement PRO+ ou PRO+ Équipe.

Créer et configurer un webhook en 5 étapes

  1. Rendez-vous dans le module Connecteur de votre compte (menu principal → Connecteur).
  2. Cliquez sur l'onglet Webhooks.
  3. Cliquez sur Créer un webhook.
  4. Renseignez les informations suivantes :
    • Nom du webhook : un identifiant lisible (max 50 caractères)
    • URL de callback : l'adresse où Evalandgo enverra les notifications (HTTPS obligatoire, max 2 000 caractères)
    • Questionnaire cible : associez le webhook à un questionnaire précis, ou laissez vide pour un webhook global (déclenchement sur tous vos questionnaires)
    • Événements à écouter : cochez les étapes du parcours répondant que vous souhaitez suivre
  5. Cliquez sur Enregistrer.

Le webhook est maintenant actif et se déclenchera automatiquement aux événements que vous avez sélectionnés.

Les trois événements disponibles

Un webhook se déclenche sur l'un des trois événements suivants du parcours d'un répondant :

  • started : le répondant a cliqué sur le lien du questionnaire et accède à la première page.
  • in_progress : le répondant progresse dans le questionnaire (à chaque changement de page).
  • finished : le répondant a soumis ses réponses et le questionnaire est terminé.

Info
Vous pouvez écouter ces trois événements simultanément ou en sélectionner seulement certains, selon vos besoins d'intégration.

Le contenu de la notification webhook

À chaque événement, Evalandgo envoie une requête POST au format JSON à votre URL de callback. Le payload contient :

  • L'identifiant du répondant et son historique de réponses
  • Les informations du contact (email, prénom, nom) si disponibles
  • Le questionnaire concerné (ID et titre)
  • Le détail de chaque réponse saisie (texte, choix, score, etc.)
  • Les scores ou calculs générés par le questionnaire
  • Pour les pièces jointes : un lien de téléchargement direct et valide, exploitable immédiatement par votre outil tiers sans authentification supplémentaire

Cette notification vous permet de traiter les réponses en temps réel dans votre système d'information (ajout de contact en CRM, déclenchement d'une automatisation, création d'un enregistrement, etc.).

Règles essentielles de livraison des webhooks

Avant de connecter vos questionnaires, connaissez les garanties et limites des webhooks Evalandgo :

Un seul envoi, sans nouvelle tentative : chaque notification est envoyée une seule fois, au moment exact de l'événement. En cas d'échec (serveur indisponible, trop lent, erreur HTTP), la notification est définitivement perdue. Le délai d'attente avant timeout est de 5 secondes.

Ne faites pas du webhook votre seule source de vérité : prévoyez une reprise périodique via l'API Evalandgo pour récupérer les réponses éventuellement manquées suite à des déconnexions réseau ou des indisponibilités temporaires.

Les appels ne sont pas signés (HMAC) : traiter l'adresse de callback comme un secret. N'utilisez pas une URL devinable ; complétez-la d'un token ou d'une clé privée côté votre application si possible.

L'interrupteur actif/inactif ne met pas en pause les envois : il n'existe pas de mécanisme de mise en pause. Pour arrêter réellement un webhook, supprimez-le ou retirez tous les événements écoutés.

InfoBon à savoir : Les erreurs d'envoi (timeout, erreur HTTP 4xx/5xx, exception réseau) sont enregistrées côté serveur Evalandgo mais ne s'affichent pas dans votre interface. Si vous soupçonnez un problème, contactez notre support en fournissant la date et l'heure approximative de l'incident.

Cas d'usage courants

Ajouter automatiquement un contact en CRM : configurez un webhook global sur l'événement finished pointant vers votre CRM ou vers Zapier/Make. À la soumission du questionnaire, Evalandgo pousse les réponses (email, nom, etc.) vers le CRM, où une règle ajoute le nouveau contact.

Déclencher une automatisation selon la réponse : via Zapier ou Make, écoutez l'événement finished et routez vers différentes actions selon le contenu des réponses (par exemple : score élevé → envoi à l'équipe commerciale, score faible → envoi vers support).

Logger les réponses dans une base de données : créez un webhook pointant vers votre application maison. À chaque événement, Evalandgo envoie le détail des réponses, que votre application écrit en base de données en temps réel.

Questions fréquentes

Pourquoi mon webhook ne se déclenche-t-il pas ? Vérifiez que (1) votre offre est PRO+ ou PRO+ Équipe, (2) le questionnaire est actif et accessible, (3) l'URL est bien en HTTPS, (4) l'événement est bien coché dans la configuration du webhook.

Y a-t-il des relances en cas d'échec d'envoi ? Non. Le webhook n'est jamais renvoyé automatiquement. Si l'envoi échoue, la notification est perdue définitivement.

Puis-je créer un webhook global pour tous mes questionnaires ? Oui. Au lieu de sélectionner un questionnaire précis, laissez le champ vide. Le webhook se déclenchera sur tous les questionnaires de votre compte. (Note : via l'API REST, un questionnaire spécifique reste obligatoire.)

Puis-je router mes réponses vers un outil de marketing automation ? Oui. Evalandgo envoie l'événement et le détail des réponses vers votre URL. C'est ensuite à votre outil (Zapier, Make ou votre solution) d'appliquer votre logique métier (segmentation, enrichissement, décision, action).

InfoBon à savoir : Les webhooks sont particulièrement puissants quand ils sont associés à l'API Evalandgo. Vous pouvez enrichir les données en temps réel en interrogeant l'API pour obtenir des informations complémentaires (résultats détaillés, scoring avancé, contacts enrichis), tout en synchronisant via le webhook.

Articles complémentaires

Besoin d'aide ?

Les webhooks sont une fonctionnalité technique. Contactez notre équipe au 04 67 17 96 77 pour valider votre configuration, résoudre un dysfonctionnement, ou discuter d'une intégration complexe.


Métadescription (155 caractères max) : Découvrez comment configurer les webhooks Evalandgo pour notifier vos systèmes externes en temps réel à chaque étape de réponse d'un répondant.

Mots-clés SEO (5-8) : webhooks, intégration, API, Zapier, Make, connecteur, notification, automation