Skip to main content
Com variáveis, pode inserir dados dinâmicos, como o nome de um candidato, um cargo ou um salário, diretamente nos seus emails, mensagens de WhatsApp, formulários e automações.

​
Como é uma variável

Uma variável é uma chave de campo envolvida por chavetas duplas:
Quando isto é enviado a uma candidata chamada Sofia a candidatar-se a uma vaga de Backend Engineer, torna-se:
Os espaços dentro das chavetas são opcionais:
  • {{candidate.first_name}} e {{ candidate.first_name }} comportam-se da mesma forma.

​
Como uma variável aparece no editor

Todos os editores que aceitam variáveis mostram cada uma como um badge com o nome de apresentação do campo, como Recipient: First Name. O badge é um único objeto no canvas, não os carateres que representa. Quatro badges num parágrafo de email: Recipient: First Name, Recipient: First Name com um ícone de varinha e um 3, um badge 'text' com cor e um ícone de varinha, e um badge laranja documentation_missing_key com um ícone de aviso
  • Uma variável com modificadores acrescenta um ícone de varinha, e um número quando há dois ou mais.
  • Um literal como {{ "text" | uppercase }} recebe um badge com cor.
  • Uma chave que a HireData não reconhece recebe um badge laranja de aviso.

​
O popover

Um parágrafo de email com quatro badges, Recipient: First Name, Recipient: First Name com um ícone de varinha e um 3, um badge text com cor e um badge laranja documentation_missing_key, e um popover aberto sob o segundo badge com Input Callum, Lowercase, Capitalise words, Use a fallback there e Output Callum Passe o cursor sobre um badge para ver o que contém: a descrição e as opções do campo quando as tem, o seu valor atual e cada modificador em linguagem simples, com o resultado no fim. O popover também copia a expressão e liga a esta página. O valor depende de onde está. O construtor de formulários e o construtor de emails mostram o valor de exemplo da HireData para o campo. O separador Forms de um registo mostra o valor desse registo. Um passo de automação mostra o valor por defeito do campo, porque ainda não aconteceu nenhum run.

​
Quando uma variável não é encontrada

Uma chave que a HireData não reconhece torna-se um badge laranja, e o seu popover lê Variable is not found. A expressão fica no seu conteúdo sem alterações, por isso corrija a chave ou remova o badge. Uma variável que elimine da lista Variables de um template torna-se este badge em todos os sítios onde a usou. Um badge laranja a ler documentation_missing_key com um ícone de triângulo, e o seu popover a repetir a chave por cima de uma linha a ler Variable is not found

​
Editar um badge

Coloque o cursor a seguir a um badge e prima Backspace. O badge volta a ser texto, {{ e a expressão completa, modificadores incluídos. Edite-a, escreva o }} de fecho e o badge regressa. O mesmo funciona para uma referência de formulário escrita como @key@. Também pode escrever uma expressão de raiz, modificadores e tudo. Torna-se um badge assim que escreve as chavetas de fecho.

​
Onde pode utilizar variáveis

Pode utilizar variáveis em qualquer sítio onde escreva conteúdo que seja enviado ou armazenado:
  • Email — assuntos e corpos
  • WhatsApp — mensagens e templates
  • Formulários — perguntas e lógica de seguimento
  • Automações — mapeamentos de campos e tarefas agendadas

​
Fornecer um valor por defeito

Se um campo estiver vazio para um dado registo, a variável é substituída por nada. Para mostrar um valor por defeito, utilize o modificador default:
Se o candidato não tem primeiro nome, isto envia “Hi there!”.

​
Transformar valores com modificadores

As variáveis podem fazer mais do que inserir dados brutos. Um modificador altera a forma como o valor aparece. Pode colocar texto em maiúsculas, formatar uma data, arredondar um número e muito mais. Adiciona-se um modificador com um pipe (|):
Pode encadear vários modificadores, e cada um atua sobre o resultado do anterior:
Veja a lista completa na página Modificadores.

​
Gerar um valor em vez de o consultar

Todas as variáveis acima leem um valor que já existe. Quando o valor tem de ser gerado de novo para cada destinatário — uma abertura pessoal, uma frase de aniversário não genérica — utilize antes uma variável de IA. Nunca deixe uma inventar um facto. Datas, salários e termos de contrato pertencem a uma variável normal.