Approfondimento

Usa le variabili nelle automazioni

Inserisci dettagli come il nome del cliente, l'orario dell'appuntamento o l'indirizzo del salone nei passaggi delle automazioni e formattali con le funzioni di supporto.

5 min di letturaRuolo: Super amministratore o superioreAutomazioniAggiornato il 25 ottobre 2026
Apri nell'app

Le variabili inseriscono dettagli reali quando un'automazione viene eseguita, come il nome del cliente o l'orario di inizio dell'appuntamento. Puoi usarle in qualsiasi campo di testo di un passaggio: destinatari, oggetti, contenuto dei messaggi, condizioni, URL e corpi delle richieste.

Una variabile è un'espressione tra doppie parentesi graffe, come {{ $event.data.object.client.firstName }}. Quando l'esecuzione raggiunge il passaggio, Softalon la sostituisce con il valore. Qualsiasi cosa tra le parentesi funziona come un piccolo frammento di JavaScript.

Inserisci una variabile

Fai clic su Inserisci variabile accanto a un campo. Si apre la finestra Seleziona variabile con le Variabili suggerite per quel campo. Fai clic su Visualizza tutte le variabili per sfogliare tutto, oppure cerca per nome. Scegli un gruppo per entrare nel dettaglio, poi scegli un valore.

In campi come Destinatario, la finestra mostra solo i valori adatti, per esempio gli indirizzi email per un'email.

Sotto il testo, un'Anteprima mostra come appare il messaggio con valori di esempio.

Gruppi di variabili

Cosa puoi scegliere dipende dal trigger e dal passaggio che precede quello attuale.

GruppoCosa contieneEsempio
EventoI dettagli dell'evento che ha avviato l'esecuzione: il tipo, il momento in cui è avvenuto e i suoi dati.{{ $event.timestamp }}
Il record del trigger, per esempio Appuntamento o ClienteIl record a cui si riferisce l'evento, con i record collegati.{{ $event.data.object.status }}
Record (prima), per esempio Appuntamento (prima)I valori prima della modifica, nei trigger di aggiornamento.{{ $event.data.previousAttributes.status }}
Nodo precedenteIl risultato dell'ultimo passaggio che ha inviato qualcosa o chiamato un altro sistema.{{ $previousNode.sent }}
RichiestaLa richiesta che ha avviato un'automazione Webhook.{{ $request.body.phoneNumber }}
AltroI dati del tuo salone: Salone, Fuso orario, Inizio settimana, Formato ora, Formato data, Dati di contatto e Social media.{{ $salon.name }}

Altro è disponibile in ogni automazione. Evento e i gruppi dei record non sono disponibili per le automazioni Webhook e Manuale, perché nessun evento le avvia.

Record collegati

Per un trigger di appuntamento, l'appuntamento include il suo Cliente, Membro, Servizio e Sede. Per esempio:

  • {{ $event.data.object.client.firstName }}: il nome del cliente
  • {{ $event.data.object.member.firstName }}: il nome del membro del team
  • {{ $event.data.object.service.name }}: il nome del servizio

Softalon carica i record collegati, come il cliente o il servizio, quando un passaggio li usa come variabile semplice, per esempio {{ $event.data.object.client.emailAddress }}. Se usi un record collegato solo dentro una funzione o un confronto, usalo anche come variabile semplice da qualche parte nell'automazione. Altrimenti i suoi valori potrebbero risultare vuoti.

Valori precedenti

Nei trigger Aggiornato e negli altri trigger che reagiscono a una modifica, $event.data.previousAttributes contiene i vecchi valori dei campi modificati. I campi che non sono cambiati non sono inclusi. Per esempio, con Riprogrammato, {{ $event.data.previousAttributes.startAt }} è il vecchio orario di inizio.

Formatta date, importi e indirizzi

Le variabili di data, importo e sede offrono versioni formattate nel selettore. Puoi anche scriverle tu:

FunzioneCosa restituisceEsempio
DataLa data nel formato data del tuo salone.{{ date($event.data.object.startAt) }}
OraL'ora nel formato a 12 o 24 ore del tuo salone.{{ time($event.data.object.startAt) }}
Data e oraEntrambe.{{ datetime($event.data.object.startAt) }}
AnnoSolo l'anno.{{ year($event.data.object.startAt) }}
Valuta FormattatoUn importo nel formato valuta del tuo salone.{{ currency($event.data.object.total) }}
Durata FormattatoUn numero di minuti come durata leggibile.{{ duration(90) }}
IndirizzoL'indirizzo di una sede su una riga.{{ address($event.data.object.location) }}
Link indicazioni stradaliUn link Google Maps a una sede.{{ directionsLink($event.data.object.location) }}

Date e orari usano il fuso orario del tuo salone. In un messaggio al cliente del trigger che ha prenotato da un altro fuso orario, usano il fuso orario del cliente.

actionLink crea un link breve che permette a un cliente di agire su un appuntamento o una fattura senza accedere. Passa l'ID del record e l'azione:

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

Vedi Invia a un cliente un link per confermare, riprogrammare o recensire per sapere cosa fa ogni link.

Espressioni

Dato che il contenuto delle parentesi è JavaScript, puoi fare piccole trasformazioni, come {{ $event.data.object.client.firstName.toUpperCase() }} o {{ $event.data.object.notes || "No notes" }}.

Per sicurezza, alcuni tipi di codice non sono consentiti, come definire funzioni, assegnare valori o accedere a oggetti di sistema. Se li usi, l'automazione non può essere salvata.

Se un'espressione non riesce durante l'esecuzione dell'automazione, viene sostituita con un testo vuoto e l'esecuzione continua.

Domande frequenti

Il record potrebbe non avere quel valore, come un cliente senza cognome. Controlla anche che i record collegati siano usati come variabile semplice da qualche parte nell'automazione.