Variáveis Dinâmicas em Campanhas

O que são

Variáveis dinâmicas permitem personalizar cada mensagem de uma campanha com dados específicos de cada destinatário — como nome, cidade ou qualquer informação da sua lista. Em vez de enviar uma mensagem genérica para todos, cada contato recebe uma versão personalizada.

Exemplo:

Sem variável: "Olá! Temos uma oferta especial para você."
Com variável: "Olá, Carlos! Temos uma oferta especial para você em São Paulo."

Como funcionam

Você inclui variáveis no texto da campanha usando a sintaxe {{nome_da_variavel}}. Na hora do envio, o ConvertaFlow substitui cada variável pelo valor correspondente da sua lista de contatos.

Variáveis nativas (contatos da plataforma)

Quando a campanha usa uma lista baseada em contatos do ConvertaFlow, estas variáveis ficam disponíveis automaticamente:

Variável	O que substitui
`{{nome}}`	Nome completo do contato
`{{primeiro_nome}}`	Primeiro nome (extraído automaticamente)
`{{telefone}}`	Número de telefone
`{{email}}`	E-mail do contato

Variáveis de CSV (listas importadas)

Quando você importa uma lista via CSV, cada coluna do arquivo vira uma variável disponível. O nome da variável é o cabeçalho da coluna no arquivo.

Exemplo de CSV:

nome,cidade,produto,desconto
Carlos,São Paulo,Plano Pro,15%
Ana,Curitiba,Plano Starter,10%

Variáveis disponíveis: {{nome}}, {{cidade}}, {{produto}}, {{desconto}}

Usar variáveis no wizard de campanha

No wizard de criação de campanha, vá até o passo de Mensagem
No campo de texto, escreva sua mensagem normalmente
Para inserir uma variável, clique no botão Variáveis acima do campo ou digite {{ diretamente
Selecione a variável desejada na lista — ela é inserida no cursor
Continue escrevendo o restante da mensagem

O preview ao lado mostra como a mensagem ficará para o primeiro contato da lista.

Valor padrão (fallback)

Se um contato não tiver valor para uma variável, você pode definir um texto padrão para evitar que a mensagem saia com o campo em branco:

Sintaxe: {{nome|Cliente}}

Neste exemplo, se o contato não tiver nome cadastrado, a mensagem enviará "Cliente" no lugar.

Sem fallback, variáveis sem valor ficam em branco na mensagem enviada.

Validação antes do envio

Antes de confirmar o envio, o wizard exibe um resumo com:

Quantidade de contatos na lista
Quais variáveis foram detectadas na mensagem
Quais contatos têm campos faltando (sem valor para alguma variável)

Use esse momento para corrigir o CSV ou definir fallbacks antes de disparar.

Boas práticas

Teste com um contato real. Antes de disparar para toda a lista, use a opção de envio de teste para um número seu e verifique se as variáveis estão sendo substituídas corretamente.

Cuidado com maiúsculas/minúsculas. O nome da variável no texto deve ser idêntico ao cabeçalho do CSV. {{Nome}} e {{nome}} são variáveis diferentes.

Evite variáveis em posição crítica. Se o valor estiver vazio e não houver fallback, a frase pode ficar estranha. Ex: "Olá, ! Sua promoção está aqui." — sempre defina um fallback para variáveis no início da mensagem.

Perguntas frequentes

Quantas variáveis posso usar em uma única mensagem?

Não há limite. Você pode usar quantas variáveis precisar, desde que todas estejam presentes na lista de contatos.

Posso usar variáveis em mensagens de mídia (imagem + legenda)?

Sim. Variáveis funcionam na legenda de imagens, vídeos e documentos enviados como mídia na campanha.

Variáveis funcionam em campanhas de drip (sequência)?

Sim. Todas as mensagens de uma sequência de drip suportam variáveis dinâmicas, inclusive em diferentes etapas.

Posso usar campos customizados do CRM como variáveis?

Sim. Campos customizados criados em Configurações > Campos Customizados ficam disponíveis como variáveis nas campanhas, desde que o contato tenha o campo preenchido.