FITsociety Help DE

Webhooks einrichten: Änderungen automatisch übermitteln

3 Min. Lesezeit

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

  1. Gehe im richtigen Unternehmen zu Einstellungen → Plugins und Integrationen → Webhooks.

  2. Wähle Add webhook und vergib einen erkennbaren Namen.

  3. Trage unter Target URL die Empfangsadresse ein.

  4. Prüfe Events und wähle nur die gewünschten Ereignisse, etwa client.created oder booking.created. Kontrolliere auch die Vorauswahl.

  5. 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)

War dieser Artikel hilfreich? Danke für dein Feedback!

Danke, wir lesen jeden Kommentar.

Ähnliche Artikel