Verfügbar ab dem „Marketer“-Tarif.
Über Webhooks informiert Pretty Links andere Systeme wenn etwas passiert. Jedes Mal, wenn ein Link hinzugefügt, bearbeitet, in den Papierkorb verschoben, wiederhergestellt oder entfernt wird, sendet Pretty Links einen HTTP-POST-Request an eine von Ihnen angegebene URL, wobei der JSON-Body beschreibt, was passiert ist.
Dieser Leitfaden ist Teil der Übersicht über das Add-on „Pretty Links Developer Tools“, der Einstiegspunkt für das Add-on „Developer Tools“.
Ein Abonnement hinzufügen
- Gehe zu Dashboard > Pretty Links > Entwickler-Tools > Webhooks.
- Klicken Sie auf Abonnement hinzufügen.
- Bitte ausfüllen:
- Ziel-URL — Die vollständige HTTPS-URL, an die „Pretty Links“ einen POST-Request senden sollen. Dabei handelt es sich in der Regel um eine Webhook-URL, die von Zapier, Make, n8n, Ihrem benutzerdefinierten Endpunkt oder einem eingehenden Webhook von Slack/Teams bereitgestellt wird;
- Veranstaltungstypen — Welche Ereignisse sollen diesen Webhook auslösen (siehe unten);
- Beschreibung — Optionale Bezeichnung, damit Sie wissen, wofür dieses Abonnement gedacht ist.
- Klicken Sie auf Speichern Sie.
Das Abonnement ist nun aktiv. Sobald das nächste übereinstimmende Ereignis eintritt, wird ein POST-Request an Ihre Ziel-URL gesendet.
Veranstaltungstypen
Sie können eine Veranstaltung, mehrere Veranstaltungen oder alle Veranstaltungen abonnieren.
| Veranstaltung | Zündet, wenn |
|---|---|
Link hinzugefügt | Ein neuer Pretty Link wird erstellt |
Link aktualisiert | Ein bereits vorhandener Pretty Link wird bearbeitet |
Link-Trashed | Ein „Pretty Link“ wird in den Papierkorb verschoben |
Link wiederhergestellt | Ein in den Papierkorb verschobener Pretty Link wird aus dem Papierkorb wiederhergestellt |
Link entfernt | Ein „Pretty Link“ wird endgültig gelöscht |
alle | Alles oben Genannte (Sie erhalten jedes Link-Ereignis) |
Auswahl alle Entweder Sie entscheiden sich für ein einziges Abonnement, um alle Ereignisse zu erfassen, oder Sie wählen bestimmte Ereignisse aus, falls Ihr nachgelagertes System beispielsweise nur an der Erstellung neuer Verknüpfungen interessiert ist.
Webhook-Sicherheit: Der PRLI-WEBHOOK-KEY-Header
Ihre Website enthält eine einzige Webhook-Schlüssel — dargestellt in Dashboard > Pretty Links > Entwickler-Tools zusammen mit dem API-Schlüssel. Pretty Links übermittelt diesen Schlüssel in der PRLI-WEBHOOK-KEY Header jedes POST-Aufrufs, den es an eine Ziel-URL sendet, unabhängig davon, welches Abonnement ausgelöst wurde.
Ihr empfangender Endpunkt sollte diesen Header überprüfen. Wenn der Wert mit dem Schlüssel übereinstimmt, den Pretty Links Ihnen im Admin-Bereich anzeigt, ist die Anfrage echt. Wenn er nicht übereinstimmt (oder fehlt), ist die Anfrage gefälscht und Ihr Endpunkt sollte sie ignorieren.
Genau wie den API-Schlüssel können Sie den Webhook-Schlüssel im Admin-Bereich neu generieren, falls er jemals offengelegt wurde. Eine Neugenerierung bedeutet, dass Sie den Vergleichswert in jedem von Ihnen eingerichteten Empfänger aktualisieren müssen.
So schützen Sie Ihren Endpunkt davor, dass jemand gefälschte “Link hinzugefügt”-Payloads an Ihre URL sendet. Ohne die Schlüsselprüfung könnte jeder, der Ihre Webhook-URL errät, Ihre nachgelagerte Automatisierung auslösen.
Bei den meisten Webhook-Empfängern (Zapier, Make, benutzerdefinierter Code) können Sie eingehende Header auslesen. Vergleichen Sie PRLI-WEBHOOK-KEY auf den erwarteten Wert, bevor die Nutzdaten verarbeitet werden.
Ereignisprotokoll
Jede Webhook-Übermittlung – ob erfolgreich oder nicht – wird im Ereignisprotokoll auf dem Bildschirm „Webhooks“ protokolliert. Zu jeder Übermittlung werden folgende Informationen angezeigt:
- Die Art der Veranstaltung;
- Die Ziel-URL, an die die Nachricht gesendet wurde;
- Der HTTP-Antwortcode, den Ihr Endpunkt zurückgegeben hat;
- Die gesamte gesendete Nutzlast.
Dies ist für die Fehlersuche sehr hilfreich. Wenn ein Zap nicht ausgelöst wird, überprüfen Sie das Ereignisprotokoll: Hat Pretty Links den Webhook tatsächlich gesendet? Hat Ihr Endpunkt einen 200er- oder einen 500er-Status zurückgegeben? Entsprach die Nutzlast Ihren Erwartungen?
Test-Versand
Neben jedem Abonnement befindet sich ein Test-Versand Aktion. Wenn Sie darauf klicken, sendet Pretty Links sofort eine Beispiel-Nutzlast an Ihre Ziel-URL, ohne auf ein tatsächliches Ereignis zu warten.
Verwenden Sie „Test-Senden an“:
- Überprüfen Sie, ob ein neuer Anschluss korrekt verkabelt ist;
- Überprüfen Sie, ob die Ziel-URL erreichbar ist;
- Sehen Sie sich an, wie die Payload-Form in Ihrem nachgelagerten Tool aussieht;
- Führen Sie nach dem Ändern der Ziel-URL einen erneuten Test durch.
Gängige Webhook-Konfigurationen
Slack-Benachrichtigung, wenn ein Kampagnenlink erstellt wird: Abonnieren Sie Link hinzugefügt und richten Sie die Ziel-URL auf einen eingehenden Slack-Webhook aus (häufig über Zapier oder Make zur Formatierung).
Automatische Archivierung in der Tabelle, wenn der Link in den Papierkorb verschoben wird: Abonnieren Sie Link-Trashed und richten Sie die Ziel-URL auf einen Zapier-Webhook aus, der eine Zeile zu einem Google-Tabellenblatt mit dem Namen “Gelöschte Links” hinzufügt.
Mit einem benutzerdefinierten CRM synchronisieren: Abonnieren Sie alle und richten Sie die Ziel-URL auf den Erfassungs-Endpunkt Ihres CRM aus. Verwenden Sie das Feld „Ereignistyp“ in der Nutzlast, um zu entscheiden, welche Maßnahmen auf der jeweiligen Seite ergriffen werden sollen.
Wiederholungsversuche und Fehler
Wenn Ihr Endpunkt einen anderen als einen 2xx-Statuscode zurückgibt (oder gar nicht reagiert), wird die Zustellung als fehlgeschlagen protokolliert. Überprüfen Sie Ihren Endpunkt, beheben Sie das Problem und nutzen Sie anschließend die Funktion „Testversand“, um sicherzustellen, dass er wieder funktioniert. Tatsächliche Ereignisse, die während des Ausfalls stattgefunden haben, werden nicht automatisch wiederholt. Stellen Sie daher sicher, dass Ihr Endpunkt zuverlässig ist, bevor Sie sich bei kritischen Arbeitsabläufen auf Webhooks verlassen.