Skip to main content
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).
1

Webhooks-Integration öffnen

Wählen Sie unter Integrations die Option Add Integration, suchen Sie die Webhooks-Kachel und wählen Sie Setup.
2

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

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

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

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

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 – eine ähnliche ereignisgesteuerte Integration, spezifisch auf Slack-Kanäle beschränkt.
  • Zapier – leitet dieselbe Art von Ereignisdaten über Zapiers App-Katalog statt über eine rohe URL.
  • Google Analytics (GA4) – eine weitere serverseitige Daten-Export-Integration für Scan-/Event-Daten.
  • Management API overview – dieselben Daten nach eigenem Zeitplan abrufen, statt Push-Ereignisse zu empfangen.