Explicação

Use variáveis nas automações

Insira detalhes como o nome do cliente, o horário do agendamento ou o endereço do salão nas etapas da automação e formate-os com funções auxiliares.

5 min de leituraFunção: Super Administrador ou superiorAutomaçõesAtualizado em 25 de outubro de 2026
Abrir no app

As variáveis preenchem detalhes reais quando uma automação roda, como o nome do cliente ou o horário de início do agendamento. Você pode usá-las em qualquer campo de texto de uma etapa: destinatários, assuntos, conteúdo das mensagens, condições, URLs e corpos de requisição.

Uma variável é uma expressão entre chaves duplas, como {{ $event.data.object.client.firstName }}. Quando a execução chega à etapa, o Softalon a substitui pelo valor. Tudo o que fica dentro das chaves funciona como um pequeno trecho de JavaScript.

Insira uma variável

Clique em Inserir Variável ao lado de um campo. A janela Selecionar Variável se abre com Variáveis Sugeridas para aquele campo. Clique em Ver Todas as Variáveis para navegar por tudo, ou pesquise pelo nome. Escolha um grupo para ir mais fundo e depois escolha um valor.

Em campos como Destinatário, a janela mostra apenas os valores compatíveis, por exemplo endereços de e-mail para um e-mail.

Abaixo do texto, uma Pré-visualização mostra como a mensagem fica com valores de exemplo.

Grupos de variáveis

O que você pode escolher depende do gatilho e da etapa anterior à atual.

GrupoO que contémExemplo
EventoDetalhes do evento que iniciou a execução: o tipo, o momento em que aconteceu e os dados.{{ $event.timestamp }}
O registro do gatilho, por exemplo Agendamento ou ClienteO registro a que o evento se refere, com os registros relacionados.{{ $event.data.object.status }}
Registro anterior, por exemplo Agendamento (antes)Os valores antes da mudança, em gatilhos de atualização.{{ $event.data.previousAttributes.status }}
Nó AnteriorO resultado da última etapa que enviou algo ou chamou outro sistema.{{ $previousNode.sent }}
RequisiçãoA requisição que iniciou uma automação de Webhook.{{ $request.body.phoneNumber }}
OutrosOs dados do seu salão: Salão, Fuso Horário, Início da Semana, Formato de Hora, Formato de Data, Dados de Contato e Redes Sociais.{{ $salon.name }}

Outros fica disponível em todas as automações. Evento e os grupos de registro não ficam disponíveis em automações de Webhook e Manual, porque nenhum evento as inicia.

Registros relacionados

Em um gatilho de agendamento, o agendamento vem com Cliente, Membro, Serviço e Local. Por exemplo:

  • {{ $event.data.object.client.firstName }}: o nome do cliente
  • {{ $event.data.object.member.firstName }}: o nome do membro da equipe
  • {{ $event.data.object.service.name }}: o nome do serviço

O Softalon carrega registros relacionados, como o cliente ou o serviço, quando uma etapa os usa como variável simples, por exemplo {{ $event.data.object.client.emailAddress }}. Se você usar um registro relacionado apenas dentro de uma função ou de uma comparação, use-o também como variável simples em algum lugar da automação. Caso contrário, os valores dele podem sair vazios.

Valores anteriores

Em gatilhos Atualizado e em outros gatilhos que reagem a uma mudança, $event.data.previousAttributes contém os valores antigos dos campos que mudaram. Os campos que não mudaram não aparecem ali. Por exemplo, em Reagendado, {{ $event.data.previousAttributes.startAt }} é o horário de início antigo.

Formate datas, valores e endereços

Variáveis de data, valor e local oferecem versões formatadas no seletor. Você também pode escrevê-las:

FunçãoO que retornaExemplo
DataA data no formato de data do seu salão.{{ date($event.data.object.startAt) }}
HoraO horário no formato de 12 ou 24 horas do seu salão.{{ time($event.data.object.startAt) }}
Data e HoraOs dois.{{ datetime($event.data.object.startAt) }}
AnoSó o ano.{{ year($event.data.object.startAt) }}
Moeda FormatadaUm valor no formato de moeda do seu salão.{{ currency($event.data.object.total) }}
Duração FormatadaUm número de minutos como uma duração legível.{{ duration(90) }}
EndereçoO endereço de um local em uma linha.{{ address($event.data.object.location) }}
Link de RotasUm link do Google Maps para um local.{{ directionsLink($event.data.object.location) }}

Datas e horários usam o fuso horário do seu salão. Em uma mensagem para o cliente do gatilho que agendou de outro fuso horário, eles usam o fuso horário do cliente.

actionLink cria um link curto que permite ao cliente agir sobre um agendamento ou uma fatura sem entrar na conta. Informe o ID do registro e a ação:

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

Consulte Envie ao cliente um link de confirmação, reagendamento ou avaliação para saber o que cada link faz.

Expressões

Como o conteúdo das chaves é JavaScript, você pode fazer pequenas transformações, como {{ $event.data.object.client.firstName.toUpperCase() }} ou {{ $event.data.object.notes || "No notes" }}.

Alguns códigos não são permitidos por segurança, como definir funções, atribuir valores ou acessar objetos do sistema. Se você usá-los, a automação não pode ser salva.

Se uma expressão falhar quando a automação rodar, ela é substituída por texto vazio e a execução continua.

Perguntas frequentes

O registro pode não ter esse valor, como um cliente sem sobrenome. Confira também se os registros relacionados são usados como variável simples em algum lugar da automação.