Webhooks in Funnelspot nutzen (Daten rein & raus)

Webhooks in Funnelspot nutzen (eingehend & ausgehend)

Zweck

Diese SOP zeigt dir, wie du über Webhooks Daten in Funnelspot empfängst (z.B. von Digistore24) oder Daten aus Funnelspot an eine andere Software versendest — z.B. um externe Tools mit Kontaktdaten zu verbinden.

Zielgruppe

• Nutzer, die Funnelspot mit externen Systemen über Webhooks verbinden möchten
• Technischer Kenntnisstand: Fortgeschritten

Voraussetzungen

• Zugang zum Bereich Automatisierung
• Bei eingehenden Webhooks: Zugang zur externen Plattform (z.B. Digistore24), um dort die Webhook-URL zu hinterlegen
• Bei ausgehenden Webhooks: Ziel-URL des externen Systems, an das Daten gesendet werden sollen

Prozessüberblick

1. Neuen Workflow erstellen
2. Variante A: Eingehenden Webhook einrichten (Daten nach Funnelspot holen)
3. Variante B: Ausgehenden Webhook einrichten (Daten aus Funnelspot senden) — per Custom Webhook oder Post/Get-Webhook
4. Workflow veröffentlichen

Schritt 1: Neuen Workflow erstellen

1. Gehe zu Automatisierung → Workflow erstellen.
2. Starte einen neuen, leeren Workflow.

Variante A: Eingehenden Webhook einrichten (Daten nach Funnelspot holen)

Schritt 2: Trigger "Eingehender Webhook" hinzufügen

1. Klicke auf Neuen Trigger hinzufügen.
2. Wähle Eingehender Webhook aus (falls nicht direkt angezeigt, im Suchfeld "Webhook" eingeben).

Schritt 3: Webhook-URL in der externen Plattform hinterlegen

1. Funnelspot generiert dir automatisch eine Webhook-URL.
2. Kopiere diese URL und hinterlege sie in der externen Plattform (Beispiel: bei Digistore24 unter der IPN-Anbindung).

Wichtig: Schließe das Trigger-Fenster nicht vorzeitig — wird es geschlossen, ändert sich die Webhook-URL/Domain. Richte daher zuerst die komplette externe Anbindung ein, bevor du das Fenster schließt.

Schritt 4: Testdaten empfangen und Felder zuordnen

1. Löse in der externen Plattform einen Testvorgang aus (z.B. einen Testkauf bei Digistore24).
2. Klicke in Funnelspot auf Daten abrufen, um die eingehenden Testdaten zu sehen.
3. Ordne die empfangenen Datenfelder den passenden Kontaktfeldern zu.
4. Lege daraus einen neuen Kontakt an bzw. bestätige das Mapping.

Wichtig: Erst wenn Testdaten erfolgreich ankommen und du das Mapping abgeglichen hast, solltest du den Trigger final speichern.

Variante B: Ausgehenden Webhook einrichten (Daten aus Funnelspot senden)

Schritt 5: Aktion "Webhook" hinzufügen

1. Füge im Workflow eine neue Aktion hinzu und wähle Webhook → Benutzerdefinierter Webhook (Custom Webhook).

Schritt 6a: Option — Custom Webhook manuell konfigurieren

1. Trage die Ziel-Webhook-URL ein, an die die Daten gesendet werden sollen.
2. Definiere die einzelnen Felder, die übergeben werden sollen: Feldname links, Variable (z.B. über Tag-Auswahl "Contact") rechts.
3. Beispiel: Feldname Adresse : Variable Adresse (Contact).

Wichtig: Beim letzten Feld darf kein Komma am Ende stehen — bei allen vorherigen Feldern ist ein Komma erforderlich. Ein rot markierter Fehlerhinweis zeigt an, wenn ein Komma fehlt oder falsch gesetzt ist.

4. Führe einen Testlauf durch, um zu prüfen, ob die Daten korrekt an die Ziel-URL gesendet werden.

Schritt 6b: Alternative — Post- oder Get-Webhook nutzen

1. Wähle statt Custom Webhook die Option Post- oder Get-Webhook.
2. Trage die Felder unter Abfrageparameter ein, z.B. Vorname.
3. Wähle über das Tag-Symbol die passende Variable aus (z.B. Contact → First Name).
4. Wiederhole dies für alle weiteren gewünschten Felder (z.B. Nachname).

Schritt 7: Workflow veröffentlichen

1. Speichere den Workflow.
2. Klicke oben auf Veröffentlichen.

Wichtig: Ohne Veröffentlichung funktioniert der Webhook nicht — dieser Schritt wird häufig vergessen.

Häufige Fehler & Lösungen

Ergebnis-Check

• Eingehender Webhook: Testdaten aus der externen Plattform kommen in Funnelspot an und sind korrekt den Kontaktfeldern zugeordnet
• Ausgehender Webhook: Ein Testlauf zeigt, dass die definierten Felder korrekt an die Ziel-URL übertragen werden
• Der Workflow ist final gespeichert und veröffentlicht

Best Practices

• Richte bei eingehenden Webhooks immer zuerst die komplette externe Anbindung ein, bevor du das Funnelspot-Fenster schließt, um ein Ändern der URL zu vermeiden.
• Prüfe bei Custom Webhooks die Kommasetzung sorgfältig — das ist die häufigste Fehlerquelle.
• Vergiss nach dem Speichern nie das Veröffentlichen des Workflows.
• Bei Fragen: Kontaktiere den Funnelspot-Support unter support@funnelspot.io.

Ergebnis

Du kannst nun sowohl Daten von externen Plattformen wie Digistore24 per eingehendem Webhook in Funnelspot empfangen, als auch Kontaktdaten aus Funnelspot per Custom-, Post- oder Get-Webhook an externe Systeme senden.