API-Schlüssel, Webhooks und Zapier
Andere Tools über API-Schlüssel und Webhooks anbinden
In der Edition Chain kann ein anderes System mit Ihrem Arbeitsbereich arbeiten: ein API-Schlüssel für Anfragen an Setvos und Webhooks für Neuigkeiten aus Setvos. Eine Zapier-App gibt es noch nicht; das Rezept unten nutzt die Webhook-Schritte, die Zapier und Make bereits haben.
Schlüssel erstellen
Öffnen Sie Integrationen → API und Webhooks und wählen Sie unter API-Schlüssel „Neuer Schlüssel“. Benennen Sie ihn nach dem System, das ihn nutzt, und haken Sie nur an, was es braucht: Ein Schlüssel handelt in Ihrem Namen und kann nie mehr als Sie. Kopieren Sie ihn sofort – er wird einmal angezeigt und nicht gespeichert.
Anfragen senden
Übergeben Sie den Schlüssel im Header Authorization als „Bearer stv_live_…“ und senden Sie Anfragen an die API-Adresse auf derselben Karte. Ein Schlüssel stellt bis zu 300 Anfragen pro Minute, und eine Adressliste am Schlüssel begrenzt, von wo aus er genutzt werden darf.
Schlüssel vor dem Ablauf ersetzen
Ein Schlüssel funktioniert ein Jahr nach der Ausstellung nicht mehr. Ersetzen Sie ihn auf der Karte: Der neue behält Namen, Reichweite und Adressliste, der alte funktioniert, bis Sie ihn widerrufen – so können Sie zuerst das andere System umstellen.
Ereignisse abonnieren
Wählen Sie unter Webhooks „Neuer Webhook“, fügen Sie die Adresse ein, die Ereignisse empfangen soll, und wählen Sie sie aus: ein Kontakt angelegt oder geändert, ein Deal in eine andere Phase verschoben oder gewonnen, eine Rechnung bezahlt, ein Termin gebucht oder storniert, eine Bestellung bezahlt. Jede Zustellung ist ein POST mit dem Ereignisnamen in X-Setvos-Event und einer Signatur in X-Setvos-Signature: sha256= und der HMAC des Bodys, erstellt mit dem Signaturgeheimnis, das beim Anlegen des Webhooks angezeigt wurde.
Szenario in Zapier oder Make bauen
Starten Sie in Zapier einen Zap mit Webhooks by Zapier → Catch Hook, in Make ein Szenario mit Webhooks → Custom webhook. Fügen Sie die erhaltene Adresse hier in einen neuen Webhook ein, klicken Sie auf „Test senden“ und ordnen Sie die Felder zu. Um aus einem Szenario heraus in Setvos zu handeln, nutzen Sie Webhooks by Zapier → Custom Request oder das HTTP-Modul von Make mit Ihrem Schlüssel im Header Authorization.
Häufige Fragen
- Welche Edition enthält API-Schlüssel?
- Chain. Ein Arbeitsbereich, der Chain verlässt, behält seine Schlüssel, aber sie funktionieren noch am selben Tag nicht mehr.
- Was passiert, wenn eine Zustellung fehlschlägt?
- Sie wird erneut versucht – insgesamt sechs Versuche über fast einen Tag. Die Webhook-Karte zeigt die letzten Zustellungen, und ein Webhook, der zwanzigmal hintereinander fehlschlägt, wird pausiert, bis Sie ihn fortsetzen.
- Gibt es eine Setvos-App im Zapier-Verzeichnis?
- Noch nicht. Die Schritte Catch Hook und Custom Request oben leisten heute dasselbe.
Wo das im Produkt steckt
Weiterlesen
Workspace und Profil: wie Ihr Betrieb eingerichtet ist
Die Einstellungen, die den ganzen Workspace prägen – Unternehmensdaten, Module, eigene Felder, KI und das Audit-Log – und Ihr eigenes Profil.
Kontakte: Ihre Kunden und die Firmen, für die sie arbeiten
Führen Sie für jeden Kunden eine Seite mit Verlauf, Notizen, Tags und Dateien, finden Sie jeden in Sekunden und halten Sie die Liste frei von Duplikaten.
Rechnungen: Kunden abrechnen und sehen, wer Ihnen etwas schuldet
Wofür die Rechnungsseiten da sind, wie eine Rechnung vom Entwurf bis zur Zahlung kommt und was Sie vor der ersten Rechnung einrichten.
Holen Sie Ihre Termine von Papier, WhatsApp und drei Tabellen herunter.
Übernehmen Sie Ihre Kunden, Leistungen und vergangenen Besuche aus einer Tabelle oder dem Export Ihres alten Systems, mit einer Vorschau, bevor etwas geschrieben wird — und mit Hilfe im Chat, in sechs Sprachen, wann immer Sie möchten. Die meisten Studios sind noch am selben Tag live.