Variáveis de Personalização

Variáveis são atalhos que o NooviChat troca pelo dado real de cada contato na hora do envio — o nome, o telefone, o valor do card, a data do agendamento. Assim uma única mensagem chega personalizada para cada pessoa. Este guia mostra quais variáveis existem, em qual tela usar cada uma e quando.

O que são variáveis

Você escreve a mensagem com um marcador entre chaves duplas, por exemplo {{nome}}, e no disparo o sistema substitui pelo valor daquele destinatário. Se o contato se chama Maria, ela recebe “Olá Maria”; se é o João, ele recebe “Olá João” — a mesma mensagem, personalizada.

A parte que mais confunde

O NooviChat tem vários módulos (Disparador, Conversas, Follow-ups, Agendamentos, Flow Builder) e cada um entende um conjunto e uma grafia diferente de variáveis. Uma variável do Disparador não funciona numa Resposta Rápida, e vice-versa. Se você usar a grafia errada, o texto {{...}} é enviado literalmente para o cliente. Por isso: sempre confira a tabela da tela em que você está.

Regra de ouro

Combine a grafia da variável com a tela em que você está. Este é o mapa rápido — cada linha detalhada nas seções seguintes:

Onde	Estilo	Exemplo do nome do contato
Disparador em massa	plano, minúsculo, português	`{{nome}}`
Conversas / Respostas rápidas	com ponto (Liquid)	`{{contact.name}}`
Follow-ups	plano, com underline	`{{contact_name}}`
Lembretes de agendamento	plano, vocabulário de agenda	`{{cliente}}` / `{{paciente}}`
Flow Builder / Sequências	com ponto, aninhado, com espaços	`{{ contact.name }}`
Template oficial WhatsApp (Meta)	snake_case ou número	`{{contact_name}}` ou `{{1}}`

Repare: o nome do contato aparece de quatro jeitos diferentes dependendo da tela. Não existe uma variável universal — é por isso que esta página existe.

Disparador em massa

No Disparador em massa as variáveis são planas, em minúsculo e em português. Valem na aba Mensagem personalizada, no valor de cada parâmetro do template do WhatsApp (o campo “insira o valor para 1”), na mensagem de follow-up automático do disparo e na mensagem de boas-vindas.

Variável	Vira	De onde vem
`{{nome}}`	Nome do contato	Coluna `nome` do CSV, ou o nome do contato/lead da base
`{{telefone}}`	Telefone (formato +55…)	Coluna `telefone` do CSV, ou o telefone do contato
`{{sua_coluna}}`	O valor daquela coluna	Qualquer coluna extra do CSV vira variável: `{{cidade}}`, `{{empresa}}`, `{{codigo}}`…

Exemplo de mensagem personalizada com coluna extra do CSV:

text

Olá {{nome}}! Vi que você é de {{cidade}}.
Temos uma condição especial no seu telefone {{telefone}}. Posso te contar?

No template do WhatsApp, digite só o valor

Se o template aprovado é “Olá {{1}}, tudo bem?”, no campo “Variáveis → insira o valor para 1” digite apenas {{nome}} — não “Olá {{nome}}”. O texto ao redor já faz parte do template aprovado pela Meta; o campo é só o que entra no lugar do {{1}}.

Conversas, mensagens e respostas rápidas

Ao responder um atendimento ou montar uma Resposta Rápida, as variáveis usam a notação com ponto (o objeto antes, o atributo depois). É o motor Liquid, que também aceita condições ({% if %}).

Variável	Vira
`{{contact.name}}`	Nome do contato
`{{contact.first_name}}`	Primeiro nome do contato
`{{contact.phone_number}}`	Telefone do contato
`{{contact.email}}`	E-mail do contato
`{{agent.name}}`	Nome do atendente
`{{conversation.id}}`	Número da conversa
`{{inbox.name}}`	Nome da caixa de entrada
`{{contact.custom_attribute.chave}}`	Qualquer atributo personalizado do contato

liquid

Olá {{contact.first_name}}, aqui é {{agent.name}} da nossa equipe.
{% if contact.custom_attribute.plano %}Vi que você está no plano {{contact.custom_attribute.plano}}.{% endif %}

Aqui {{nome}} não funciona — é uma variável do Disparador. Na conversa, o nome do contato é {{contact.name}}.

Follow-ups

Nos templates de Follow-up (manuais, por regra de pipeline ou automação), as variáveis são planas com underline. É o único lugar com data e hora “de agora” no fuso da sua conta.

