Para que serve
Uma mensagem automática vai para muita gente, mas cada cliente deve ler o próprio nome, o próprio pedido e a unidade em que pediu. As variáveis fazem isso: são nomes entre chaves, como {primeiro_nome}, que o sistema troca pelo dado de cada cliente na hora do envio.
Você escreve “Oi, {primeiro_nome}! Seu pedido {id_pedido} chegou para nós.” uma vez só. A Júlia recebe “Oi, Júlia! Seu pedido 4821 chegou para nós.”; o Rafael recebe o nome e o pedido dele.
Como inserir uma variável
- Abra a etapa. No quadro da automação, clique no bloco da mensagem (por exemplo, Responder WhatsApp). O painel de configuração abre à direita.
- Ache o botão Variáveis. Ele fica ao lado do nome do campo, com o desenho de chaves. No Template WhatsApp, cada parâmetro do modelo tem o seu botão de chaves, sem o texto.
- Escolha a variável. A lista Variáveis Dinâmicas vem separada em grupos: Cliente, Pedido, CRM / Pipeline, Filial, Loja, IA e Conversa. Pare o mouse em cima de uma para ver a descrição e clique para inserir.
- Ajuste a frase. A variável entra no fim do texto, já com as chaves. Se ela precisa ficar no meio da frase, recorte e cole no lugar certo, ou digite o nome direto, com as chaves.
- Salve duas vezes. Clique em Salvar, no rodapé do painel, e depois no disquete do painel da esquerda, para gravar o fluxo.
Onde dá para usar
| Etapa | Campos com o botão Variáveis |
|---|---|
| Template WhatsApp | Cada parâmetro do modelo (os espaços que o modelo aprovado pela Meta deixa para preencher). |
| Responder WhatsApp | Mensagem de Resposta. |
| Enviar Imagem/Vídeo | A legenda. |
| Enviar Email e Template Email | O destinatário, o assunto e o texto do e-mail. |
| Enviar SMS | Telefone destino e a mensagem. |
| Adicionar Notas e Número Inválido | O texto da anotação. |
| Processar com IA e Classificar com IA | O pedido que você escreve para a inteligência artificial. |
Todas as variáveis
Cada linha diz de onde vem o dado e como ele chega na mensagem.
Os exemplos abaixo são da Forno Aceso e da Júlia, inventados.
Cliente
| Variável | O que vira |
|---|---|
{primeiro_nome} | A primeira palavra do nome no cadastro. Exemplo: Júlia |
{nome_completo} | O nome do cadastro. Exemplo: Júlia Prado |
{whatsapp} | O número do cliente, como está no cadastro. Serve mais para anotações que para o texto da mensagem. |
{email} | O e-mail do cadastro. Sai vazio quando o pedido não trouxe e-mail. Exemplo: julia.prado@exemplo.com |
{documento} | O CPF ou CNPJ, com pontos e traço. Evite em mensagem para o cliente. |
{genero} | O gênero como está no cadastro. Pode vir só uma letra. Exemplo: F |
{idade} | A idade do cadastro. Exemplo: 34 |
{data_nascimento} | A data de nascimento, em DD/MM/AAAA. Exemplo: 12/03/1992 |
{rua} | A rua do endereço do cliente. Exemplo: Rua Domingos de Morais |
{numero_endereco} | O número do endereço. Exemplo: 1200 |
{bairro} | O bairro do cliente. Exemplo: Vila Mariana |
{complemento} | O complemento do endereço. Exemplo: apto 52 |
{cidade} | A cidade. Exemplo: São Paulo |
{estado} | A sigla do estado. Exemplo: SP |
{cep} | O CEP. Exemplo: 04010-100 |
Pedido
O Disparo em Massa e a Mensagem Recebida não partem de um pedido. Neles, estas variáveis saem vazias, menos três: {filial} usa a unidade do último pedido do cliente, {taxa_marketplace} sai “R$ 0,00” e {origem_pedido} sai “marketplace”.
| Variável | O que vira |
|---|---|
{id_pedido} | O número do pedido, como veio do sistema do restaurante. Exemplo: 4821 |
{produto} | O nome do item, como veio no pedido. Exemplo: Pizza grande · Calabresa |
{sku} | O código do item no cardápio, quando o sistema do restaurante manda. Em delivery costuma vir vazio. |
{valor_pedido} | O valor total do pedido. Exemplo: R$ 64,90 |
{marketplace} | O canal do pedido, escrito como código: em minúsculas e sem acento. Prefira escrever o nome do app no próprio texto. Exemplo: ifood |
{origem_pedido} | “marketplace” ou “proprio”, escrito como código. Não use em mensagem para o cliente. Exemplo: marketplace |
{taxa_marketplace} | A taxa do app naquele pedido. Uso interno, não mande ao cliente. Exemplo: R$ 7,80 |
{turno} | madrugada (0h às 5h59), manha (6h às 11h59), tarde (12h às 17h59) ou noite (18h às 23h59), pela hora do pedido em Brasília. Sai sem acento. Exemplo: noite |
{data_pedido} | A data e a hora do pedido, em Brasília. Exemplo: 16/10/2026 20:12 |
{status_pedido} | O status do pedido, escrito como código da integração. Não use em mensagem para o cliente. |
{filial} | O nome da unidade gravado no pedido. Exemplo: Vila Mariana |
Filial
Vêm do cadastro da unidade, em Configurações da filial. Valem para a unidade do pedido; sem pedido, para a unidade do último pedido do cliente. Campo vazio no cadastro sai vazio: o dado da rede não entra no lugar.
| Variável | O que vira |
|---|---|
{filial_cupom} | O Cupom da filial. Um por unidade, o mesmo em todo envio. Exemplo: VOLTA10 |
{filial_contato} | O Contato da unidade. Exemplo: (11) 9••••-0101 |
{filial_link_cardapio} | O Link do cardápio. Exemplo: exemplo.com/fornoaceso-vm |
{filial_link_avaliacao} | O Link de avaliação. Exemplo: exemplo.com/avalie-forno-aceso |
{filial_recado} | O Recado da unidade, um texto livre. Exemplo: Abrimos de terça a domingo, das 18h às 23h30. |
{filial_endereco} | O endereço da unidade numa linha: rua, número, bairro, cidade e estado. Partes vazias ficam de fora. Exemplo: Rua das Laranjeiras, 120 · Vila Mariana · São Paulo-SP |
{filial_rua} | A rua da unidade. Exemplo: Rua das Laranjeiras |
{filial_numero} | O número do endereço da unidade. Exemplo: 120 |
{filial_bairro} | O bairro da unidade. Exemplo: Vila Mariana |
{filial_cidade} | A cidade da unidade. Exemplo: São Paulo |
{filial_uf} | A sigla do estado da unidade. Exemplo: SP |
{filial_cep} | O CEP da unidade. Exemplo: 04000-000 |
Loja
| Variável | O que vira |
|---|---|
{nome_loja} | Feita para trazer o nome da conta, a rede. Hoje ela sai vazia nas mensagens automáticas: escreva o nome do restaurante direto no texto. |
{rede_contato} | O Contato da rede, cadastrado em Configurações › Dados, no quadro Dados da Rede nas Mensagens. Exemplo: (11) 9••••-0100 |
{rede_site} | O Site da rede, no mesmo quadro. Exemplo: exemplo.com/fornoaceso |
IA e conversa
| Variável | O que vira |
|---|---|
{mensagem_cliente} | A última mensagem do cliente que o fluxo recebeu: a resposta que fez o Aguardar Resposta seguir ou a mensagem que começou a Mensagem Recebida. Vazia antes de o cliente responder. Exemplo: Sim, fui eu! |
{client_reply} | O mesmo que {mensagem_cliente}.Exemplo: Sim, fui eu! |
{resposta_ia} | O resultado do último bloco de IA do fluxo. Depois de um Classificar com IA, é o código da categoria escolhida, não um texto para o cliente. Exemplo: confirmou |
{classificacao_ia} | Hoje sai vazia com o classificador na configuração padrão. Para usar a categoria, escreva entre chaves o nome que está na Variável de Saída do Classificar com IA. |
CRM
{fase_atual} e {dias_na_fase} aparecem na lista, mas hoje saem sempre vazias. Não use.
Exemplos
Confirmação com o nome e o pedido
Cupom e cardápio da unidade certa
Anotar o que o cliente respondeu
Cuidados
- Campo vazio no cadastro sai vazio na mensagem. A filial não usa o dado da rede no lugar, e a mensagem sai assim mesmo. Antes de usar uma variável de Filial, confira o cadastro de todas as unidades em Configurações da filial.
- Algumas saem escritas como código.
{marketplace},{turno},{origem_pedido}e{status_pedido}chegam em minúsculas e sem acento (“ifood”, “noite”). No texto para o cliente, prefira escrever a palavra. - Sem pedido, sem dado de pedido. No Disparo em Massa e na Mensagem Recebida o fluxo não parte de um pedido, e as variáveis do grupo Pedido saem vazias (veja as exceções na tabela).
- Dado interno não vai para o cliente. Documento, taxa do aplicativo e status do pedido servem para anotações e para sistemas da sua equipe, não para a mensagem.
- Teste antes de ligar. Em Testar e simular um fluxo, a simulação mostra onde cada variável cai na frase. Os dados de filial e de rede aparecem lá com valores de exemplo fixos (“Rua Exemplo”, “CUPOM-EXEMPLO”); o valor de verdade só aparece no envio real.
Dúvidas comuns
Posso usar {nome}?
Não: {nome} não existe e sai vazia. Use {primeiro_nome} (“Júlia”) ou {nome_completo} (“Júlia Prado”).
Por que a variável apareceu no fim do texto?
O botão Variáveis sempre acrescenta no fim do campo. Recorte e cole no lugar certo, ou digite o nome com as chaves direto na frase.
O cliente recebeu a mensagem com um buraco no meio. O que houve?
A variável daquele trecho estava sem dado no cadastro ou foi escrita com um nome que não existe. Confira o nome na tabela acima e o cadastro do cliente ou da unidade.
Dá para criar uma variável minha?
Dá para guardar o resultado de uma etapa: Processar com IA, Classificar com IA e Chamar Webhook gravam o resultado com o nome que você escreve na Variável de Saída do bloco, e esse nome entre chaves funciona nas etapas seguintes. Campos novos no cadastro do cliente, não.