Como podemos ajudar?

Como usar variáveis para enviar mensagens personalizadas
3 min
Criado por Leonora Alves em 15/02/2024 15:10
Atualizado por Leonora Alves em 13/10/2025 15:47
Importante: Antes de seguir com as instruções, confirme se a funcionalidade está disponível para o seu perfil de acesso.

As variáveis permitem que você personalize uma informação no momento do envio da mensagem, tornando-a específica para cada destinatário.

Existem algumas diferenças entre as opções de disparos que você pode perceber ao acessar a tela de configuração de destinatários, que detalhamos a seguir.

Disparos com variáveis

Nos disparos em massa, não é possível adicionar contatos manualmente caso o seu disparo use variáveis. Perceba que a opção está indisponível na etapa de configuração dos destinatários.

Todos os disparos que possuem variáveis devem ser feitos via arquivo .csv ou utilizando contatos e grupos previamente adicionados.

Importação através de um arquivo

Prepare o arquivo .csv para importação seguindo as especificações abaixo:

  • Formato: .csv
  • Codificação: UTF-8
  • Cabeçalho: Inclua a primeira linha com títulos das suas variáveis (por exemplo: Telefone; Nome; Data; Horário).
  • Coluna de telefone: A primeira coluna deve conter os números de telefone dos contatos. Todos os dados de contato devem estar na mesma coluna do arquivo.
  • Separadores das colunas: Vírgula (,) ou ponto e vírgula (;).

Exemplo de arquivo .csv:

TelefoneNomeDataHorário
123456789João01/10/202410:00
987654321Maria02/10/202414:00


Para a mensagem “Olá {{nome}}! Sua consulta foi agendada para {{data}} às {{horario}}. Para cancelar o agendamento, ligue para 0800 400 1100”, o arquivo deve ter variáveis organizadas em colunas distintas.

⚠️ Atenção: O usuário é responsável por mapear corretamente as variáveis com as colunas do arquivo. Para facilitar, você pode baixar um template baseado no formato da mensagem que será disparada.

Carregar arquivo e mapear campos

  1. Clique em Carregar arquivo .csv;
  2. Selecione o arquivo .csv configurado;
  3. Mapeie os campos do arquivo com as variáveis da mensagem:
    1. Escolha o campo correspondente para cada coluna (por exemplo, para {{numero_telefone}}, selecione a coluna com números de telefone).

Usar base de contatos

Certifique-se de que o grupo ou contato esteja adicionado à base de contatos, seja manualmente ou por importação.

  1. Escolha uma lista de contatos, contatos específicos ou regras de segmentação já adicionadas no Zenvia Customer Cloud;
  2. Clique em Confirmar;
  3. Configure as variáveis da mesma forma que na importação de arquivos.

Disparos sem variáveis

Caso o sistema identifique que não há variáveis no seu texto, você pode escolher qualquer forma de envio na etapa de configuração de destinatários. Perceba como nenhuma opção está indisponível.

Neste caso, basta selecionar a forma que preferir e inserir os números de telefone que você deseja impactar.