Pular para o conteúdo

Referência

Referência: variáveis

Disponível no módulo Fluxos

Atualizado em 16/11/2026

Variáveis são trechos que o fluxo troca por dados reais na hora de enviar. Em vez de escrever o nome de cada cliente, você escreve {{contato.nome}} e cada pessoa recebe o próprio nome. Este artigo lista todas elas. Para entender o que é um fluxo, veja O que é Fluxos. Para ver as variáveis em um fluxo completo, veja Como criar um fluxo. Os campos de cada gatilho e de cada bloco ficam em Referência: gatilhos, Referência: blocos de conversa e Referência: blocos de lógica.

Nos campos de mensagem do fluxo, digite @. Abre um menu com as variáveis disponíveis, e você escolhe a que quer. O fluxo coloca a variável no ponto onde estava o @.

  • A dica abaixo do campo diz “Digite @ para inserir dados do contato”. Quando o gatilho do fluxo traz dados extras (formulário, agendamento, cobrança e outros), a dica diz “Digite @ para inserir dados do contato ou do formulário”.
  • Cada item do menu mostra a variável entre chaves duplas, uma descrição e um exemplo de valor, depois de um ponto.
  • Se o menu não achar nada, ele mostra “Nenhuma variável encontrada”.

Painel de um bloco Mensagem com o menu @ aberto no campo de texto, mostrando as variáveis de Contato e Atendimento com descrição e exemplo, e a dica Digite @ para inserir dados do contato

Escreva o nome da variável entre chaves duplas, sem aspas: {{grupo.nome}}. As regras:

