Wissensdatenbank

Aufgaben-Webhooks

Aufgaben-Webhooks benachrichtigen externe Systeme automatisch, wenn sich in SCS Tasks etwas ändert — zum Beispiel wenn eine Aufgabe erstellt oder abgeschlossen wird. So lassen sich Werkzeuge wie Zapier oder eigene Integrationen anbinden.

Was kann ich hier tun?

  • Einen neuen Webhook mit Ziel-URL und abonnierten Ereignistypen anlegen
  • Einen Webhook aktivieren oder deaktivieren
  • Eine Testzustellung senden, um die Verbindung zu prüfen
  • Das Zustellprotokoll einsehen und fehlgeschlagene Zustellungen erneut versuchen

Schritt für Schritt

Einen Webhook einrichten

  1. Klicken Sie auf Webhook hinzufügen, vergeben Sie einen Namen (z. B. „Zapier-Integration") und die Ziel-URL.
  2. Wählen Sie die Ereignistypen, über die dieser Webhook informiert werden soll.
  3. Speichern Sie den Webhook. Das Signatur-Secret wird nur einmal angezeigt — kopieren Sie es sofort, um Anfragen später verifizieren zu können.
  4. Klicken Sie auf Test senden, um eine Beispiel-Zustellung an die hinterlegte URL zu schicken und die Verbindung zu prüfen.

Fehlgeschlagene Zustellungen prüfen

  1. Öffnen Sie einen Webhook und wechseln Sie zum Zustellprotokoll.
  2. Filtern Sie nach Status, um z. B. nur fehlgeschlagene Zustellungen zu sehen.
  3. Nutzen Sie Erneut zustellen, um eine fehlgeschlagene Zustellung erneut zu versuchen.
  4. Es erscheint eine Rückfrage, die die Zieladresse nennt, an die die signierte Zustellung geht. Lesen Sie die Adresse und bestätigen Sie erst dann.

Warum wird hier gefragt? Eine erneute Zustellung ist kein lokaler Wiederholungsversuch. Der Nutzdatensatz geht mit gültiger Signatur an das fremde System - dort ist er von der ursprünglichen Zustellung nicht zu unterscheiden und lässt sich von hier aus nicht zurückholen.

Nachgebauter Ausschnitt der Ansicht: /tasks/webhooks
Nachgebauter Ausschnitt der Ansicht: /tasks/webhooks

Felder erklärt

Feld Bedeutung Hinweise/Auswirkung
Name Bezeichnung des Webhooks Zur Wiedererkennung
URL Zieladresse, an die Ereignisse gesendet werden Muss über HTTPS erreichbar sein
Signatur-Secret Geheimer Schlüssel zur Verifizierung eingehender Anfragen beim Empfänger Wird nur einmal im Klartext angezeigt
Ereignistypen Die Ereignisse, über die der Webhook informiert wird Siehe Werteliste unten
Max. Wiederholungen Wie oft eine fehlgeschlagene Zustellung automatisch erneut versucht wird —
Timeout (ms) Wie lange auf eine Antwort des Zielservers gewartet wird Danach gilt die Zustellung als fehlgeschlagen
Aktiv Ob der Webhook überhaupt Ereignisse sendet Inaktive Webhooks senden nichts
Versuch Laufende Nummer eines Zustellversuchs im Protokoll —

Werte & Status

Ereignistypen

Label Bedeutung
task.created Eine neue Aufgabe wurde erstellt
task.updated Eine Aufgabe wurde geändert
task.completed Eine Aufgabe wurde abgeschlossen
task.deleted Eine Aufgabe wurde gelöscht
comment.created Ein neuer Kommentar wurde hinzugefügt
project.created Ein neues Projekt wurde erstellt
project.updated Ein Projekt wurde geändert
project.deleted Ein Projekt wurde gelöscht
membership.changed Die Mitgliedschaft in einem Projekt hat sich geändert
webhook.test Test-Ereignis, ausgelöst über „Test senden"

Zustellstatus

Label Bedeutung Was passiert dann
Erfolgreich Die Zustellung wurde vom Zielserver bestätigt Keine weitere Aktion nötig
Fehlgeschlagen Die Zustellung konnte nicht erfolgreich abgeschlossen werden Kann manuell über „Erneut zustellen" wiederholt werden
Wiederholung Die Zustellung wird automatisch erneut versucht Bis zur konfigurierten Anzahl „Max. Wiederholungen"
Ausstehend Die Zustellung wurde noch nicht verarbeitet —

Häufige Fragen

Wie verifiziere ich, dass eine eingehende Anfrage tatsächlich von SELLERLOGIC Commerce Services stammt?
Jede Zustellung wird mit dem Signatur-Secret signiert. Ihr Empfangssystem sollte diese Signatur prüfen, bevor es die Nutzlast verarbeitet.

Was passiert, wenn ich das Signatur-Secret nicht direkt kopiert habe?
Es wird aus Sicherheitsgründen nur einmal im Klartext angezeigt. Sie müssen den Webhook dann neu anlegen oder das Secret zurücksetzen, um ein neues zu erhalten.

Wie oft wird eine fehlgeschlagene Zustellung automatisch wiederholt?
Bis zur eingestellten Anzahl „Max. Wiederholungen" — danach bleibt sie als „Fehlgeschlagen" stehen und kann manuell erneut zugestellt werden.

Verwandte Themen