Variável	Vira
`{{contact_name}}`	Nome do contato
`{{contact_phone}}`	Telefone do contato
`{{card_title}}`	Título do card no pipeline
`{{card_value}}`	Valor do card (R$)
`{{stage_name}}`	Etapa atual do pipeline
`{{pipeline_name}}`	Nome do pipeline
`{{current_date}}`	Data de hoje (dd/mm/aaaa, fuso da conta)
`{{current_time}}`	Hora atual (HH:MM, fuso da conta)

text

Oi {{contact_name}}, tudo bem? Passando para retomar sobre "{{card_title}}"
(valor {{card_value}}). Consigo te ligar hoje, {{current_date}}?

Cuidado para não confundir com o Disparador: aqui é {{contact_name}} (com underline), não {{nome}}.

Lembretes de agendamento

Nos lembretes de Atendimentos/Agendamentos as variáveis usam um vocabulário próprio de agenda. As datas se referem ao horário do agendamento (não “agora”), já no fuso da sua conta.

Variável	Vira
`{{cliente}}` / `{{paciente}}`	Nome do cliente/paciente
`{{profissional}}`	Profissional responsável
`{{servico}}`	Serviço agendado
`{{data}}`	Data do agendamento
`{{hora}}`	Horário do agendamento
`{{duracao}}`	Duração
`{{empresa}}`	Nome da empresa

text

Olá {{cliente}}! Lembrete do seu {{servico}} com {{profissional}}
no dia {{data}} às {{hora}}. Até lá!

Flow Builder e Sequências

No Flow Builder e nos passos de Sequências as variáveis são com ponto, aninhadas e normalmente com espaços dentro das chaves. É o conjunto mais amplo — alcança card, agendamento, lead score, SLA e mais. Use o botão Inserir variável do editor: ele já lista as disponíveis para aquele nó.

Variável	Vira
`{{ contact.name }}`	Nome do contato
`{{ card.title }}`	Título do card
`{{ card.expected_revenue }}`	Valor esperado do card
`{{ appointment.scheduled_at }}`	Data/hora do agendamento
`{{ lead_score.value }}`	Pontuação do lead
`{{ variables.X }}`	Uma variável definida antes no próprio fluxo

Prefira sempre o botão Inserir variável do editor — ele mostra só o que existe naquele contexto e evita erro de digitação.

Templates oficiais do WhatsApp (Meta)

Quando você cria/envia um template oficial pela API Cloud do WhatsApp, a própria Meta define o formato dos parâmetros: numéricos ({{1}}, {{2}}) ou nomeados em snake_case ({{contact_name}}, {{agent_email}}) — sem ponto. Atributos personalizados usam o prefixo {{contact_custom_chave}}.

Dois problemas diferentes com parâmetro vazio

São situações distintas: (1) quando a variável não é resolvida, o atendente pode ver o {{1}} cru na conversa (a mensagem não conseguiu preencher o parâmetro); (2) quando um valor vazio é efetivamente enviado à Meta, a Meta rejeita o disparo (#132000 — ver Erros comuns). Nos dois casos, garanta que todo parâmetro tenha um valor real. E lembre: no Disparador o {{1}} é preenchido com variável do Disparador ({{nome}}), não com a grafia da Meta.

Datas e fuso horário

As variáveis de data/hora respeitam o fuso configurado na sua conta (Configurações → conta). Isso vale para {{current_date}} / {{current_time}} nos Follow-ups e para {{data}} / {{hora}} nos Lembretes de agendamento.

Se as datas saírem com a hora “errada”, quase sempre é o fuso da conta não configurado (caindo em UTC). Ajuste o fuso e o problema some.

Erros comuns

Grafia da tela errada. {{contact.name}} num disparo, ou {{nome}} numa resposta rápida, sai como texto literal. Confira a tabela da tela em que você está.
Maiúscula/minúscula. No Disparador é exatamente {{nome}} minúsculo — {{Nome}} ou {{NOME}} não são reconhecidos. Colunas de CSV seguem a grafia exata do cabeçalho do arquivo.
Valor vazio em template oficial. Contato sem nome deixa o parâmetro em branco e a Meta rejeita o envio (erro 132000). Preencha a coluna nome da base ou use um valor fixo de reserva (ex.: “Cliente”).
Só o valor no parâmetro do template. No campo de cada {{1}} digite só a variável ({{nome}}), não a frase inteira.
Placeholder em inglês. Alguns campos mostram um exemplo {{name}} em inglês, mas o Disparador só entende {{nome}}. Use os botões/chips de variável quando disponíveis.

Na dúvida, teste antes

Antes de uma campanha grande, faça um envio de teste para o seu próprio número e confira se as variáveis foram substituídas corretamente.