A Importação de Lista (Público > Todo Público > botão Importar Lista) é o caminho para carregar contatos em massa na Inngage Context Cloud a partir de um arquivo — seja para migrar uma base de outra ferramenta, incorporar leads de um evento ou enriquecer perfis existentes com novos atributos.

A importação é um assistente em 3 etapas: Seleção de Arquivo, Associação de Colunas e Configurações.

Etapa 1 — Seleção de Arquivo

Faça o upload da planilha com os dados dos usuários, arrastando o arquivo para a área de upload ou clicando em Selecionar arquivo, e confirme em Processar arquivo.

Requisitos do arquivo:

  • Formato CSV-UTF8 — salve a planilha nesse formato no Excel/Google Sheets. O UTF-8 garante que acentos e caracteres especiais não se corrompam.
  • Tamanho máximo de 30 MB e 50.000 linhas por importação. Bases maiores devem ser divididas em múltiplos arquivos.
  • Identificador de Usuário obrigatório — uma coluna deve identificar unicamente cada contato (CPF, e-mail ou ID), o mesmo dado que seu app envia à plataforma.
  • Campos de contato opcionais — colunas de E-mail e Telefone habilitam os canais correspondentes.
  • Campos Personalizados — quaisquer outras colunas podem ser carregadas como atributos personalizados do usuário.

Na dúvida sobre a formatação, a própria tela oferece o download de uma planilha exemplo — use-a como gabarito.

Etapa 2 — Associação de Colunas

Nesta etapa você mapeia cada coluna do seu arquivo para o campo correspondente na plataforma: qual coluna é o identificador, qual é o e-mail, qual é o telefone e a quais campos personalizados as demais colunas correspondem. É o momento de garantir que nome da planilha alimente o campo name da base, e assim por diante.

Atenção ao mapeamento: colunas associadas a campos errados geram atributos trocados em milhares de perfis de uma vez. Confira o de-para com calma antes de avançar — especialmente se os nomes das colunas do arquivo não seguem o padrão dos campos da plataforma (veja Campos customizáveis).

Etapa 3 — Configurações

A etapa final consolida as opções da importação antes do processamento. Revise o resumo e confirme para iniciar a carga dos contatos na base.

O que acontece depois

  • Os contatos importados passam a aparecer em Todo Público, com os atributos carregados visíveis no perfil de cada usuário (aba Atributos).
  • Se o identificador de um contato já existir na base, os dados se consolidam no mesmo perfil — por isso a consistência do identificador é crítica. Se o app identifica por e-mail e a planilha usa CPF, os registros não se unificam e você cria duplicatas.
  • Os atributos importados ficam imediatamente disponíveis para segmentação nas audiências e como variáveis de personalização nas mensagens.

Boas práticas

  • Higienize antes de subir: remova linhas sem identificador, espaços extras e duplicatas. Célula vazia vira personalização quebrada ("Olá, !").
  • Padronize telefones e e-mails (DDI/DDD no telefone, e-mails minúsculos) para não fragmentar os canais.
  • Importações incrementais: para atualizar a base periodicamente, mantenha o mesmo identificador e reimporte — os perfis são atualizados, não duplicados.
  • LGPD: importe apenas contatos com base legal para receber comunicação. Listas compradas prejudicam a entregabilidade e expõem a empresa.
  • Valide por amostragem: após a importação, abra alguns perfis em Todo Público e confira se os atributos caíram nos campos certos.