Erklärt

Variablen in Workflows verwenden

Fügen Sie Details wie den Namen des Kunden, die Terminzeit oder die Salonadresse in Workflow-Schritte ein und formatieren Sie sie mit Hilfsfunktionen.

5 Min. LesezeitRolle: Super-Administrator oder höherAutomatisierungenAktualisiert am 25. Oktober 2026
In der App öffnen

Variablen setzen beim Ausführen eines Workflows echte Details ein, etwa den Vornamen des Kunden oder die Startzeit des Termins. Sie können sie in jedem Textfeld eines Schritts verwenden: Empfänger, Betreff, Nachrichteninhalt, Bedingungen, URLs und Anfrageinhalte.

Eine Variable ist ein Ausdruck zwischen doppelten geschweiften Klammern, zum Beispiel {{ $event.data.object.client.firstName }}. Wenn die Ausführung den Schritt erreicht, ersetzt Softalon ihn durch den Wert. Alles innerhalb der Klammern funktioniert wie ein kleines Stück JavaScript.

Eine Variable einfügen

Klicken Sie neben einem Feld auf Variable einfügen. Der Dialog Variable auswählen öffnet sich mit Vorgeschlagene Variablen für dieses Feld. Klicken Sie auf Alle Variablen anzeigen, um alles zu durchsuchen, oder suchen Sie nach dem Namen. Wählen Sie eine Gruppe, um tiefer zu gehen, und dann einen Wert.

In Feldern wie Empfänger zeigt der Dialog nur passende Werte, zum Beispiel E-Mail-Adressen für eine E-Mail.

Unter dem Text zeigt eine Vorschau, wie die Nachricht mit Beispielwerten aussieht.

Variablengruppen

Was Sie auswählen können, hängt vom Trigger und vom Schritt vor dem aktuellen Schritt ab.

GruppeWas sie enthältBeispiel
EreignisDetails des Ereignisses, das die Ausführung gestartet hat: seinen Typ, den Zeitpunkt und seine Daten.{{ $event.timestamp }}
Der Datensatz des Triggers, zum Beispiel Termin oder KundeDer Datensatz, um den es beim Ereignis geht, mit seinen verknüpften Datensätzen.{{ $event.data.object.status }}
Vorheriger Datensatz, zum Beispiel Termin (vorher)Die Werte vor der Änderung, bei Aktualisierungs-Triggern.{{ $event.data.previousAttributes.status }}
Vorheriger KnotenDas Ergebnis des letzten Schritts, der etwas gesendet oder ein anderes System aufgerufen hat.{{ $previousNode.sent }}
AnfrageDie Anfrage, die einen Webhook-Workflow gestartet hat.{{ $request.body.phoneNumber }}
SonstigesDie Daten Ihres Salons: Salon, Zeitzone, Wochenbeginn, Zeitformat, Datumsformat, Kontaktdaten und Soziale Medien.{{ $salon.name }}

Sonstiges ist in jedem Workflow verfügbar. Ereignis und die Datensatzgruppen sind für Workflows mit Webhook und Manuell nicht verfügbar, weil kein Ereignis sie startet.

Verknüpfte Datensätze

Bei einem Termin-Trigger kommt der Termin mit seinem Kunde, Mitarbeiter, seiner Dienstleistung und seinem Standort. Zum Beispiel:

  • {{ $event.data.object.client.firstName }}: der Vorname des Kunden
  • {{ $event.data.object.member.firstName }}: der Vorname des Mitarbeiters
  • {{ $event.data.object.service.name }}: der Name der Dienstleistung

Softalon lädt verknüpfte Datensätze wie den Kunden oder die Dienstleistung, wenn ein Schritt sie als einfache Variable verwendet, zum Beispiel {{ $event.data.object.client.emailAddress }}. Wenn Sie einen verknüpften Datensatz nur innerhalb einer Funktion oder eines Vergleichs verwenden, nutzen Sie ihn zusätzlich irgendwo im Workflow als einfache Variable. Sonst bleiben seine Werte möglicherweise leer.

Vorherige Werte

Bei Triggern vom Typ Aktualisiert und anderen Triggern, die auf eine Änderung reagieren, enthält $event.data.previousAttributes die alten Werte der geänderten Felder. Unveränderte Felder sind nicht enthalten. Bei Verschoben ist {{ $event.data.previousAttributes.startAt }} zum Beispiel die alte Startzeit.

Datum, Geldbeträge und Adressen formatieren

Datums-, Betrags- und Standortvariablen bieten in der Auswahl formatierte Versionen an. Sie können sie auch selbst schreiben:

HilfsfunktionWas sie zurückgibtBeispiel
DatumDas Datum im Datumsformat Ihres Salons.{{ date($event.data.object.startAt) }}
UhrzeitDie Uhrzeit im 12- oder 24-Stunden-Format Ihres Salons.{{ time($event.data.object.startAt) }}
Datum & UhrzeitBeides.{{ datetime($event.data.object.startAt) }}
JahrNur das Jahr.{{ year($event.data.object.startAt) }}
Währung FormatiertEin Betrag im Währungsformat Ihres Salons.{{ currency($event.data.object.total) }}
Dauer FormatiertEine Anzahl Minuten als gut lesbare Dauer.{{ duration(90) }}
AdresseDie Adresse eines Standorts in einer Zeile.{{ address($event.data.object.location) }}
RoutenlinkEin Google-Maps-Link zu einem Standort.{{ directionsLink($event.data.object.location) }}

Datum und Uhrzeit verwenden die Zeitzone Ihres Salons. In einer Nachricht an den Kunden des Triggers, der aus einer anderen Zeitzone gebucht hat, wird die Zeitzone des Kunden verwendet.

actionLink erstellt einen Kurzlink, mit dem ein Kunde ohne Anmeldung etwas mit einem Termin oder einer Rechnung tun kann. Übergeben Sie die ID des Datensatzes und die Aktion:

  • {{ actionLink($event.data.object.id, "confirm") }}
  • {{ actionLink($event.data.object.id, "reschedule") }}
  • {{ actionLink($event.data.object.id, "cancel") }}
  • {{ actionLink($event.data.object.id, "review") }}

Was jeder Link bewirkt, lesen Sie unter Einem Kunden einen Bestätigungs-, Verschiebungs- oder Bewertungslink senden.

Ausdrücke

Da der Inhalt der Klammern JavaScript ist, können Sie kleine Umwandlungen vornehmen, zum Beispiel {{ $event.data.object.client.firstName.toUpperCase() }} oder {{ $event.data.object.notes || "No notes" }}.

Bestimmter Code ist aus Sicherheitsgründen nicht erlaubt, etwa das Definieren von Funktionen, das Zuweisen von Werten oder der Zugriff auf Systemobjekte. Wenn Sie ihn verwenden, lässt sich der Workflow nicht speichern.

Wenn ein Ausdruck beim Ausführen des Workflows fehlschlägt, wird er durch leeren Text ersetzt, und die Ausführung läuft weiter.

Häufige Fragen

Der Datensatz hat diesen Wert möglicherweise nicht, zum Beispiel ein Kunde ohne Nachnamen. Prüfen Sie außerdem, ob verknüpfte Datensätze irgendwo im Workflow als einfache Variable verwendet werden.