Segundo Pedido Central de ajudaAjuda

Automações · Primeiros passos

Variáveis nas mensagens

Os campos entre chaves, como o primeiro nome do cliente, que o sistema troca pelo dado de cada pessoa na hora do envio.

Nesta página
  1. Para que serve
  2. Como inserir uma variável
  3. Onde dá para usar
  4. Todas as variáveis
  5. Cliente
  6. Pedido
  7. Filial
  8. Loja
  9. IA e conversa
  10. CRM
  11. Exemplos
  12. Confirmação com o nome e o pedido
  13. Cupom e cardápio da unidade certa
  14. Anotar o que o cliente respondeu
  15. Cuidados
  16. Dúvidas comuns

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

  1. Abra a etapa. No quadro da automação, clique no bloco da mensagem (por exemplo, Responder WhatsApp). O painel de configuração abre à direita.
  2. 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.
  3. 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.
  4. 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.
  5. 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

EtapaCampos com o botão Variáveis
Template WhatsAppCada parâmetro do modelo (os espaços que o modelo aprovado pela Meta deixa para preencher).
Responder WhatsAppMensagem de Resposta.
Enviar Imagem/VídeoA legenda.
Enviar Email e Template EmailO destinatário, o assunto e o texto do e-mail.
Enviar SMSTelefone destino e a mensagem.
Adicionar Notas e Número InválidoO texto da anotação.
Processar com IA e Classificar com IAO 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ávelO 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ávelO 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ávelO 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ávelO 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ávelO 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.