API & Schnittstelle
Webhook erstellen: Daten aus KlickTipp übertragen
In diesem Beitrag erfährst Du, wie Du einen Webhook in KlickTipp erstellen und nutzen kannst, um Kontaktdaten automatisch an Deine Systeme zu senden.
Was macht ein Webhook? Ein Webhook ermöglicht es Dir, ausgewählte Daten eines Kontakts an eine beliebige URL zu senden, sobald der Kontakt mit einem Tag versehen wird – zum Beispiel, um Deine eigene Datenbank in Echtzeit mit Daten aus KlickTipp zu aktualisieren.
Hinweis für Bestandskunden: Diese KlickTipp Funktion hieß früher → Outbound. Heute findest Du sie im Menü unter → Automatisierung → Webhook.
Schritt-für-Schritt-Anleitung
Wie kannst Du in KlickTipp einen Webhook erstellen?
- Gehe im Menü zu → Automatisierung → Webhook → Neuer Webhook, um Deinen Webhook anzulegen.
- Benenne den Webhook.
- Vergib optional ein Label.
HTTP-Methode und Aktivierungs-URL
- Dein Webhook kann anhand von manuellen Tags, SmartTags und SmartLinks ausgelöst werden.
- Wähle die gewünschte HTTP-Methode → POST oder → GET aus.
- Entscheide, welches Format der POST-Request haben soll: → Form Data oder JSON.
- Trage in das Feld → URL ein, zu welcher URL der Webhook gesendet werden soll.
Mitgesendete Daten
- Wähle aus, welche Felder mit den entsprechenden Vorgabewerten mitgesendet werden sollen
- Alle Felder (Standard): Es sind keine weiteren Einstellungen erforderlich.
- Ausgewählte Felder: Wähle das Feld unter → Felder hinzufügen aus und trage bei → Vorgabewert den gewünschten Wert ein.
- Entscheide, ob Du statische Werte mitsenden möchtest. Diese könnten z. B. ein API-Schlüssel o. Ä. sein.
- Gib den Namen des Parameters an, z. B. → apiKey.
- Trage den dazugehörigen Wert ein, z. B. Deinen API-Schlüssel.
Wie kannst Du einen Webhook testen?
- Wähle einen Kontakt aus, um die Webhook-Daten an Deine Ziel-URL zu versenden.
- Klicke auf → Webhook testen.
- Verläuft der Test erfolgreich, erhältst Du eine Bestätigung in zwei grünen Boxen. Dort siehst Du, dass der Webhook mit den vorher definierten Daten erfolgreich an Deine Ziel-URL gesendet wurde.
Schon gewusst?
Wenn ein Webhook über ein Tag ausgelöst wird, kann er nur alle 6 Stunden ausgeführt werden.
Webhooks, die durch Kampagnen-Aktionen ausgelöst werden, werden hingegen immer sofort ausgeführt.
Mit einem sauber eingerichteten Webhook verbindest Du KlickTipp in Echtzeit mit Deinen Systemen und stellst sicher, dass wichtige Kontaktdaten genau dort ankommen, wo Du sie weiterverarbeiten möchtest.
