Skip to main content
Vários campos de uma automação aceitam variáveis. Em vez de escrever “O projeto entrou na etapa”, você escreve o nome real do projeto, o cliente, quem moveu e a data.
Esta página trata do que está disponível dentro de uma automação. Para a linguagem em si — condicionais, laços, filtros — veja Sintaxe avançada.

​
A forma básica

Variáveis são escritas entre chaves duplas:
Blocos de lógica usam chave e porcentagem:
Não é preciso decorar nada. O editor mostra a lista de variáveis disponíveis em cada campo que aceita esse recurso.

​
O que fica disponível

Toda automação recebe um conjunto de dados no momento da execução.

​
O projeto

project traz os dados do projeto que acionou a automação:
Etiquetas, funis e etapas não vêm carregados por padrão no contexto. Para acessá-los, use a consulta project_details descrita mais abaixo.

​
Quem disparou

user existe apenas quando o disparo veio de uma pessoa:
Em automações disparadas por agendamento — projeto ocioso ou data atingida — não existe user. Proteja o texto antes de usá-lo:

​
O evento

trigger traz os dados do disparo. O conteúdo varia conforme o gatilho:
Não tem certeza do que veio no evento? Publique {{ trigger|json(true) }} no conteúdo do projeto em uma automação de teste e veja tudo o que chegou.

​
O resultado dos componentes anteriores

Cada componente executado deposita o próprio resultado no contexto, disponível para os componentes seguintes. É um recurso avançado: o identificador do componente faz parte do nome da variável, então ele muda se o componente for recriado.

​
Onde as variáveis funcionam

Conteúdo do projeto, assunto e corpo de e-mail, corpo customizado de webhook.
Todos os campos de criação de cliente, contato e projeto, incluindo respostas de formulário.
A opção de sintaxe avançada da ação Alterar campo de data.
Endereços de e-mail e o destinatário de uma linha externa de comunicação.
O desenho da árvore em Criar hierarquia de projetos.

​
Buscando dados adicionais

Quando o contexto não tem o que você precisa, a função query busca. Ela recebe o nome da consulta e os parâmetros:
project_details também aceita id no lugar de project_code. As consultas são resolvidas dentro da sua conta — não há como acessar dados de outra.
Exemplo: listar as etiquetas do projeto em uma mensagem

​
Menções

Para transformar um usuário em uma menção clicável, use o filtro mention:

Mencionar usuários com automação

O formato completo das menções e como montá-las a partir de qualquer dado que contenha um usuário.

​
Devolvendo listas em vez de texto

Alguns campos não esperam texto, e sim uma lista — a lista de usuários atribuídos, os projetos que receberão um cliente. Nesses casos a expressão precisa terminar em uma lista válida, e o filtro json é o caminho:
Uma expressão que devolve texto solto onde se espera uma lista faz a ação registrar erro. O registro de execução mostra exatamente o texto gerado — compare com o formato esperado.

​
Limites do mecanismo

Expressões rodam dentro de um ambiente controlado, com tetos para proteger a execução: Somente um conjunto conhecido de blocos, filtros e funções é permitido. Os blocos disponíveis são if, elseif, else, set, for e apply; entre as funções estão query, date, range, max, min, abs, round e number_format. A lista de filtros está em Sintaxe avançada.

​
Quando a expressão falha

Um erro de expressão — variável inexistente usada de forma inválida, formato incorreto, limite estourado — faz o componente registrar template_error com a mensagem do problema. O que acontece depois depende da ação: a maioria registra o erro e o fluxo segue.
A variável usada não existia no contexto. Proteja com is defined ou com o filtro default:
Confira no registro de execução o valor gerado. Ele aparece nos dados extras do componente e costuma revelar o campo errado ou a consulta sem resultado.
Caracteres especiais são escapados por segurança. Quando o campo espera HTML já formatado, aplique o filtro raw.

​
Por onde continuar

Sintaxe avançada

A linguagem completa: condicionais, laços, filtros e operadores.

Mencionar usuários

Menções dentro de mensagens automáticas.

Logs e depuração

Ver o que a expressão gerou em uma execução real.

Receitas prontas

Montagens completas que usam variáveis na prática.