> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scanova.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Webhooks

> Envoyez des données d'événements en temps réel vers votre propre point de terminaison.

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).

<Steps>
  <Step title="Ouvrir l'intégration Webhooks">
    Depuis **Integrations**, sélectionnez **Add Integration**, puis trouvez la carte **Webhooks** et sélectionnez **Setup**.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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.
  </Step>
</Steps>

<Note>
  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.
</Note>

## 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](/fr/integrations/slack) — une intégration événementielle similaire, limitée spécifiquement aux canaux Slack.
* [Zapier](/fr/integrations/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)](/fr/integrations/google-analytics) — une autre intégration de sortie de données côté serveur pour les données de scan/événement.
* [Management API overview](/fr/api-reference/management-api/overview) — récupérez les mêmes données selon votre propre calendrier plutôt que de recevoir des événements push.