Variáveis: a lista oficial e como usá-las#

Variável é o pedaço do texto que muda por cliente: {{nome}}, {{protocolo}}, {{valor}}. Elas são o mesmo catálogo em todo lugar do sistema — no fluxo, na resposta rápida, no envio de boleto e no prompt da IA.

Nem sempre foi assim: existiam quatro listas diferentes, e duas delas discordavam sobre a mesma chave. Para o envio de boleto, {{nome}} era o nome do cliente; numa das telas, o nome do atendente. Quem escrevesse um texto num lugar e usasse no outro recebia o valor errado, sem nenhum aviso. Hoje o catálogo é um só.

O catálogo#

Contato#

Agente#

Usar {{agente}} no prompt em vez de digitar o nome evita um problema silencioso: renomear o agente na tela deixava o prompt falando o nome antigo, e a IA se apresentava com um nome que não existe mais em lugar nenhum.

Empresa#

Estas descrevem a sua empresa, não o cliente. Saem de Configurações → Empresa e valem para todo atendimento.

Nenhum dado coletado do cliente pode sobrescrever essas variáveis. A razão é concreta: um "CNPJ" solto na lista de contexto foi lido pela IA como o CNPJ de quem estava na conversa — e ela acusou uma cliente de ter mandado o CNPJ da própria empresa que a atendia.

Cobrança#

Estas não existem o tempo todo: só depois que um fluxo ou uma ferramenta de ERP trouxe a fatura. Antes disso, ficam vazias de propósito.

Grafias antigas continuam funcionando#

Textos escritos antes do catálogo único usam nomes como {{nome_contato}}, {{nomeFantasia}}, {{razao_social}}, {{nome_atendente}}. Todos continuam resolvendo, apontando para a variável correta. Ao escrever algo novo, use o nome da tabela acima.

A regra que não pode ser quebrada#

Variável sem valor não vira texto vazio no prompt da IA.

"Seu boleto de R$ vence em" é pior do que não responder: o modelo completa o buraco com um número inventado, e o cliente recebe um valor que não existe. Sem valor, o texto recebe uma marca explícita de ausência — (não informado) — para que o modelo saiba que aquilo falta em vez de preencher.

Variáveis que você mesmo cria#

O passo de pergunta grava a resposta do cliente numa variável com o nome que você escolher. É como {{cpf}}, {{endereco}} e {{motivo}} passam a existir dentro daquele fluxo.

O nome é livre, mas vale uma disciplina: escreva em minúsculas, sem acento e sem espaço, e use um nome que descreva o dado. {{resposta2}} daqui a três meses não significa nada para ninguém.

No modelo oficial do WhatsApp, as variáveis viram números#

A Meta não aceita {{nome}}: ela quer {{1}}, {{2}}, {{3}}, em sequência. A conversão é feita pelo sistema no momento de submeter o modelo, e o nome original é guardado — para que, ao reabrir para edição, o formulário volte a falar a sua língua em vez de mostrar números.

O mesmo nome usado duas vezes reaproveita o mesmo número: é uma variável só, usada duas vezes.

Como fazer#

1. Escreva o texto com a variável entre chaves duplas: Olá {{nome}}, seu protocolo é {{protocolo}}.
2. Para dados de cobrança, garanta que o passo de consulta ao ERP rodou antes do passo que usa a variável.
3. Teste com um cliente real de teste, e leia a mensagem como ela chegou.

Se algo der errado#

A mensagem chegou com {{nome}} escrito literalmente. O nome está errado, ou a variável não existe naquele ponto. Confira a grafia contra a tabela.

Uma variável de cobrança chegou vazia. O passo que traz a fatura não rodou, ou falhou. Ordene os passos: consulta primeiro, mensagem depois.

O valor está certo, mas é de outro cliente. Duas perguntas gravando na mesma variável. Dê nomes diferentes.

A IA falou o nome errado da empresa. Confira Configurações → Empresa: as variáveis de empresa saem de lá.