> ## 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

> Senden Sie Echtzeit-Ereignisdaten an Ihren eigenen Endpunkt.

Webhooks sind die generische Option, um Scanova-Daten in Ihre eigenen Systeme zu bekommen: Wählen Sie einen Datenstrom, geben Sie Scanova eine Endpunkt-URL, und Scanova sendet diese Daten in Echtzeit per POST an Ihren Server, sobald die Ereignisse eintreten – ohne dass eine Drittanbieter-App dazwischengeschaltet ist.

## Voraussetzungen

* Ein HTTPS- (oder HTTP-)Endpunkt, der `POST`-Anfragen entgegennimmt und mit einem 2xx-Statuscode die Zustellung bestätigt.
* Falls Sie Lead-Daten senden möchten: mindestens eine Lead-Liste oder ein Form-Builder-Formular, das bereits als Quelle eingerichtet ist.

## Einen Webhook einrichten

Webhooks öffnen sich als eigene vollständige Seite (kein Seitenpanel).

<Steps>
  <Step title="Webhooks-Integration öffnen">
    Wählen Sie unter **Integrations** die Option **Add Integration**, suchen Sie die **Webhooks**-Kachel und wählen Sie **Setup**.
  </Step>

  <Step title="Zu sendende Daten wählen">
    Wählen Sie eine der folgenden Optionen:

    * **Scan Analytics Data** – Scan-Ereignisse für Ihre QR-Codes.
    * **Event Tracking Data** – benutzerdefinierte Event-Tracking-Daten.
    * **Lead List Data** – Formular- oder Lead-Listen-Einsendungen.
  </Step>

  <Step title="Quelle wählen (nur Lead List Data)">
    Haben Sie **Lead List Data** gewählt, legen Sie zusätzlich fest, aus welcher Lead-Liste oder welchem Form-Builder-Formular die Einsendungen stammen sollen.
  </Step>

  <Step title="Endpunkt-URL eingeben">
    Geben Sie die vollständige `https://`- (oder `http://`-)URL ein, an die Scanova per POST senden soll. Wählen Sie **Add another URL**, um denselben Payload an bis zu 5 Endpunkte insgesamt zu senden.
  </Step>

  <Step title="Webhook erstellen">
    Wählen Sie **Create webhook**. Scanova beginnt sofort, passende Ereignisse per POST an jede von Ihnen konfigurierte URL zu senden, sobald sie eintreten.
  </Step>
</Steps>

<Note>
  Scanova sendet Ereignis-Payloads in Echtzeit per POST an Ihren Endpunkt. Ihr Endpunkt sollte mit einer 2xx-Antwort die Zustellung bestätigen – eine Nicht-2xx-Antwort löst keinen automatischen erneuten Versuch aus.
</Note>

## Einen bestehenden Webhook bearbeiten

Das Öffnen eines Webhooks über **Active Connections** öffnet erneut dasselbe Formular, bereits vorausgefüllt. Da das Lesemodell pro Verbindung nur eine aufgelöste URL bereitstellt, zeigt die Bearbeitung ein einzelnes URL-Feld, selbst wenn die ursprüngliche Einrichtung mehrere URLs enthielt.

## Welche Daten wohin fließen

Je nach gewähltem Datentyp sendet Scanova Scan-Ereignisse, Event-Tracking-Ereignisse oder Lead-/Formular-Einsendungen als JSON-Payload an jede konfigurierte Endpunkt-URL, sobald das zugrunde liegende Ereignis eintritt.

## Weiterführende Informationen

* [Slack](/de/integrations/slack) – eine ähnliche ereignisgesteuerte Integration, spezifisch auf Slack-Kanäle beschränkt.
* [Zapier](/de/integrations/zapier) – leitet dieselbe Art von Ereignisdaten über Zapiers App-Katalog statt über eine rohe URL.
* [Google Analytics (GA4)](/de/integrations/google-analytics) – eine weitere serverseitige Daten-Export-Integration für Scan-/Event-Daten.
* [Management API overview](/de/api-reference/management-api/overview) – dieselben Daten nach eigenem Zeitplan abrufen, statt Push-Ereignisse zu empfangen.