Regra Detalhe
Letras permitidas Minúsculas sem acento, números, sublinhado (_) e ponto. O ponto separa o grupo do nome.
Espaços dentro das chaves Aceitos. {{ contato.nome }} funciona igual a {{contato.nome}}.
Maiúsculas e acentos Não são reconhecidos. {{Contato.Nome}} não é trocado e a mensagem sai com o texto {{Contato.Nome}} escrito literalmente.
Valor padrão Escreva uma barra vertical e o texto de reserva: `{{campo.cpf

O que acontece quando a variável está vazia ou não existe

Seção intitulada “O que acontece quando a variável está vazia ou não existe”
Situação Exemplo O que o contato recebe
A variável existe, mas o contato não tem o dado {{contato.nome}} de um contato sem nome Nada: o trecho some do texto.
Vazia e no começo de uma linha Linha que começa com {{campo.cpf}} é o seu documento O trecho some e os espaços que vinham depois dele também, então a linha começa direto em “é o seu documento”.
Vazia, com valor padrão `{{campo.cpf sem cpf}}`
O grupo existe, mas o nome não {{contato.cep}} Nada, sem erro. O fluxo não avisa que o nome está errado.
Sem o ponto {{nome}} Nada, sem erro.
Com maiúscula ou acento {{Contato.Nome}} O texto {{Contato.Nome}} aparece literalmente na mensagem.

São as mesmas variáveis das respostas rápidas. Aparecem no menu @ em qualquer fluxo, não importa o gatilho.

Variável O que traz Exemplo
{{contato.nome}} Nome completo do contato. Wender Teixeira
{{contato.primeiro_nome}} Só o primeiro nome. Wender
{{contato.telefone}} Telefone do contato, só com números e com o código do país. 5531999990000
Variável O que traz Exemplo
{{atendimento.id}} Identificador da conversa. 0190f4a2-7c1e-7b3a-9d2f-5e6a8b9c0d1e
{{atendimento.protocolo}} Protocolo do atendimento. Fica vazio quando não há atendimento aberto. #2026-04217
{{atendimento.departamento}} Departamento do atendimento. Suporte
{{atendimento.atendente}} Nome do atendente. Ana
Variável O que traz Exemplo
{{data.hoje}} Data de hoje, no formato dia/mês/ano. 11/08/2026
{{data.agora}} Hora atual, no formato hora:minuto. 14:32
{{data.saudacao}} Saudação conforme o horário: “Bom dia” antes das 12h, “Boa tarde” das 12h às 17h59 e “Boa noite” a partir das 18h. Boa tarde
Variável O que traz Exemplo
{{feriado.hoje}} “sim” se hoje é feriado e “não” se não é. não
{{feriado.nome}} Nome do feriado de hoje. Vazio quando hoje não é feriado. Corpus Christi

Os campos personalizados que você cria na conta também viram variáveis, uma para cada campo.

Variável O que traz
{{campo.chave}} O valor do campo personalizado do contato.
{{empresa.chave}} O valor do campo personalizado da empresa do contato.

Troque chave pela chave do campo, que usa letras minúsculas e sublinhado (por exemplo, {{campo.data_nascimento}}). No menu @, cada campo aparece com o nome dele como descrição.

O valor sai formatado conforme o tipo do campo:

Tipo do campo Como sai na mensagem
Dinheiro R$ 1.234,56
CPF, CNPJ e telefone Com a pontuação do documento ou do telefone.
Endereço Em uma linha só.
Arquivo O nome do arquivo.
Data Dia/mês/ano.
Lista Os itens separados por vírgula.
Usuário O nome do usuário da equipe.

Campos marcados como sensíveis ou ocultos para você não aparecem no menu @ e são deixados de fora no teste do fluxo. Se o contato não preencheu o campo, a variável fica vazia. Use o valor padrão para cobrir esse caso, por exemplo {{campo.cidade|sua cidade}}.

São variáveis que o próprio fluxo cria enquanto roda. Elas valem só naquela execução: quando a execução termina, deixam de existir. Para guardar um dado de forma permanente, use a ação Definir campo para gravá-lo no contato.

Variável De onde vem
{{variavel.nome}} Qualquer variável criada pelo fluxo. Troque nome pelo nome que você deu. Quem cria: uma Pergunta que guarda a resposta em uma variável, a ação Definir variável, e o bloco Chamar API (cada par “nome: valor” mapeado a partir da resposta da API).
{{variavel.cobranca.erro}} O motivo da falha de uma cobrança. É preenchida quando a cobrança sai pela saída Falhou. No teste, vale “Simulado: a cobrança falhou”.
{{variavel.nome}} e {{variavel.nome.pergunta}} de um formulário Quando uma Pergunta do tipo formulário do WhatsApp guarda as respostas em uma variável: a primeira traz o resumo de todas as respostas e a segunda traz a resposta de uma pergunta só.
{{form.pergunta}} A resposta de uma pergunta do formulário do WhatsApp, quando o formulário é o gatilho do fluxo ou o bloco Pergunta usa um formulário.
{{payload.campo}} Cada campo que o gatilho Webhook recebeu do sistema externo. Troque campo pelo nome da variável que você escolheu no mapeamento do gatilho.
{{gatilho.campo}} Dado que o gatilho trouxe. Veja a tabela por gatilho.

Os nomes das variáveis que você mesmo cria aceitam só letras minúsculas, números e sublinhado. Uma resposta em branco de formulário aparece no painel de execuções como “não respondido”.

Trazem dados da última mensagem que o contato enviou.

Variável O que traz Exemplo
{{mensagem.texto}} O texto da última mensagem. Em áudio, a transcrição. Em mídia sem texto, sai [imagem], [áudio], [vídeo], [documento], [figurinha], [localização] ou [contato]. Se não der para ler, sai [mensagem sem texto]. quero orçamento
{{mensagem.tipo}} O tipo da mensagem, em inglês: text, image, audio, video, document, sticker, location, contacts e outros. audio
{{mensagem.transcricao}} A transcrição de um áudio. Vazia quando a transcrição não ficou pronta. quero orçamento
{{mensagem.descricao}} A descrição de uma imagem ou o texto de um documento. comprovante de R$ 240,00

Estas só existem quando o fluxo começa por um gatilho do tipo certo. Algumas aparecem no menu @. Outras o fluxo preenche, mas não aparecem no menu: nesse caso, escreva o nome na mão. Se você usar uma variável de gatilho em um fluxo que começa por outro gatilho, ela sai vazia.

Gatilho Grupo no menu Variáveis
Agendamento próximo e Agendamento faltou Compromisso {{gatilho.servico}} serviço (Consulta); {{gatilho.profissional}} quem atende (Dra. Ana); {{gatilho.inicio}} dia e hora (terça-feira, 04/11, 14:30); {{gatilho.link}} link da reunião (https://meet.google.com/abc-defg-hij); {{gatilho.preparo}} como se preparar (Venha em jejum de 8 horas).
Vaga da lista de espera Vaga oferecida {{gatilho.servico}}; {{gatilho.profissional}}; {{gatilho.inicio}} dia e hora da vaga; {{gatilho.expira}} prazo para aceitar (04/11, 12:30); {{gatilho.preparo}}.
Pedido entregue Pedido {{gatilho.pedido}} número do pedido (1024); {{gatilho.cliente}} nome de quem comprou (Ana Lima); {{gatilho.total}} total do pedido (R$ 189,90).
Gatilhos de cobrança Cobrança {{cobranca.valor}} valor (R$ 150,00); {{cobranca.descricao}} descrição (Mensalidade de novembro); {{cobranca.vencimento}} vencimento (13/11/2026); {{cobranca.link}} link de pagamento; {{cobranca.pix_copia_cola}} Pix copia e cola; {{cobranca.linha_boleto}} linha digitável do boleto; {{cobranca.comprovante}} link do comprovante; {{cobranca.forma_pagamento}} forma de pagamento usada (Pix); {{cobranca.data_pagamento}} data do pagamento (11/11/2026); {{cobranca.id}} código da cobrança.
Gatilhos de cobrança Negócio da cobrança {{negocio.titulo}} título do negócio (Plano anual); {{negocio.valor}} valor do negócio (R$ 1.800,00); {{negocio.funil}} funil (Vendas); {{negocio.etapa}} etapa (Proposta).
Formulário do anúncio (lead do Meta) Formulário do anúncio {{gatilho.nome}} nome do lead (Ana Lima); {{gatilho.telefone}} telefone do lead (+5511999990000); {{gatilho.email}} e-mail (ana@exemplo.com); {{gatilho.formulario}} nome do formulário (Orçamento); {{gatilho.formulario_id}} identificador do formulário; {{gatilho.pagina}} nome da página (Loja); {{gatilho.anuncio}} nome do anúncio (Promoção de setembro); {{gatilho.conjunto}} conjunto de anúncios (Público frio); {{gatilho.campanha}} campanha (Leads SP); {{gatilho.plataforma}} plataforma (facebook); {{gatilho.organico}} veio sem anúncio (não); {{gatilho.recebido_em}} recebido em (17/09/2026 12:00). Mais uma variável por pergunta do formulário, no formato {{gatilho.campo_pergunta}}, descrita como “Resposta: texto da pergunta”.
Formulário do WhatsApp Formulário do WhatsApp {{form.pergunta}} para cada pergunta do formulário; se o bloco guarda as respostas em uma variável, também {{variavel.nome}} (resumo das respostas) e {{variavel.nome.pergunta}}.

Variáveis que o fluxo preenche mas o menu não mostra

Seção intitulada “Variáveis que o fluxo preenche mas o menu não mostra”

Escreva o nome na mão. O formato e o exemplo são os de cada gatilho.

Gatilho Variáveis
Comentário em publicação {{gatilho.texto}} texto do comentário; {{gatilho.comentario}} identificador do comentário; {{gatilho.publicacao}} identificador da publicação.
Negócio muda de etapa {{gatilho.pipeline}} funil; {{gatilho.etapa}} etapa nova; {{gatilho.etapa_anterior}} etapa de onde veio; {{gatilho.valor}} valor do negócio, só o número, sem “R$”; {{gatilho.vendedor}} responsável.
Negócio parado na etapa {{gatilho.etapa}} etapa; {{gatilho.dias_parado}} dias parado; {{gatilho.vendedor}} responsável.
Negócio ganho {{gatilho.pipeline}} funil; {{gatilho.valor}} valor já formatado, como R$ 1.800,00.
Contato criado {{gatilho.nome}} nome do contato.
Conversa encerrada {{gatilho.motivo}} motivo do encerramento; {{gatilho.encerrado_por}} quem encerrou; {{gatilho.duracao_minutos}} duração em minutos, vazia quando não há.
Agendamento (próximo, faltou e vaga) Além das do menu: {{gatilho.agendamento_id}}, {{gatilho.inicio_iso}} (data e hora em formato técnico) e, na vaga, {{gatilho.lista_de_espera_id}}.
Mensagem recebida, palavra-chave, nova conversa, story Use as variáveis de mensagem recebida.
Tarefa concluída ou vencida Não traz variáveis.
Webhook Um {{payload.campo}} para cada campo mapeado no gatilho.

Nos gatilhos de cobrança, o fluxo preenche também {{gatilho.valor}}, {{gatilho.descricao}}, {{gatilho.vencimento}} e {{gatilho.link}}, mas o recomendado é usar o grupo {{cobranca.*}} do menu, que é o que a lista oferece.

O menu @ aparece em todo campo de texto que vai para o contato ou para o registro do atendimento. Em cada tela, os campos são:

Bloco ou ação Campos com o menu @
Mensagem O texto da mensagem, a legenda de mídia, os textos de botões e listas, os cartões do carrossel.
Pergunta O texto da pergunta e a “Mensagem ao perguntar de novo”.
Agendamento O campo “Como apresentar”.
Cobrança O campo “Descrição” e os valores das variáveis de modelo.
Mensagem com modelo do WhatsApp Cada campo “Variável n” do modelo.
Ações do fluxo “Observação”, “Texto do aviso”, “Título” e “Descrição” (tarefas e avisos à equipe), “Texto da nota” e “Texto da observação”, “Valor” (ações que gravam um valor, como definir campo e definir variável), “Mensagem de espera (opcional)” ao transferir, “Quem recebe” em avisos, “Comentário (opcional)” em avaliações.
Conexão HTTP Os campos “Endereço” e “Corpo”. Aqui não há menu @: use o link Ver as variáveis disponíveis.

Em outros campos, como nomes de bloco, palavras-chave e filtros, escrever a variável não funciona: o texto é usado como está.

Na janela da Conexão HTTP, logo abaixo do campo “Endereço”, há o link Ver as variáveis disponíveis (depois Esconder as variáveis). Ele abre uma lista com rolagem, em grupos: as variáveis do gatilho, a mensagem recebida, as fixas, os campos personalizados e um grupo “Do fluxo” com exemplos de {{variavel.nome}}, {{payload.campo}} e {{gatilho.campo}}.

  • Clicar em uma variável da lista a coloca no fim do campo, não onde está o cursor. Depois você pode recortá-la e colá-la no lugar certo.
  • O corpo sai exatamente como você escreveu. O exemplo da tela é { "pedido": "{{variavel.pedido}}" }.
  • Se você escrever uma variável que o fluxo não conhece, a janela avisa: “Esta variável não existe e vai chegar vazia: “ seguida do nome, e completa com “Para a mensagem que o contato enviou, use {{mensagem.texto}}.” Com mais de uma, o aviso fica no plural.
  • Essa checagem aceita como conhecidas as variáveis fixas e qualquer nome dos grupos campo, empresa, variavel, payload, gatilho, cobranca, negocio e form. Ela não vê erro de maiúscula ou acento: nesse caso, o texto sai literal, como na tabela de variável vazia.

Janela da Conexão HTTP com a lista Ver as variáveis disponíveis aberta abaixo do Endereço, começando por Mensagem recebida, e o aviso amarelo Esta variável não existe e vai chegar vazia

No painel Testar o fluxo, as variáveis são trocadas por dados reais do contato que você escolheu, mas nada é enviado de verdade.

Situação do teste O que as variáveis mostram
Contato escolhido que tem conversa Os dados reais dele: nome, campos personalizados, protocolo, departamento, atendente, data, hora e feriado. As variáveis da mensagem recebida vêm da última mensagem real que ele enviou, não do que você digita na conversa simulada.
Contato escolhido que não tem nenhuma conversa As variáveis de contato, atendimento, data e feriado saem vazias, mesmo com o contato escolhido.
Sem contato Tudo vazio. {{feriado.hoje}} vale “não”.
Variáveis criadas pelo fluxo (variavel.* e form.*) Funcionam durante a simulação: a resposta que você digita em uma Pergunta fica guardada e vale nos blocos seguintes.
gatilho.* e payload.* Começam vazias no teste, porque o teste não passa por um gatilho de verdade.
Campos sensíveis ou ocultos Ficam de fora.

Painel Testar o fluxo com um contato escolhido e o balão Boa tarde, Sofia! com as variáveis já trocadas pelos dados reais

Menu @ rolado até o grupo Campo, com os campos personalizados cidade, vencimento_cobranca e aniversario