Eine neue Bestellung aus dem Onlineshop, ein ausgefülltes Formular auf der Website, eine Zahlung vom Zahlungsanbieter - wir zeigen, wie Sie solche Ereignisse per Webhook an Ihr System anbinden und umgekehrt Daten über die API nach außen lassen.
Ein Onlineshop, eine Website oder ein Zahlungsanbieter laufen meist als getrennte Systeme, die nichts voneinander wissen - bis jemand sie manuell durch das Kopieren von Daten verbindet. Webhooks und API lösen genau das: Sie ermöglichen es zwei Systemen, sich automatisch Daten zu senden, in dem Moment, in dem etwas passiert, ohne einen einzigen manuellen Schritt dazwischen.
Zwei Richtungen der Anbindung
Webhook - Daten kommen herein. Ein externer Dienst (Onlineshop, Zahlungsanbieter, Website-Formular) ruft bei einem bestimmten Ereignis Ihre Adresse auf und sendet Daten. Die Automatisierung empfängt den Webhook und startet daraufhin weitere Schritte - etwa das Anlegen eines neuen Datensatzes.
API - Daten gehen hinaus. In die andere Richtung kann ein externes System mithilfe eines API-Schlüssels selbst auf Ihre Daten zugreifen - etwa um den aktuellen Status einer Bestellung abzurufen oder ein Ergebnis zurückzuschreiben.
Die meisten realen Anbindungen kombinieren beide Richtungen: Die Website sendet eine neue Bestellung per Webhook herein und fragt später über die API ab, in welchem Status sie sich befindet.
Der Webhook empfängt Daten von überall und löst eine Automatisierung aus.
Der Onlineshop oder die Website ruft den Webhook bei jeder neuen Bestellung auf, die Automatisierung empfängt die Daten und legt sofort den passenden Datensatz an.
Der typische Ablauf beim Anbinden eines Onlineshops
- Sie erstellen einen Webhook in Ihrer Automatisierung - Sie erhalten eine eindeutige Adresse, an die das externe System Daten sendet.
- Sie tragen diese Adresse in die Einstellungen des Onlineshops, des Zahlungsanbieters oder des Formulars als Ziel für Ereignisbenachrichtigungen ein.
- Sie ordnen Felder zu - aus den eingehenden Daten (Name, E-Mail, Bestellpositionen) den Spalten Ihrer Datenbank.
- Sie fügen Folgeschritte hinzu - Anlegen eines Datensatzes, Senden einer Bestätigung, Zuweisung an die zuständige Person.
Wann sich ein API-Schlüssel statt eines Webhooks eignet
Ein Webhook eignet sich, um auf ein einmaliges Ereignis zu reagieren. Ein API-Schlüssel eignet sich dort, wo Sie regelmäßig oder bei Bedarf Daten von außen lesen oder schreiben müssen - etwa ein internes Tool, das einmal pro Stunde nach neuen Datensätzen fragt, oder ein externes Reporting, das aktuelle Zahlen abruft.
Worauf Sie achten sollten
Herkunft der Daten überprüfen. Ein Webhook sollte nur Daten aus einer vertrauenswürdigen Quelle akzeptieren - üblicherweise wird das über einen geheimen Schlüssel gelöst, den der Absender mitsendet und den die Automatisierung prüft, bevor sie die Daten verarbeitet.
Fehlende oder unvollständige Daten. Nicht jede eingehende Anfrage hat alle Felder ausgefüllt - die Automatisierung sollte für den Fall, dass ein Pflichtwert fehlt, eine Bedingung haben, statt still einen unvollständigen Datensatz anzulegen.
Anfragevolumen. Wenn der Onlineshop täglich Hunderte Bestellungen erzeugt, lohnt es sich, von Anfang an damit zu rechnen, dass die Automatisierung häufig läuft, und eine Duplikatprüfung einzubauen.
Wann eine Anbindung über ein externes Szenario sinnvoll ist und wann Automatisierung besser im System aufgehoben ist, behandelt Sind Zapier und Make tot?.
Häufige Fragen zu Webhooks und API
Brauche ich einen Entwickler, um einen Webhook an meinen Onlineshop anzubinden?
Bei den meisten gängigen E-Commerce-Plattformen reicht es, die Webhook-Adresse in die Benachrichtigungseinstellungen zu kopieren - die Feldzuordnung und die Folgeschritte werden visuell zusammengestellt, ohne Code zu schreiben.
Woran erkenne ich, ob ich einen Webhook oder einen API-Schlüssel verwenden soll?
Verwenden Sie einen Webhook, wenn Sie auf ein konkretes Ereignis (neue Bestellung, Zahlung) reagieren möchten. Verwenden Sie einen API-Schlüssel, wenn Sie Daten nach Bedarf lesen oder schreiben müssen, nicht nur als Reaktion auf ein einzelnes Ereignis.
Was passiert, wenn das externe System Daten in einem Format sendet, das nicht zu meiner Datenbank passt?
Zwischen dem Empfang des Webhooks und dem Anlegen des Datensatzes lässt sich ein Schritt einfügen, der die Daten vor dem Schreiben in die richtige Form umwandelt.