Webhooks
Verbinde Joinpoints über Webhooks mit anderen Systemen und starte dort automatisch Aktionen.
Mit Webhooks kann Joinpoints andere Systeme automatisch aufrufen.
Einfach gesagt:
In Joinpoints passiert etwas → Webhook wird ausgelöst → anderes System reagiert
Ein Webhook ist damit ein Startsignal für ein anderes System.
Joinpoints muss dabei nicht wissen, wie das andere System intern arbeitet. Joinpoints ruft nur die hinterlegte Webhook-URL auf und löst damit dort einen Vorgang aus.
Wofür kannst du Webhooks verwenden?
Webhooks sind sinnvoll, wenn ein Prozess in Joinpoints eine Aktion in einem anderen System starten soll.
Zum Beispiel:
- einen Workflow in n8n oder Zapier starten
- in einem Fremdsystem automatisch ein Angebot erstellen
- eine externe Berechnung auslösen
- Daten in einem anderen System weiterverarbeiten
- einen eigenen programmierten Dienst aufrufen
Beispiel
Ein Projekt erreicht in Joinpoints eine bestimmte Phase.
Daraufhin soll in einem anderen System automatisch ein Angebot erzeugt werden.
Projekt erreicht Phase → Webhook wird ausgelöst → anderes System erstellt Angebot
Joinpoints stößt den Vorgang nur an. Wie die eigentliche Aktion ausgeführt wird, wird im anderen System festgelegt.
Webhook im Prozess-Designer hinzufügen
Webhooks werden wie andere Aktionen im Prozess-Designer eingebaut.
Pipeline öffnen
Öffne die gewünschte Pipeline.
Prozess-Designer öffnen
Öffne Automatisieren.
Startpunkt auswählen
Wähle den Trigger oder Prozessschritt aus, nach dem der Webhook ausgeführt werden soll.
Aktion hinzufügen
Klicke auf das Plus-Symbol.
Eigene Automationen öffnen
Öffne Eigene Automationen.
Webhook auswählen
Wähle API Webhook auslösen.
Danach öffnet sich die Konfiguration des Webhooks.
Webhook-URL eintragen
Im Feld für die URL trägst du die Adresse ein, die Joinpoints aufrufen soll.
Diese URL bekommst du normalerweise direkt vom Zielsystem, zum Beispiel von:
- n8n
- Zapier
- einer eigenen Schnittstelle
- einem anderen System mit Webhook-Unterstützung
Die URL kopierst du aus dem Zielsystem und fügst sie in Joinpoints ein.
Webhook benennen
Du kannst dem Webhook einen internen Namen geben.
Der Name hilft dir dabei, den Schritt im Prozess-Designer später leichter wiederzuerkennen.
Zum Beispiel:
- Angebot extern erstellen
- n8n Workflow starten
- Berechnung auslösen
GET oder POST auswählen
Beim Webhook kannst du auswählen, mit welcher HTTP-Methode die URL aufgerufen wird.
Im gezeigten Ablauf stehen GET und POST zur Verfügung.
Welche Methode du verwenden musst, wird vom Zielsystem vorgegeben.
Wenn n8n, Zapier oder ein anderes System eine bestimmte Methode vorgibt, wähle genau diese Einstellung in Joinpoints.
Webhook speichern
Nachdem du URL, Namen und Methode festgelegt hast, speicherst du den Webhook über das Häkchen.
Damit ist der Webhook Teil des Prozessablaufs.
Sobald Joinpoints diese Stelle erreicht, wird die hinterlegte URL automatisch aufgerufen.
Trigger → Webhook → URL wird aufgerufen
Was passiert beim Auslösen?
Wenn der Webhook ausgelöst wird, ruft Joinpoints die hinterlegte URL im Hintergrund auf.
Das Zielsystem erhält damit das Signal, dass es jetzt etwas ausführen soll.
Beispiel:
Projekt erreicht Phase „Angebot“ → Joinpoints ruft Webhook auf → n8n startet Workflow → Angebot wird erstellt
Joinpoints muss dabei nicht wissen, welche einzelnen Schritte im anderen System ausgeführt werden.
Welche Daten werden übergeben?
Joinpoints übermittelt beim Webhook nicht automatisch sämtliche Projektdaten.
Stattdessen wird die Joinpoint-/Projekt-ID mitgegeben.
Das ist wichtig, damit das Zielsystem erkennen kann, welcher Datensatz den Webhook ausgelöst hat.
Weitere Daten über die API abrufen
Wenn das Zielsystem zusätzliche Informationen benötigt, kann es diese über die Joinpoints-API abrufen.
Der Ablauf sieht vereinfacht so aus:
- Joinpoints löst den Webhook aus.
- Das Fremdsystem erhält die Joinpoint-ID.
- Das Fremdsystem fragt mit dieser ID weitere Daten über die API ab.
- Dafür muss sich das Fremdsystem bei der API authentifizieren.
- Joinpoints liefert anschließend die erlaubten Daten zurück.
Damit sind Webhook und Datenabruf getrennt.
Der Webhook ist das Startsignal. Die API wird verwendet, wenn das andere System danach zusätzliche Daten aus Joinpoints benötigt.
Warum wird nicht alles direkt mitgesendet?
Das ist vor allem ein Sicherheitsaspekt.
Würde Joinpoints bei jedem Webhook automatisch alle Projektdaten mitschicken, könnten bei einer falsch eingetragenen URL auch sensible Informationen an ein falsches System übertragen werden.
Deshalb wird zunächst nur die ID übergeben.
Weitere Informationen können anschließend nur über einen entsprechend eingerichteten und authentifizierten API-Zugriff abgefragt werden.
Wo können Webhooks eingesetzt werden?
Webhooks können wie andere Automationen an unterschiedlichen Stellen eines Prozesses verwendet werden.
Zum Beispiel:
- wenn ein Datensatz erstellt wird
- wenn eine bestimmte Phase erreicht wird
- nach Abschluss einer Aufgabe
- nach einer Bedingung
- über einen eigenen Trigger oder Button
Webhook über einen eigenen Button starten
Ein Webhook kann auch mit einem eigenen Button kombiniert werden.
Beispiel:
Button „Berechnen“ klicken → eigener Trigger → Webhook → externes System berechnet Wert
So kann ein Benutzer direkt aus Joinpoints eine Funktion in einem anderen System starten.
n8n, Zapier oder eigene Programmierung
Webhooks können zum Beispiel von n8n oder Zapier empfangen werden.
Diese Tools starten danach weitere Schritte oder verbinden Joinpoints mit anderen Anwendungen.
Ein möglicher Ablauf:
Joinpoints → Webhook → n8n → Fremdsystem
Webhooks können aber auch von selbst programmierten Anwendungen empfangen werden.