Automações
Variáveis e campos nas mensagens
Como colocar o nome do contato, campos personalizados, datas formatadas e dados de webhook, grupo ou empresa dentro das mensagens dos fluxos.
Resposta rápida
Variável é um trecho entre chaves duplas, como {{contact.first_name}}, que vira o dado do contato na hora do envio. Para inserir, clique no @ do campo de texto (Inserir variável) e escolha na lista, ou digite {{ direto no texto para abrir a mesma lista.
Como inserir
- 1
Abra o seletor
No painel do bloco, clique no @ do canto do campo de texto. Em alguns campos o botão aparece com o nome Variáveis.
1- 1Buscar variável
O seletor de variáveis, com a busca e as seções. - 2
Escolha a variável
Busque pelo nome ou role a lista. As variáveis vêm em três seções: Contato, Personalizados (os campos personalizados do projeto) e Sistema (campos com um valor só para o projeto todo).
- 3
Confira no texto
A variável entra no texto como uma etiqueta. Na hora do envio, ela é trocada pelo valor do contato.
Atalho
No texto das mensagens do bloco Enviar Mensagem, digite {{ e a lista abre sozinha. Nos outros campos, use o @.
Variáveis do contato
| Variável | Vira |
|---|---|
{{name}} | Nome completo do contato |
{{contact.first_name}} | Primeiro nome, com a primeira letra maiúscula |
{{phone}} | Telefone |
{{email}} | |
{{custom_fields.chave}} | Valor de um campo personalizado (troque chave pela chave do campo) |
{{system.chave}} | Valor de um campo do sistema |
{{ad.headline}}, {{ad.source_url}} | Título e link do anúncio Click-to-WhatsApp que trouxe a mensagem |
{{reply.class}}, {{reply.confidence_pct}} | Classe da resposta (humana ou automática) e a confiança, quando o classificador está ligado |
{{deal.id}}, {{deal.created}} | Dados do negócio criado pelo bloco Criar Negócio |
Valor reserva para o primeiro nome
Contato salvo só com o telefone não tem nome. Para não sair "Oi, !", use um valor reserva depois de uma barra:
Oi, {{contact.first_name|tudo bem}}! Sua vaga está garantida.Sem nome, a mensagem sai "Oi, tudo bem! Sua vaga está garantida."
Datas formatadas
Variáveis de data (campos do tipo data, por exemplo) aceitam um formato depois da barra, sempre no fuso do projeto:
{{custom_fields.data_aula|dia_semana}}sai como sexta, 16/10|dia_semana_longosai como sexta-feira|data_curtasai como 16/10|datasai como 16/10/2026|horasai como 15h ou 15h30|data_horasai como 16/10 às 15h
No seletor, as variáveis de data têm um submenu de formato. Se a data não tiver hora, |hora sai vazio e |data_hora sai só com a data.
Variáveis que dependem do gatilho
Estas só têm valor quando o fluxo começou pelo gatilho ou passou pelo bloco correspondente:
| Variável | De onde vem |
|---|---|
{{webhook.campo}} | O conteúdo recebido pelo gatilho Webhook HTTP (use o caminho do campo, por exemplo {{webhook.customer.name}}) |
{{httpResponse.campo}} | A resposta do último bloco Requisição HTTP |
{{group.name}}, {{group.sender_name}}, {{group.sender_phone}} | Gatilho Mensagem em Grupo: nome do grupo e quem escreveu |
{{participant.phone}}, {{group.campaign_name}} | Gatilhos Entrou no Grupo e Saiu do Grupo |
{{company.name}}, {{company.role}} | Empresa principal do contato e o cargo dele nela |
{{trigger.old_value}}, {{trigger.new_value}} | Gatilho Campo Alterado: valor antes e depois |
{{decision.nome.label}} | Resultado do bloco Decisão (Jev) |
{{contact_message.text}} | O texto da mensagem que o contato mandou |
Variáveis em templates da Meta
Templates aprovados pela Meta usam variáveis numeradas: {{1}}, {{2}}. No bloco Template WhatsApp (e no disparo em massa), você escolhe o que entra em cada número: um campo do contato ou um texto fixo. Veja Templates da Meta.
Se algo der errado
| Sintoma | Causa provável | O que fazer |
|---|---|---|
A mensagem saiu com o texto {{...}} literal | Variável escrita errada ou campo que não existe | Insira pelo seletor em vez de digitar à mão |
| A variável saiu vazia | O contato não tem esse dado, ou o gatilho não preenche aquela variável | Use o valor reserva no primeiro nome, ou um bloco Condição que teste se o campo está preenchido |
{{webhook.campo}} vazio | O caminho não bate com o conteúdo recebido | Confira o conteúdo no teste do gatilho Webhook HTTP e use o caminho exato |
| A data saiu num formato estranho | Faltou o formato | Acrescente um formato depois da variável, como mostrado em Datas formatadas |
Perguntas frequentes
Qual a diferença entre {{name}} e {{contact.first_name}}?
{{name}} é o nome inteiro como está no contato. {{contact.first_name}} pega só o primeiro nome, com a primeira letra maiúscula, e aceita valor reserva.
Onde crio um campo personalizado para usar como variável?
Em Contatos, no ícone de configurações (tags, campos, ações), aba Campos personalizados. Veja Tags, campos e ações.
As variáveis funcionam no Instagram e no e-mail?
Sim. Os blocos de mensagem do Instagram e o Enviar Email aceitam as mesmas variáveis do contato.
Artigos relacionados
Todos os blocos do fluxoTags, campos personalizados e açõesReceber e enviar webhooksCriar e aprovar templates da Meta