Technische Dokumentation: alle aktuellen API-Routen, Berechtigungen und Beispiele findest du unter docs.fitsociety.io. Beginne als Entwickler mit dem Public API-Schnellstart.
Ein Webhook sendet eine Meldung an ein anderes System, wenn in FITsociety etwas passiert. So kann dein CRM auf ein neues Mitglied reagieren oder deine Automatisierung nach einer neuen Buchung starten.
In diesem Artikel
Was brauchst du?
Du brauchst Zugriff auf die Public API und die Webhook-Verwaltung für dein Unternehmen sowie eine Empfangsadresse von deinem Entwickler oder Automatisierungstool. Das muss eine öffentlich erreichbare HTTPS-Adresse sein. Eine Localhost-Adresse oder interne Netzwerkadresse funktioniert nicht.
Ein Webhook meldet ein Ereignis; das andere System führt den nächsten Schritt aus. Für weitere Daten oder eine Änderung in FITsociety kann zusätzlich ein API-Client mit passenden Rechten nötig sein.
Den Webhook erstellen
Gehe im richtigen Unternehmen zu Einstellungen → Plugins und Integrationen → Webhooks.
Wähle Add webhook und vergib einen erkennbaren Namen.
Trage unter Target URL die Empfangsadresse ein.
Prüfe Events und wähle nur die gewünschten Ereignisse, etwa
client.createdoderbooking.created. Kontrolliere auch die Vorauswahl.Speichere den Webhook und kopiere das einmalig angezeigte Signing-Secret. Lass deinen Entwickler es sicher speichern und die Signatur der Meldungen prüfen.
Testen und Zustellungen kontrollieren
Nutze die Testaktion beim Webhook und prüfe, ob das empfangende System die Meldung verarbeitet. Kontrolliere auch die letzten Zustellversuche in FITsociety. Eine erfolgreiche Zustellung hat den Status delivered: Der Empfänger hat mit HTTP 2xx geantwortet.
Bei einem Fehler gibt es insgesamt höchstens drei Zustellversuche. Bei failed kann noch ein weiterer Versuch folgen; exhausted bedeutet, dass keine Versuche mehr übrig sind. Lass bei Fehlern die Empfangsadresse, die Erreichbarkeit und die Fehlermeldung prüfen.
Ein erfolgreicher Test beweist, dass der Empfang funktioniert. Prüfe zusätzlich ein echtes Ereignis und die gewünschte Folgeaktion, bevor du dich auf den Workflow verlässt.
Ändern und Meldungen sorgfältig verarbeiten
Über Bearbeiten änderst du Adresse, Ereignisse oder Status. Setze den Webhook auf Disabled, um neue Meldungen über diesen Webhook zu stoppen. Prüfe im anderen System auch bereits empfangene oder laufende Aktionen.
Meldungen enthalten kompakte Daten, keine vollständige Klientenakte. Lass den Empfänger doppelte Meldungen an der stabilen Event-ID erkennen, damit dasselbe Ereignis nicht zweimal eine Aktion auslöst.
Für die Verwaltung über die API stehen webhooks:read, webhooks:write und für Zustellversuche webhook_deliveries:read zur Verfügung. Die technische Dokumentation beschreibt Events, Payloads und Signaturprüfung.
Weiterlesen
Technische Dokumentation für deinen Entwickler (Englisch)