Variáveis dinâmicas {{ }}

Visão geral

Variáveis dinâmicas deixam você escrever uma mensagem que chega personalizada para cada pessoa. Em vez de "Olá!", você escreve Olá {{ contact.first_name }}! e cada contato recebe o próprio nome.

A variável é sempre escrita entre chaves duplas e resolvida no servidor, no momento do envio — nunca no navegador. Se o dado não existir, a variável vira texto vazio, e o restante da mensagem segue normalmente.

Todas as variáveis usam o mesmo vocabulário em todas as superfícies: o que funciona no compositor de resposta funciona igual no e-mail, na campanha, no follow-up, no fluxo e no contrato.

Pré-requisitos

• Nenhum. As variáveis básicas (contato, conta, caixa de entrada, agente) funcionam desde o primeiro dia.
• As variáveis de um módulo (cobrança, agendamento, contrato, pedido…) só trazem valor quando aquele módulo está em uso na conta. Sem dado, elas resolvem vazio — nunca quebram a mensagem.

Passo a passo

1. Abra qualquer campo de texto que aceite variáveis (compositor, macro, resposta rápida, campanha, follow-up, contrato, lembrete da agenda…).
2. Digite {{ — a lista de variáveis aparece automaticamente.
3. Ou clique no botão {x} Inserir variável, quando disponível no cabeçalho do campo.
4. Busque pelo nome (por exemplo "valor" ou "vencimento") e clique para inserir.
5. Confira o valor antes de enviar. Dentro de uma conversa, cada variável da lista mostra ao lado o que ela vai produzir para aquele contato — o nome real, o valor real da cobrança, a data real do agendamento. O que aparece ali é exatamente o que o cliente vai receber.
6. Envie um teste antes de disparar para a base inteira.

Configurações e opções

Os grupos disponíveis

O seletor mostra apenas os grupos que funcionam naquela tela. Uma campanha, por exemplo, não tem conversa, então variáveis de conversa não são oferecidas ali.

Valores formatados

Todo valor de dinheiro e de data existe em duas formas:

• Crua — o valor como está guardado: {{ crm.value_amount }} → 1500.0
• Formatada — pronta para o cliente ler: {{ crm.value_formatted }} → R$ 1.500,00

O mesmo vale para datas: {{ payment.due_date }} → 2026-08-08 e {{ payment.due_date_formatted }} → 08/08/2026, sempre na moeda, no idioma e no fuso da sua conta.

Se um valor não tiver a versão formatada, você pode formatar na hora com um filtro:

{{ payment.amount | money: 'BRL' }}   →  R$ 1.500,00
{{ booking.starts_at | datetime }}    →  08/08/2026 14:30

Campos personalizados

Os campos personalizados que você criou também viram variáveis, no formato {{ contact.custom_attribute.chave }}. Isso vale para os campos de contato, conversa, empresa, negócio, produto, tarefa, grupo, cobrança, agendamento, follow-up e contrato.

Casos de uso

• Cobrança vencida: Oi {{ contact.first_name }}, sua fatura de {{ payment.amount_formatted }} venceu em {{ payment.due_date_formatted }}. Pague aqui: {{ payment.pay_url }}
• Lembrete de agendamento: Seu horário é {{ booking.date_formatted }} às {{ booking.time_formatted }} com {{ booking.host }}. Precisa remarcar? {{ booking.manage_url }}
• Contrato: {{ contact.first_name }}, seu contrato "{{ contract.title }}" está pronto: {{ contract.sign_url }}
• Convite de grupo: Bem-vindo! Entre na {{ group.name }}: {{ group.invite_url }}

Dicas, limites e boas práticas

• Sempre envie um teste. É a forma mais rápida de ver se a variável trouxe o valor esperado.
• Dado ausente vira vazio. Escreva a frase de modo que ela continue fazendo sentido sem o valor — evite "Seu pedido de chegou".
• Em campanhas, cuidado redobrado. Se uma variável usada no modelo aprovado não resolver para um destinatário, aquele destinatário é pulado. Prefira variáveis que você tem certeza de que existem.
• Documento fiscal: em mensagens, o CPF/CNPJ só aparece mascarado ({{ contact.masked_tax_id }}). O documento completo é exclusivo de contratos, onde a própria pessoa assina.
• Não invente variáveis. Se não está no seletor, não existe — e vai sair vazia.
• Onde o valor não aparece. Fora de uma conversa (macro, resposta rápida, campanha, modelo de contrato) não há contato definido ainda, então a lista mostra só o nome da variável. É o comportamento correto: ali a variável ainda não tem um dono.
• Se o seu papel esconde um dado, o valor aparece escondido também. Um agente que vê a***@example.com no cadastro vê a***@example.com na lista de variáveis — a mensagem enviada é que carrega o valor real.

Solução de problemas

Veja também

• Modelos de mensagem por módulo