Webhooks sind ein neues Feature in profacto 2024. Die Einrichtung sollte von erfahrenen Anwendern mit Kenntnissen im Bereich Webprogrammierung durchgeführt werden.
Was sind Webhooks?
Mit Webhooks können andere Anwendungen, in der Regel Webapps, automatisch informiert werden, wenn bestimmte Ereignisse in profacto eintreten. Neben der reinen Information über das Eintreten des Ereignisses können auch das Ereignis betreffende Felddaten der mit dem Ereignis in Verbindung stehenden Datenbanktabelle übermittelt werden.
Webhooks sind somit sehr praktisch, um automatisiert und ohne Anwendereingriff Informationen zwischen zwei Programmen auszutauschen. Das profacto-API erlaubt zwar auch einen Datenaustausch, mit dem Webhook können die Daten jedoch an eine andere Anwendung übermittelt werden, ohne dass diese von sich aus aktiv werden muss.
Denkbar ist beispielsweise, Mitarbeiterdaten an ein externes Zeiterfassungssystem zu übermitteln, Kundendaten an ein spezielles CRM-System oder Auftragsdaten an ein mobiles System für Monteure, zum Aufmaß oder für anderen mobile Nutzungen.
Welche Ereignisse können via Webhook gemeldet werden?
Derzeit werden folgende Ereignisse unterstützt:
Neues Projekt
Projekt erteilt
Projekt abgerechnet
Neuer Kunde
Neuer Mitarbeiter
Neue Projektzeit
Weitere Ereignisse sind in Planung.
Welche Anwendungen werden unterstützt?
Das können wir nicht konkret beantworten. Rein technisch erfassen Sie für einen Webhook die URL einer Anwendung und übergeben zusätzlich in einem standardisierten POST-Format die zu übertragenden Felder.
Wie richte ich Webhooks ein?
Rufen Sie die Voreinstellungen auf und wechseln auf die Seite profacto-Allgemein.
Dort finden Sie einen Button “Webhooks”.
Es erscheint der untenstehende Dialog:
Dort können Sie nun neue Webhooks anlegen oder vorhandene bearbeiten.
Der Bearbeitungsdialog sieht dann so aus:
Geben Sie dem Webhook einen für Sie aussagekräftigen Namen.
Wählen sie dann das Ereignis aus, wie oben schon aufgeführt.
Nun wird es technisch. Wählen Sie als Zielsystem “Benutzerdefiniert aus”. Nun erfassen Sie die URL der Web-Anwendungen, die informiert werden soll. Dazu müssen Sie vom Hersteller der Web-Anwendung entsprechende Informationen erhalten haben.
Wählen Sie nun die Tabelle aus, von der Daten übergeben werden sollen. Die Tabelle sollte in der Regel zum Ereignis passen, also “Auftrag” zu “Neues Projekt”.
Das Feld Bedingungen wird derzeit noch nicht ausgewertet.
Aktivieren Sie das Ankreuzfeld Webhook ist aktiv, wenn der Webhook beim betreffenden Ereignis ausgelöst werden soll. Solange die Kommunikation zwischen profacto und Zielsystem noch nicht zu 100% klappt, kann man so die Webhooks auch einfach ausschalten, ohne sie löschen zu müssen.
Die Muster-URL stellt eine Vorschau auf die URL dar, wie sie zum Aufruf der Webanwendung genutzt werden wird.
Speichern Sie den Webhook und verlassen Sie dann die Webhook-Übersicht und die Voreinstellungen, um den Webhook verfügbar zu machen.
Überwachung und Fehlersuche
Gerade in der Einrichtungsphase kann es zu Fehlfunktionen kommen, bis die URL wirklich sauber konfiguriert ist. Außerdem möchte man auch gelegentlich prüfen, welche Daten wann an andere Systeme übertragen worden sind. Zu diesem Zweck werden Webhook-Ereignisse protokolliert. Sie finden diese in der Datei Webhooks.log im Verzeichnis Logs Ihrer Datenbankdatei. Die Datei ist im JSON-Format und kann so gut auch automatisiert ausgewertet werden.