Die meisten Workflows starten durch ein Ereignis in Ihrem Salon. Zwei Trigger tun das nicht: Webhook startet einen Workflow, wenn ein anderes System eine Anfrage an seine URL sendet, zum Beispiel ein Formular auf Ihrer Website. Manuell startet ihn, wenn Sie auf Ausführen klicken.
Bevor Sie beginnen
- Sie benötigen die Rolle Super-Administrator oder Inhaber.
- Ihr Salon braucht ein aktives Abonnement.
- Erstellen Sie einen Workflow von Grund auf. Siehe Einen Workflow von Grund auf erstellen.
Einen Workflow per Webhook starten
- 1
Schritt 1 von 4
Den Trigger Webhook wählen
Klicken Sie auf den Schritt Workflow starten. Klicken Sie auf das Feld Trigger, wählen Sie Sonstiges und dann Webhook.
Das sehen Sie:Das Fenster zeigt eine Webhook-URL mit einer Kopieren-Schaltfläche.
- 2
Schritt 2 von 4
Die URL mit einer Bedingung schützen
Die Webhook-URL ist öffentlich. Jeder, der sie kennt, kann den Workflow starten. Fügen Sie daher eine Bedingung hinzu, die nur Ihr System erfüllen kann, zum Beispiel einen geheimen Header.
Verwenden Sie den Tab Builder oder schreiben Sie im Tab Ausdruck einen Ausdruck wie
{{ $request.headers.authorization === "Bearer your-secret" }}. Header-Namen werden kleingeschrieben. Der Workflow startet nur, wenn die gesamte Bedingung wahr ist.Klicken Sie auf Speichern und dann oben im Editor auf Speichern. Änderungen am Trigger werden erst wirksam, wenn Sie den Workflow speichern.
- 3
Schritt 3 von 4
Die Anfragedaten in Ihren Schritten nutzen
Die Anfrage steht in der Variablengruppe Anfrage zur Verfügung:
{{ $request.body.phoneNumber }}: ein Feld aus dem Anfragetext{{ $request.query.source }}: ein Abfrageparameter, aus?source=...in der URL{{ $request.headers.authorization }}: ein Header{{ $request.method }}: die HTTP-Methode
Verwenden Sie zum Beispiel
{{ $request.body.emailAddress }}als Empfänger eines Schritts Benachrichtigung senden. - 4
Schritt 4 von 4
Eine Anfrage senden
Senden Sie aus Ihrem anderen System eine POST-Anfrage mit einem JSON- oder Formular-Body an die Webhook-URL.
Das sehen Sie:Die Antwort hat den Status 202 und eine
executionId. Sie ist leer, wenn die Bedingung nicht erfüllt wurde. Die Ausführung erscheint im Verlauf des Workflows.
Limits und Fehler bei Webhooks
- Jeder Webhook nimmt bis zu 60 Anfragen pro Minute und 1.000 pro Stunde an. Anfragen über dem Limit werden abgelehnt.
- Ist der Workflow ausgeschaltet, wird die Anfrage mit dem Hinweis abgelehnt, dass der Workflow nicht aktiv ist.
- Ist das Abonnement Ihres Salons nicht aktiv, wird die Anfrage abgelehnt.
- Cookies und Softalon-Sitzungsheader werden nicht an den Workflow weitergegeben.
Einen Workflow manuell starten
- 1
Schritt 1 von 2
Den Trigger Manuell wählen
Klicken Sie auf den Schritt Workflow starten. Klicken Sie auf das Feld Trigger, wählen Sie Sonstiges und dann Manuell. Speichern Sie den Schritt und den Workflow.
- 2
Schritt 2 von 2
Ausführen
Öffnen Sie auf der Seite Workflows das Menü auf der Karte des Workflows und klicken Sie auf Ausführen. Die Option erscheint nur bei Workflows mit dem Trigger Manuell, und der Workflow muss aktiv sein.
Das sehen Sie:Die Meldung Workflow gestartet. Die Ausführung erscheint im Verlauf.
Eine manuelle Ausführung hat kein Ereignis. Daher stehen nur die Variablen unter Sonstiges zur Verfügung, etwa der Name Ihres Salons. Empfänger müssen feste Adressen sein, zum Beispiel Ihre eigene E-Mail-Adresse.
Häufige Fragen
Nein. Die Webhook-URL nimmt nur POST-Anfragen an.