Importação de Listas de Contatos – Wake Experience

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
No canto superior direito, clique em Importar Lista
Você será direcionado para a tela de importação, composta por duas etapas: Upload e Revisão

Etapa 1 — Upload

Nome da lista

No campo Nome da lista, informe um nome único para identificar a lista internamente.

Exemplos:

Clientes VIP Julho
Leads Black Friday
Base WhatsApp Janeiro

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

Requisitos do arquivo

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

Formato aceito: .csv
Tamanho máximo: 7MB
Separador de colunas: ponto e vírgula (;)
A coluna email é obrigatória — contatos sem e-mail não serão processados

Planilha de Modelo

Utilize o botão Baixar Planilha de Modelo para garantir que o formato do seu arquivo esteja correto. Colunas fora do padrão poderão ser cadastradas como atributos personalizados na próxima etapa.

Após preencher o nome da lista e selecionar o arquivo, clique em Continuar para avançar para a próxima etapa.

Etapa 2 — Revisão

Nesta etapa, a plataforma analisa o arquivo enviado e apresenta as informações para revisão antes de confirmar a importação.

Campos identificados e não identificados

A plataforma reconhece automaticamente os campos padrão do sistema. Campos que não tiverem correspondência cadastrada serão marcados como Não identificado.

Para cada campo não identificado, você tem a opção de clicar em Cadastrar e criar um novo atributo personalizado para que os dados sejam importados junto com os contatos.

Ao clicar em Cadastrar, um modal será exibido com os seguintes campos:

Nome de exibição (obrigatório): nome do atributo como será exibido na plataforma
Identificador interno (obrigatório): gerado automaticamente a partir do nome; usado internamente e na CDP
Descrição (opcional): descrição do atributo
Exemplos (opcional): até dois exemplos de valores para o campo
Tipo (obrigatório): tipo do dado (ex: Texto, Número, Data)
Máximo de caracteres (obrigatório): limite de caracteres aceitos pelo campo

Após preencher, clique em Salvar Atributo para confirmar o cadastro.

Prévia dos dados

Abaixo dos campos, a plataforma exibe uma prévia dos dados com as primeiras linhas do arquivo, permitindo verificar se as informações estão sendo lidas corretamente antes de confirmar a importação.

Estrutura da planilha

Abaixo estão os campos padrão aceitos na importação:

Campo	Descrição	Exemplo
firstname	Nome do contato	João
lastname	Sobrenome do contato	Silva
email	E-mail do contato (obrigatório)	joao@email.com
cpf	CPF do contato	666.999.333-03
phone	Telefone com DDI + DDD	5511999999999
gender	Gênero	F ou M
birthDay	Data de nascimento	1991-12-10
emailOptOut	Opt-out de e-mail	1 = Sim / 0 = Não
emailOptOutAt	Data do opt-out de e-mail	2024-01-15
whatsappOptOut	Opt-out de WhatsApp	1 = Sim / 0 = Não
whatsappOptOutAt	Data do opt-out de WhatsApp	2024-01-15
smsOptOut	Opt-out de SMS	1 = Sim / 0 = Não
smsOptOutAt	Data do opt-out de SMS	2024-01-15
lastInteraction	Data da última interação	2024-03-10

Processamento e status da lista

Após confirmar a importação, o tempo de processamento pode variar de acordo com o tamanho do arquivo. Você pode acompanhar o andamento diretamente na tela de Gestão de Listas.

A lista pode assumir os seguintes status:

Aguardando processamento: 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

Clique aqui para saber mais sobre a tela de Gestão de Listas.