adsquiz

Webhook

Webhook-Integration in AdsQuiz einrichten

Ein Webhook ist eine Technologie, die Daten automatisch von einem System an ein anderes sendet, sobald ein bestimmtes Ereignis eintritt. Einfach gesagt: eine Möglichkeit, Daten ohne manuelle Arbeit von Punkt A nach Punkt B zu bringen. In AdsQuiz wird der Webhook jedes Mal ausgelöst, wenn ein Nutzer eine Anfrage im Quiz absendet, und sendet alle Daten automatisch an den angegebenen Dienst.

Ein Webhook ist ein universelles Werkzeug, das sich mit jedem Dienst verbinden lässt, der Daten über eine URL annimmt. Steht der gewünschte Dienst nicht in der Standardliste der direkten AdsQuiz-Integrationen, löst ein Webhook das Problem.

Was per Webhook gesendet wird

Bei jedem neuen Lead sendet der Webhook automatisch:

  • den Namen des Nutzers
  • die Telefonnummer
  • die E-Mail-Adresse
  • Antworten auf alle Quizfragen
  • UTM-Parameter zur Verfolgung der Traffic-Quelle

Die Sendemethode ist POST.

📌 Beispiel: Benachrichtigungen über neue Leads per Webhook an Slack senden

Gehen wir die Einrichtung an einem konkreten Beispiel durch – dem automatischen Senden von Benachrichtigungen über neue Quiz-Anfragen an einen Slack-Kanal. Das ist praktisch, wenn Ihr Vertriebsteam Slack nutzt und Nachrichten zu neuen Leads sofort erhalten möchte, ohne CRM oder E-Mail zu prüfen. Auf die gleiche Weise richten Sie die Übertragung an jeden anderen Dienst ein, der Incoming Webhooks unterstützt.

⚙️ Schritt 1. Integrationseinstellungen in AdsQuiz öffnen

Gehen Sie zu: Quiz-Einstellungen → Integrationen → Webhook.

In das Integrationsfeld fügen Sie die Webhook-URL ein, die Sie in Slack erhalten.

⚙️ Schritt 2. Incoming Webhook in Slack erstellen

Öffnen Sie Ihr Slack-Konto und gehen Sie zu den Workspace-Einstellungen. Suchen Sie den Bereich Apps und öffnen Sie «Incoming Webhooks». Ist die App noch nicht verbunden, fügen Sie sie Ihrem Workspace hinzu.

Klicken Sie danach auf «Add New Webhook to Workspace». Wählen Sie den Kanal für Benachrichtigungen über neue Leads – zum Beispiel #new-requests oder #quiz-leads.

💡 Tipp: Legen Sie in Slack einen eigenen Kanal nur für Quiz-Benachrichtigungen an – zum Beispiel #leads-quiz. So sehen Manager neue Anfragen sofort, ohne dass sie sich mit anderen Nachrichten vermischen.

Nach der Bestätigung erzeugt Slack eine eindeutige Webhook-URL – kopieren Sie sie.

⚙️ Schritt 3. Webhook-URL in AdsQuiz einfügen

Kehren Sie zu den Integrationseinstellungen in AdsQuiz zurück und fügen Sie die kopierte Webhook-URL in das Feld ein. Klicken Sie auf «Speichern» und aktivieren Sie die Integration.

⚙️ Schritt 4. Verbindung prüfen

Klicken Sie in den AdsQuiz-Integrationseinstellungen auf «Test» – das System sendet eine der letzten 10 Anfragen erneut an Slack, ohne dass Sie das Quiz noch einmal ausfüllen müssen. Prüfen Sie dann im bei der Einrichtung gewählten Slack-Kanal, ob eine Nachricht mit den Lead-Daten erschienen ist.

Ist die Nachricht korrekt angekommen, funktioniert die Integration, und alle neuen Quiz-Anfragen werden automatisch an Slack gesendet.

💡 Wichtig: Testsendungen über die Schaltfläche «Test» verbrauchen kein Lead-Guthaben – nutzen Sie diese Funktion unbegrenzt zum Prüfen und Debuggen der Integration.

⚙️ Schritt 5. Nachrichtenformat einrichten (bei Bedarf)

Standardmäßig erhält Slack die Daten in einem Standardformat. Wenn Sie eine übersichtlichere, gut lesbare Nachricht möchten – etwa mit Name und Telefon in Fettdruck oder mit Emojis –, können Sie das in den Incoming-Webhook-Einstellungen in Slack mit dem Block Kit Builder umsetzen.

💡 Tipp: Schon eine einfache Formatierung erleichtert den Managern die Arbeit deutlich. Fügen Sie zum Beispiel die Überschrift «Neue Quiz-Anfrage» hinzu und stellen Sie die Kontaktdaten in einen eigenen Block – dann ist die Nachricht in einer Sekunde erfasst.

❓ Häufig gestellte Fragen

Kann ein Webhook Daten gleichzeitig an mehrere Dienste senden?
Nein – eine Webhook-URL führt zu einem Dienst. Wenn Sie Daten gleichzeitig an mehrere Dienste senden möchten, nutzen Sie einen Verbindungsdienst wie Make oder Zapier. Mehr dazu: Make einrichten

Welche Daten werden per Webhook gesendet?
Der Webhook sendet alle Daten, die der Nutzer im Quiz hinterlassen hat – Name, Telefon, E-Mail, Antworten auf alle Fragen und UTM-Parameter. Die Sendemethode ist POST.

Brauche ich technische Kenntnisse, um einen Webhook einzurichten?
Die Grundeinrichtung – URL einfügen und speichern – erfordert keine technischen Kenntnisse. 

Ist es sicher, Lead-Daten per Webhook zu senden?
Ja. Die Daten werden über das sichere HTTPS-Protokoll übertragen. Wir empfehlen, die Webhook-URL nicht an Dritte weiterzugeben und sie zu erneuern, wenn Sie vermuten, dass sie kompromittiert wurde.