Skip to main content
Les webhooks sont l’option générique pour faire entrer les données Scanova dans vos propres systèmes : choisissez un flux de données, donnez à Scanova une URL de point de terminaison, et il envoie ces données en POST vers votre serveur en temps réel à mesure que les événements se produisent — sans application tierce intermédiaire.

Prérequis

  • Un point de terminaison HTTPS (ou HTTP) qui accepte les requêtes POST et renvoie un code de statut 2xx pour accuser réception.
  • Si vous prévoyez d’envoyer des données de leads : au moins une liste de leads ou un formulaire du Form-builder déjà configuré comme source.

Configurer un webhook

Les webhooks s’ouvrent comme leur propre page complète (pas un panneau latéral).
1

Ouvrir l'intégration Webhooks

Depuis Integrations, sélectionnez Add Integration, puis trouvez la carte Webhooks et sélectionnez Setup.
2

Choisir les données à envoyer

Sélectionnez l’une des options suivantes :
  • Scan Analytics Data — événements de scan pour vos QR codes.
  • Event Tracking Data — données de suivi d’événements personnalisées.
  • Lead List Data — soumissions de formulaire ou de liste de leads.
3

Choisir une source (Lead List Data uniquement)

Si vous avez choisi Lead List Data, sélectionnez aussi la liste de leads ou le formulaire du Form-builder dont doivent provenir les soumissions.
4

Saisir l'URL du point de terminaison

Saisissez l’URL complète en https:// (ou http://) vers laquelle Scanova doit envoyer les données en POST. Sélectionnez Add another URL pour envoyer la même charge utile à jusqu’à 5 points de terminaison au total.
5

Créer le webhook

Sélectionnez Create webhook. Scanova commence à envoyer en POST les événements correspondants vers chaque URL que vous avez configurée dès qu’ils se produisent.
Scanova envoie les charges utiles d’événements en POST vers votre point de terminaison en temps réel. Votre point de terminaison doit renvoyer une réponse 2xx pour accuser réception — une réponse autre que 2xx ne déclenche pas de nouvelle tentative automatique.

Modifier un webhook existant

Ouvrir un webhook depuis Active Connections rouvre le même formulaire, pré-rempli. Comme le modèle de lecture n’expose qu’une seule URL résolue par connexion, la modification affiche un seul champ URL même si la configuration d’origine en comportait plusieurs.

Quelles données circulent où

Selon le type de données choisi, Scanova envoie des événements de scan, des événements de suivi, ou des soumissions de lead/formulaire sous forme de charge utile JSON vers chaque URL de point de terminaison configurée, dès que l’événement sous-jacent se produit.

À voir aussi

  • Slack — une intégration événementielle similaire, limitée spécifiquement aux canaux Slack.
  • Zapier — achemine le même type de données d’événements via le catalogue d’applications de Zapier plutôt qu’une URL brute.
  • Google Analytics (GA4) — une autre intégration de sortie de données côté serveur pour les données de scan/événement.
  • Management API overview — récupérez les mêmes données selon votre propre calendrier plutôt que de recevoir des événements push.