Importação de Listas de Contatos

Este guia mostra, passo a passo, como importar listas de contatos na plataforma, garantindo que seus dados sejam processados corretamente e fiquem disponíveis para uso em campanhas e segmentações.

Acessando a funcionalidade

No menu lateral, clique em Gestão de listas.

Em seguida, clique em Importar lista.

Você será direcionado para a tela Importar Lista de Audiência.

Importar Lista de Audiência

Nesta etapa, você fará o upload de um arquivo CSV contendo os contatos.

Nome da lista

No campo Nome da lista, informe um nome que facilite a identificação posteriormente.

Exemplo:

• Clientes VIP
• Leads Black Friday
• Base WhatsApp Janeiro

2️⃣ Upload do arquivo

Após definir o nome da lista, você pode:

• Arrastar e soltar o arquivo CSV na área indicada, ou
• Clicar em Selecionar arquivo para buscar o arquivo no seu computador.

Formato aceito (muito importante!)

Antes de realizar o upload, verifique se o arquivo atende aos critérios abaixo:

• O arquivo deve estar no formato CSV separado por ponto e vírgula (;)
• O campo e-mail é obrigatório
  • Contatos sem e-mail não serão processados
• Tamanho máximo do arquivo: 7MB

💡 Dica: utilize o botão Baixar modelo de exemplo para garantir que o formato esteja correto.

Estrutura da planilha

Abaixo está a explicação de cada coluna do modelo de importação, com exemplos de preenchimento:

Campos disponíveis

• firstname: Nome do contato

  Exemplo: Nome

• lastname: Sobrenome do contato

  Exemplo: Sobrenome

• email (obrigatório): E-mail do contato

  Exemplo: email@email.com

• cpf: CPF do contato

  Exemplo: 666.999.333-03

• phone: Telefone com DDI + DDD

  Exemplo: 5599999999999

• gender: Gênero do contato

  Valores aceitos: F ou M

• birthDay: Data de nascimento

  Formato: YYYY-MM-DD

  Exemplo: 1991-12-10

• emailOptOut: Indica se o contato optou por não receber e-mails

  1 = Sim | 0 = Não

• emailOptOutAt: Data do opt-out de e-mail

  Formato: YYYY-MM-DD

• whatsappOptOut: Indica se o contato optou por não receber WhatsApp

  1 = Sim | 0 = Não

• whatsappOptOutAt: Data do opt-out de WhatsApp

  Formato: YYYY-MM-DD

• smsOptOut
  • Indica se o contato optou por não receber SMS
  • 1 = Sim | 0 = Não
• smsOptOutAt
  • Data do opt-out de SMS
  • Formato: YYYY-MM-DD
• lastInteraction
  • Data da última interação do contato
  • Formato: YYYY-MM-DD

Pré-visualização e confirmação

Após subir o arquivo:

• A plataforma exibirá um preview com:
  • Quantidade de linhas
  • Quantidade de e-mails
  • Quantidade de telefones
  • Visualização das primeiras linhas da planilha

Revise as informações e, se estiver tudo certo, clique em Confirmar importação.

Processamento e status da lista

Após a confirmação, o tempo de processamento pode variar de acordo com o tamanho do arquivo.

A lista pode assumir os seguintes status:

• Pendente: importação aguardando início do processamento
• Processando: contatos estão sendo processados
• Ativo: importação finalizada com sucesso
• Parcialmente processada: parte dos contatos foi processada com sucesso
• Erro: ocorreu algum problema durante a importação

Você pode acompanhar o status diretamente na tela de Gestão de listas, clique aqui para acessar o artigo que explica sobre essa tela.