Setvos-Ereignisse per Webhook an Ihre anderen Systeme senden

1. 01

   Einen Webhook anlegen

   Öffnen Sie Integrationen › API und Webhooks – sichtbar für Personen mit der Berechtigung für die Workspace-Einstellungen – und klicken Sie auf „Neuer Webhook“. Geben Sie unter „URL“ die Adresse ein, die Ereignisse empfangen soll, und kreuzen Sie unter „Ereignisse“ an, welche sie braucht:

   • ein Kontakt angelegt oder geändert
   • ein Deal in eine andere Phase verschoben oder gewonnen
   • eine Rechnung bezahlt
   • eine Buchung erstellt oder storniert
   • eine Bestellung bezahlt

2. 02

   Das Signaturgeheimnis kopieren

   Das „Signaturgeheimnis“ wird einmal angezeigt. Jede Zustellung wird damit im Header X-Setvos-Signature signiert, sodass Ihr System prüfen kann, ob eine Nachricht wirklich von Setvos kommt.

3. 03

   Einen Test senden

   Klicken Sie beim Webhook auf die Schaltfläche „Test senden“ (der Blitz). Ihr System erhält eine kurze Testnachricht, die zeigt, dass die Adresse funktioniert.

4. 04

   Die Zustellungen verfolgen

   „Letzte Zustellungen“ zeigt jede Zustellung als „In Warteschlange“, „Zugestellt“ oder „Fehlgeschlagen“. Eine Zustellung, die Ihr System nicht annimmt, bleibt „In Warteschlange“ und wird erneut versucht – sechs Versuche insgesamt, über etwa neun Stunden –, bevor sie als „Fehlgeschlagen“ markiert wird. Nach zwanzig fehlgeschlagenen Versuchen in Folge wird der Webhook angehalten und als „Pausiert“ markiert; klicken Sie auf „Fortsetzen“ (die Wiedergabe-Schaltfläche), sobald Ihr System wieder läuft.

5. 05

   Pausieren oder entfernen

   „Pausieren“ (die Pause-Schaltfläche) stoppt Zustellungen, bis Sie auf „Fortsetzen“ klicken. „Löschen“ (der Papierkorb) fragt zuerst nach: Tippen Sie zur Bestätigung den Host der Adresse ein, etwa example.com. Ein gelöschter Webhook und sein Signaturgeheimnis lassen sich nicht zurückholen; pausieren Sie ihn also, wenn Sie nur eine Unterbrechung brauchen.

6. 06

   Zapier oder Make anbinden

   In deren Verzeichnissen gibt es noch keine Setvos-App. Nutzen Sie dort den Schritt, der einen Webhook empfängt, und legen Sie die Adresse, die er Ihnen gibt, hier als neuen Webhook an. Die Testnachricht enthält keinen Datensatz; um die Felder zuzuordnen, nehmen Sie also eine echte Änderung der angekreuzten Art vor – legen Sie zum Beispiel einen Testkontakt an.

Aktualisiert am 6. Oktober 2026