Skip to main content
Mit Webhooks erfährt dein eigenes System sofort von Sendungen, Bestellungen und der Sendungsverfolgung. Wenn ein Ereignis eintritt, das du ausgewählt hast, zum Beispiel eine Sendung wird versendet, sendet Zippendo eine Nachricht an eine Adresse (URL) auf deinem Server. Das richtet meist ein Entwickler ein. Webhooks sind in jedem Tarif enthalten (Free bis zu 5, Standard bis zu 10, Growth bis zu 25, Pro bis zu 100, Enterprise unbegrenzt).

​
Wo du es findest

Öffne unten in der Seitenleiste das Organisationsmenü, klicke auf Verwalten und dann auf den Tab Webhooks. Du siehst deine Webhooks und eine Schaltfläche Webhook hinzufügen.

​
Einen Webhook hinzufügen

1

Das Fenster öffnen

Klicke auf Webhook hinzufügen (oder auf Ersten Webhook erstellen, wenn die Liste leer ist).
2

Name und Adresse

Gib einen Name * und die Endpunkt-URL * ein, zum Beispiel https://your-server.com/webhooks/zippendo. Verwende eine Adresse, die mit https:// beginnt.
3

Die Ereignisse auswählen

Hake die Ereignisse * an, die du willst, wie Sendung versendet oder Sendungsverfolgung aktualisiert, oder klicke auf Alle auswählen.
4

Speichern

Klicke auf Webhook erstellen. Zippendo sendet jetzt jedes ausgewählte Ereignis an deine Adresse. Dein Server sollte schnell mit einem 2xx-Status antworten, damit Zippendo weiß, dass die Nachricht angekommen ist.
Jede Nachricht enthält den Namen des Ereignisses, die Uhrzeit und die Details zu Sendung, Bestellung oder Sendungsverfolgung. Den genauen Inhalt und wie du die Signatur prüfst, findest du in der Kurzanleitung Webhooks.

​
Webhooks absichern

  • Signatur: Zippendo signiert jede Nachricht mit einem Geheimnis, das zum Webhook gehört. Dein Entwickler nutzt es, um zu prüfen, dass eine Nachricht wirklich von Zippendo kommt. Die App zeigt das Geheimnis nicht an; ein Entwickler liest es über die API aus (die Anfrage Get webhook in der API-Referenz).
  • HTTPS: Verwende nur https://-Adressen, damit die Nachrichten unterwegs verschlüsselt sind.

​
Marken

Wenn deine Organisation Marken nutzt, kannst du einem Webhook eine Marke zuweisen. Er erhält dann nur die Ereignisse dieser Marke. Ein Webhook ohne Marke erhält die Ereignisse jeder Marke. Lege die Marke fest, wenn du den Webhook hinzufügst oder bearbeitest.

​
Einen Webhook pausieren oder löschen

  • Pausieren: Klicke beim Webhook auf Bearbeiten, entferne den Haken bei Aktiv und klicke auf Änderungen speichern. Zippendo hört auf, an diese Adresse zu senden, behält aber den Webhook und sein Zustellprotokoll.
  • Löschen: Klicke auf Löschen, tippe den Namen des Webhooks in Großbuchstaben ein und bestätige. Es werden keine Nachrichten mehr an diese Adresse gesendet, und sein Zustellprotokoll wird entfernt.
Jedes Feld, das Zustellprotokoll und Testnachrichten: Webhooks.