Variáveis e personalização de mensagens em automações
Nível: Iniciante Tempo de leitura: 5 min Plano necessário: Pro ou Ultra
Como funcionam as variáveis
Os templates da Meta usam placeholders no formato {{1}}, {{2}}, {{3}}. Cada placeholder é um campo que você preenche na hora de configurar a mensagem. Na Wevi, em vez de preencher com texto fixo, você pode usar variáveis dinâmicas que são substituídas pelos dados de cada contato no momento do envio.
Exemplo: template diz Olá {{1}}, sua reserva pra {{2}} está confirmada. Você preenche:
{{1}}={{contact_name}}{{2}}={{data_reserva}}
Cada contato recebe a versão personalizada.
Variáveis nativas
Estas você pode usar sempre:
| Variável | Valor |
|---|---|
{{contact_name}} |
Nome do contato, se cadastrado |
{{contact_phone}} |
Número de telefone do contato |
Se o contato não tem nome cadastrado, a variável vira string vazia.
Variáveis de campos personalizados
Sua organização pode ter campos personalizados de contato (em Configurações > Campos personalizados). Esses viram variáveis automaticamente.
Por exemplo, se você tem campos:
planocidadedata_aniversario
Você pode usar {{plano}}, {{cidade}}, {{data_aniversario}} em qualquer parâmetro.
A lista de variáveis disponíveis aparece logo abaixo dos campos de parâmetro no editor da mensagem.
De onde vêm os valores das variáveis
Depende do tipo de gatilho que iniciou a run:
Via webhook externo
Os valores vêm do custom_fields no body da requisição. Exemplo:
{
"phone": "+5511999999999",
"name": "João",
"custom_fields": {
"plano": "Pro",
"cidade": "São Paulo"
}
}
Aqui, {{contact_name}} vira "João" (vem do name direto), {{plano}} vira "Pro", {{cidade}} vira "São Paulo".
Via evento de conversão
Vem dos metadados emitidos pelo agente quando dispara o evento. Se o agente emite:
<event name="lead_qualificado" data='{"plano": "Pro"}'/>
Então {{plano}} fica disponível.
Via início manual
Vem do cadastro do contato no Wevi:
{{contact_name}}= camponamedo contato{{contact_phone}}= campophone- Qualquer custom_field cadastrado no contato
Sequência de prioridade
Se a mesma variável aparece em mais de um lugar, prevalece nesta ordem:
- Metadados do trigger (custom_fields do webhook, data do evento)
- Custom fields do contato no banco
- Vazio (se não achou em nenhum dos dois)
Comportamento com variável vazia
Se uma variável não tem valor, ela vira string vazia. A mensagem ainda é enviada, sem erro. Por exemplo, template Olá {{1}}! com {{contact_name}} vazio vira Olá !.
Isso pode parecer estranho pro contato. Pra evitar:
- Garanta que toda variável crítica seja preenchida ANTES de incluir no fluxo (no webhook ou ao cadastrar o contato)
- Evite usar variáveis em mensagens cuja gramática quebra sem elas
Limite de parâmetros
Cada placeholder do template ({{1}}, {{2}}...) precisa ter um parâmetro preenchido no editor. Se o template tem 3 placeholders e você só preenche 2, a Meta rejeita o envio.
A lista de placeholders é detectada automaticamente quando você seleciona o template, e o editor já cria os campos correspondentes.
Pré-visualização
Sempre que você configura uma mensagem, o editor mostra uma pré-visualização em bolha estilo WhatsApp na parte inferior do painel. As variáveis NÃO são substituídas (mostram {{contact_name}} literal), mas o layout, header de mídia e quebras de linha são fiéis ao que o contato vai ver.
Use a pré-visualização pra conferir tom e estrutura antes de ativar.