Eingehende Webhooks
Eingehende Webhooks sind spezielle Links, mit denen Sie Aufgaben erstellen oder ändern oder Kontakte zu Planfix hinzufügen können. Sie werden mit einem bestimmten Typ und entsprechenden Parametern erstellt.
Beispiel für einen Webhook:
Wenn ein Kunde oder ein anderer externer Benutzer auf diesen Link klickt, werden vordefinierte Aktionen in Planfix gestartet. Auf diese einfache Weise können Sie Planfix mit einem anderen Webdienst oder Programm verbinden.
Webhooks können in Planfix unter Kontoverwaltung — Eingehende Webhooks hinzugefügt werden.
Wenn Sie auf die Schaltfläche Neuer Webhook klicken, können Sie eine der voreingestellten Konfigurationen auswählen oder einen eigenen Webhook konfigurieren.
Beispiele
Wichtig
Eingehende Webhooks geben nur JSON mit der Nummer der erstellten Aufgabe (2) aus der Hauptaktion (1) zurück:
Zusammengesetzte Webhooks
Wenn verschiedene Anfragen an dieselbe Adresse gesendet werden, können Sie den Webhook für mehrere Verarbeitungsszenarien konfigurieren. Wechseln Sie den Modus „Ein gemeinsames Szenario“ zu „Mehrere Verarbeitungsszenarien“, legen Sie fest, anhand welcher Daten das Skript ausgewählt wird, und definieren Sie für jedes Szenario Bedingungen und Aktionen.
Das erste passende Skript wird von oben nach unten ausgeführt. Wenn beispielsweise Formulare von verschiedenen Quellen an denselben Webhook auf einer Website gesendet werden:
{"form": "demo", "name": "Alex Smith", "email": "alex@example.com"}
{"form": "support", "name": "Alex Smith", "problem": "notifications not received"}
Das Skript wird anhand des Werts von „form“ ausgewählt:
- Für „demo“ können Sie eine Aufgabe für den Vertriebsleiter erstellen.
- Für „support“ eine Aufgabe im Projekt für technischen Support.
== Zusätzlich == *Eingehende Webhooks an Planfix können mit JSON geparst werden. Dafür wird die JsonPath-Bibliothek verwendet.