Eine Link-Tracking-Plattform hält fest, was mit Ihren Links passiert ist. Über einen Webhook informiert die Plattform Ihre anderen Systeme in dem Moment, in dem es passiert, statt darauf zu warten, dass jemand ins Dashboard schaut. Erst diese Kombination sorgt dafür, dass ein neuer Kampagnenlink im CRM auftaucht, sobald er erstellt ist, oder dass das Öffnen eines Secret-Links ein Ticket aktualisiert.
Wer eine Link-Tracking-Plattform mit Webhook-Integrationen auswählt, muss über „hat Webhooks“ hinausschauen: Welche Ereignisse sendet sie, wie sichert sie sie ab, und was sendet sie nicht? Dieser Leitfaden behandelt all das, außerdem den Aufbau eines zuverlässigen Empfängers und die Frage, wann die API das bessere Werkzeug ist.
Wofür Webhooks einer Link-Plattform da sind
Drei Aufgaben tauchen immer wieder auf.
- Systeme synchron halten. Ein auf der Plattform erstellter Link erscheint mit Kürzel und Ziel im Kampagnendatensatz Ihres CRM oder Projekttools, ohne dass ihn jemand kopiert.
- Abläufe auslösen. Ein geöffneter Secret-Link markiert eine Übergabe als abgeschlossen. Wird einer gelöscht, ohne dass der Empfänger den Erhalt bestätigt hat, öffnet das einen Vorfall.
- Ein Data Warehouse befüllen. Ereignisse landen erst in einer Warteschlange und dann in einer Tabelle, wo sie mit Ihren übrigen Daten zusammengeführt werden.
Zum Zählen eignen sich Webhooks dagegen nicht. Ein Dashboard, das pro Webhook eine Zahl hochzählt, weicht vom Bericht der Plattform ab, sobald eine Zustellung zum ersten Mal wiederholt wird oder sich verspätet. Nehmen Sie die API oder einen Export für Zahlen und Webhooks für Aktionen.
Auf welche Ereignisse Sie achten sollten
Plattformen senden unterschiedliche Ereignisse. Fragen Sie nach der Liste, nicht nach der Funktion.
| Ereignisgruppe | Typische Ereignisse | Geeignet für |
|---|---|---|
| Lebenszyklus eines Links | erstellt, geändert, gelöscht | Abgleich mit dem CRM, Prüfpfad, versehentliche Änderungen erkennen |
| Lebenszyklus eines Geheimnisses | erstellt, angezeigt, gelöscht | Bestätigung der Übergabe, Auslöser für Vorfälle |
| Klickereignisse | pro Klick oder gebündelt | Automatisierung in Echtzeit, bei hohem Volumen |
| Domain-Ereignisse | verifiziert, Zertifikat ausgestellt | Benachrichtigungen für den Betrieb |
Die Webhooks von LinkPilot decken den Lebenszyklus von Links
(link.created, link.updated, link.deleted) und von Geheimnissen
(secret.created, secret.viewed, secret.burned) ab. Klickdaten gibt
es über die Statistik-API und den CSV-Export, nicht als Webhook pro
Klick. Für die meisten Teams ist das die richtige Aufteilung: Klicks
sind Berichtsdaten in großer Menge, während Lebenszyklus-Ereignisse
diejenigen sind, die etwas auslösen sollten.
Wenn Ihr Ablauf tatsächlich auf jeden einzelnen Klick reagieren muss, klären Sie, ob die Plattform die Ereignisse bündelt oder drosselt. Sonst bauen Sie einen Empfänger, der beim ersten viralen Beitrag zusammenbricht.
Was Sie außerdem prüfen sollten
- Signatur. Jede Zustellung sollte eine Signatur tragen, die mit einem Secret berechnet wird, das Sie besitzen, damit Ihr Endpunkt Fälschungen ablehnen kann. Eine Plattform, die Webhooks unsigniert verschickt, verlangt von Ihnen, jedem POST-Request zu vertrauen.
- Wiederholungen und Reihenfolge. Finden Sie heraus, wie oft und über welchen Zeitraum eine fehlgeschlagene Zustellung wiederholt wird, und rechnen Sie damit, dass Ereignisse in falscher Reihenfolge ankommen.
- Ereignis-IDs. Erst eine eindeutige ID pro Ereignis macht Idempotenz möglich.
- Verwaltung der Endpunkte. Mehrere Endpunkte pro Workspace, Abonnements pro Ereignis und ein Zustellprotokoll, das Sie lesen können, wenn etwas schiefgeht.
- Die API daneben. Webhooks für Auslöser, die API für alles andere.
Prüfen Sie, ob sich Links erstellen, Statistiken abrufen und Exporte
anstoßen lassen, alles programmatisch, und ob sich Schlüssel auf
bestimmte Rechte beschränken lassen. Die API von LinkPilot nutzt
Bearer-Schlüssel mit dem Präfix
lp_live_und ist in jedem Tarif enthalten. - Teamzugriff. Wer einen Webhook-Endpunkt hinzufügen darf, ist wichtig, denn ein Endpunkt empfängt Daten. Rollen sollten es einem Admin erlauben, Endpunkte zu verwalten, und alle anderen davon ausschließen.
Einen Empfänger bauen, der nicht zusammenbricht
- Prüfen Sie zuerst die Signatur. Berechnen Sie die erwartete Signatur aus dem unveränderten Body und Ihrem Secret, vergleichen Sie in konstanter Zeit und lehnen Sie alles ab, was die Prüfung nicht besteht, noch bevor Sie es parsen.
- Bestätigen Sie schnell. Antworten Sie innerhalb von ein, zwei Sekunden mit einem 2xx. Erledigen Sie die eigentliche Arbeit über eine Warteschlange, damit ein langsames CRM keine Wiederholungen auslöst.
- Speichern Sie Ereignis-IDs und überspringen Sie alle, die Sie schon kennen. Wiederholungen sind normal, doppelte Verarbeitung ist Ihr Fehler.
- Ordnen Sie Felder ausdrücklich zu. Übernehmen Sie Kürzel, Ziel, Tags und Zeitstempel, die Sie brauchen, in Ihr eigenes Schema. Speichern Sie nicht den ganzen Payload als verbindliche Quelle: Er ist eine Benachrichtigung, kein Datensatz.
- Protokollieren Sie jede Zustellung mit ID und Ergebnis. Wenn das Protokoll der Plattform „zugestellt“ meldet und in Ihrem System nichts passiert ist, können Sie dann nachvollziehen, wo das Ereignis geblieben ist.
- Schlagen Sie Alarm bei Stille. Wenn ein Endpunkt, der sonst stündlich Ereignisse erhält, einen Tag lang nichts bekommt, ist auf einer der beiden Seiten etwas kaputt.
Testen Sie vor der ersten echten Kampagne mit einem Staging-Endpunkt und der Testzustellung der Plattform. Erstellen Sie einen Link, ändern Sie ihn, löschen Sie ihn, und sehen Sie zu, wie die drei Ereignisse ankommen.
Die Daten schützen
Webhook-Payloads beschreiben Links und Geheimnisse, keine Menschen. Sorgen Sie dafür, dass das so bleibt.
- Keine personenbezogenen Daten in Kürzeln oder Tags, denn sie reisen in jedem Payload zu diesem Link mit.
- Beschränken Sie den Endpunkt per Signatur und, wo möglich, per Absenderadresse auf den Datenverkehr der Plattform.
- Bewahren Sie das Signing-Secret in einem Secrets Manager auf, nicht in der Konfigurationsdatei des Empfängers, und erneuern Sie es nach Plan. Wenn Sie das Secret an einen externen Dienstleister geben müssen, der den Empfänger baut, schicken Sie es als Einmal-Link. Der Leitfaden zum Webhook-Signing-Secret beschreibt diese Übergabe.
- Denken Sie an die Einwilligung, wenn Klickdaten in ein CRM fließen. Ein Klick, der mit einer Kundin oder einem Kunden verknüpft ist, gilt nach den meisten Datenschutzregeln als personenbezogenes Datum.
Die Integration selbst messen
- Zustellquote laut Protokoll der Plattform.
- Verarbeitungsverzug vom Zeitstempel des Ereignisses bis zum Datensatz in Ihrem System.
- Duplikatquote, die niedrig sein sollte, aber nie null sein wird.
- Abgleich: Vergleichen Sie einmal pro Woche die Zahl der Links und die Klicksummen aus der API mit dem, was Ihre Systeme enthalten. Abweichungen bedeuten eine verlorene Zustellung oder einen Fehler im Empfänger.
Mit einer Link-Tracking-Plattform mit Webhooks werden Ihre Links Teil Ihrer übrigen Systeme. Wählen Sie eine, die signiert, was sie sendet, Ihnen genau sagt, welche Ereignisse es gibt, und Ihnen eine API für die Zahlen gibt. Bauen Sie den Empfänger dann so, als wären Wiederholungen der Normalfall, denn das sind sie.