Webhooks
Webhooks ermöglichen es, andere Software-Systeme automatisch zu benachrichtigen, sobald sich in Formtastic etwas an einem Formular ändert – z.B. wenn ein Formular gesendet oder einem Mitarbeiter zugewiesen wird. So lassen sich Formtastic-Daten in Echtzeit in eigene Systeme, Automatisierungs-Tools wie Make oder Zapier, oder selbst entwickelte Anwendungen übertragen.
Webhooks werden pro Formularvorlage eingerichtet. Sobald ein Ereignis eintritt, schickt Formtastic die Formulardaten automatisch als JSON an eine URL Ihrer Wahl.
Webhook einrichten
Öffnen Sie Ihre Formularvorlage im Formular-Designer und wechseln Sie im Seitenmenü zu Webhooks. Legen Sie einen neuen Webhook an mit:
Name: Eine interne Bezeichnung für diesen Webhook.
URL: Die Adresse des Empfänger-Endpunkts, an den Formtastic die Daten senden soll (muss HTTPS sein).
Kommentar (optional): Eine interne Notiz zum Verwendungszweck.
Secret: Wird automatisch generiert. Hinterlegen Sie es in Ihrem Empfänger-System, damit eingehende Anfragen auf Echtheit geprüft werden können.
Ein Webhook ist nach dem Anlegen sofort aktiv. Er kann jederzeit deaktiviert werden, ohne gelöscht werden zu müssen.
Wann wird ein Webhook ausgelöst?
Ein Webhook wird ausgelöst, sobald sich der Status einer Einreichung ändert. Die möglichen Status sind:
- inbox – Neu eingegangen, noch nicht in Bearbeitung
- in_work – Wird von einem zugewiesenen Mitarbeiter bearbeitet
- sent_assigned – An eine bestimmte Person gesendet
- sent_saved – Gesendet und gespeichert
- removed – Gelöscht
Zustellungen einsehen und debuggen
Jede Webhook-Zustellung wird in Formtastic protokolliert. Auf der Webhook-Detailseite sehen Sie den vollständigen gesendeten Payload, den HTTP-Statuscode der Antwort sowie Status und Anzahl der Versuche. Fehlgeschlagene Zustellungen werden automatisch wiederholt.
Technische Dokumentation für Entwickler
Die vollständige technische Referenz – inkl. Payload-Format, Feldbeschreibungen, Authentifizierung, Wiederholungslogik und Empfehlungen – finden Sie in der Entwickler-Dokumentation: