Docs

Webhooks ​

Mit einem Webhook sendet sellerfox ausgewählte KPIs einmal täglich als JSON an eine öffentliche HTTPS-Adresse. Unter Automations → Webhooks erstellst, testest und überwachst du deine Webhooks. Die technischen Anforderungen an den Empfänger findest du in der Webhook API.

Zugriff und Kontingent

Nur Owner und Admins können Webhooks sehen und verwalten.

Du kannst einen Webhook erstellen, wenn:

  • das Onboarding des Workspaces abgeschlossen ist,
  • der Workspace eine aktive Trial oder ein aktives Abonnement hat und
  • mindestens ein Webhook-Slot frei ist.

Über der Liste siehst du, wie viele Slots belegt sind. Ist kein Slot mehr frei, lösche einen nicht mehr benötigten Webhook. Siehe Berechtigungsmatrix.

Was ein Webhook überwachen kann ​

Für jeden Webhook wählst du eine Kategorie und zwischen einem und 20 passenden KPIs.

KategorieDaten
„Account Ebene“Zusammengefasste KPIs aus allen Marktplätzen des Workspaces.
„Marktplatz“KPIs für einen Marktplatz.
„Parent ASIN“KPIs für eine Parent-ASIN und ihre Child-ASINs auf einem Marktplatz.
„Child ASIN“KPIs für eine einzelne Child-ASIN auf einem Marktplatz.
„Produktliste“Zusammengefasste KPIs für eine Produktliste.
„Keyword“Ranking-KPIs für ein Keyword-Label auf einem Marktplatz.

Nach dem Erstellen kannst du die Kategorie nicht mehr ändern. Für eine andere Kategorie brauchst du einen neuen Webhook.

Webhook erstellen und testen ​

  1. 1

    Formular öffnen

    Öffne Automations → Webhooks → Webhook erstellen. Auf einer leeren Webhook-Seite trägt der Button die Aufschrift „Ersten Webhook erstellen“.

  2. 2

    Ziel auswählen

    Wähle unter „Was möchtest du überwachen?“ eine Kategorie. Wähle danach, falls angezeigt, das gewünschte Ziel.

  3. 3

    KPIs auswählen

    Wähle zwischen einem und 20 kompatiblen KPIs.

  4. 4

    Endpunkt konfigurieren

    Trage unter „Webhook URL“ eine öffentliche HTTPS-Adresse mit einem Domainnamen ein. Wähle unter „Authentifizierung“ die Methode „Keine“, „Bearer Token“ oder „Basic Auth“. Ergänze bei Bedarf die Zugangsdaten.

  5. 5

    Webhook benennen

    Vergib unter „Webhook Details“ einen Namen mit höchstens 100 Zeichen.

  6. 6

    Testen und erstellen

    Wähle „Verbindung testen“. Antwortet dein Endpunkt wie erwartet, wähle „Webhook erstellen“.

Die Testansicht zeigt den Request, die Response, den Statuscode und die Antwortzeit. Der Test verwendet aktuelle Daten. Das data-Array kann leer sein. Die Ansicht zeigt höchstens die ersten 5.000 Zeichen der Response.

Empfänger und Authentifizierung konfigurieren ​

Verwende eine öffentliche HTTPS-URL mit einem Domainnamen. Lokale und interne Adressen sowie IP-Adressen werden nicht unterstützt. Mit „Verbindung testen“ prüfst du, ob dein Endpunkt antwortet.

Wähle „Bearer Token“ oder „Basic Auth“, wenn dein Endpunkt Zugangsdaten erwartet. Andernfalls wähle „Keine“.

Die Vorgaben für Header, Payload, Timeouts und Größenlimits findest du in der Webhook API.

Webhooks verwalten ​

Über der Liste filterst du nach „Alle“, „Aktiv“, „Pausiert“, „Fehlgeschlagen“ oder „Deaktiviert“. Jeder Filter zeigt die Anzahl der zugehörigen Webhooks. Diese Filter beziehen sich auf den Webhook; den Status einzelner Zustellungen prüfst du im Zustellungsverlauf.

Das Drei-Punkte-Menü eines Webhooks enthält die Optionen „Pausieren“, „Fortsetzen“, „Webhook testen“, „Verlauf anzeigen“, „Einstellungen bearbeiten“ und „löschen“.

Du kannst Name, URL, Authentifizierung und KPIs ändern. Bei „Marktplatz“, „Parent ASIN“, „Child ASIN“, „Produktliste“ und „Keyword“ kannst du auch das Ziel wechseln.

Existiert die gewählte ASIN, das Keyword oder die Produktliste nicht mehr, zeigt sellerfox „Referenz fehlt“. Öffne „Einstellungen bearbeiten“ und wähle in derselben Kategorie eine andere ASIN, ein anderes Keyword oder eine andere Produktliste.

Deaktivierst du einen Marktplatz im Workspace, entscheidet die Kategorie des Webhooks:

  • „Marktplatz“, „Parent ASIN“, „Child ASIN“ oder „Keyword“: Ist das gewählte Ziel diesem Marktplatz zugeordnet, wird der Webhook gelöscht. Lege den Webhook bei Bedarf nach dem Reaktivieren neu an.
  • „Produktliste“: Der Webhook und die Produktliste bleiben erhalten – auch wenn die Liste Produkte des deaktivierten Marktplatzes enthält.

Siehe Marktplatz deaktivieren und erneut aktivieren.

Zustellungen überwachen ​

Wähle im Drei-Punkte-Menü „Verlauf anzeigen“. Der „Zustellungsverlauf“ lädt beim Scrollen weitere Einträge nach. Jede Zeile zeigt Status, Zeitpunkt, HTTP-Status, Antwortdauer und Anzahl der Versuche. Über „Details“ klappst du die „Zustell-ID“ und gegebenenfalls die Fehlermeldung auf. Die Zustell-ID lässt sich kopieren.

Du kannst nach „Zugestellt“, „Fehlgeschlagen“ oder „Ausstehend“ filtern. Dieser Status gehört zur Zustellung, nicht zum Webhook. Deshalb kann ein „Aktiv“-Webhook eine „Ausstehend“-Zustellung haben.

Nutze die Statusfilter, um Fehler und ausstehende Wiederholungen zu finden.

Wiederholungen und Abschaltung ​

sellerfox sendet den Webhook einmal täglich. Jede Zustellung enthält Daten für die 31 Tage bis einschließlich gestern. Schlägt ein Versuch fehl, versucht sellerfox die Zustellung höchstens zweimal erneut. Eine fehlgeschlagene Zustellung kann bei der nächsten stündlichen Prüfung erneut gesendet werden. Warte deshalb einige Stunden, bevor du sie als verloren betrachtest. Nach zehn fehlgeschlagenen Versuchen in Folge deaktiviert sellerfox den Webhook.

StatusWas zu tun ist
„Aktiv“Keine Aktion nötig, solange der Verlauf keine Fehler zeigt.
„Pausiert“Wähle „Fortsetzen“, wenn die Zustellung weiterlaufen soll.
„Deaktiviert“Behebe den Fehler am Endpunkt, lösche die Konfiguration und lege einen neuen Webhook an. Ein erfolgreicher Test aktiviert den Webhook nicht erneut.

Zugestellte Einträge verschwinden nach 30 Tagen aus dem Verlauf. Für ausstehende und fehlgeschlagene Einträge gilt diese Frist nicht. Nutze den Verlauf deshalb nicht als Archiv.

Verwandte Themen ​