Este arquivo mostra como importar contatos em massa para o Público de um app a partir de um arquivo CSV, associando cada coluna do arquivo aos campos da Context Cloud e, ao final, criando ou atualizando uma audiência com os contatos importados. Use quando precisar carregar uma base externa de uma vez — por exemplo, uma lista de leads ou uma exportação de outro sistema.

Antes de começar

Prepare um arquivo CSV que atenda aos requisitos abaixo:

Se você pretende gravar um dado que ainda não tem campo correspondente na plataforma, crie o campo antes de importar — ver a seção abaixo "Se o campo que você precisa não existe".

Passos

1. No menu lateral, acesse Público > Todo Público.
2. Clique em Importar Lista. O assistente abre na etapa Seleção de Arquivo.
3. Arraste e solte o arquivo CSV na área indicada ou clique em Selecionar arquivo e escolha o arquivo. Em seguida, clique em Processar arquivo para avançar para a etapa Associação de Colunas.
4. Para cada linha da coluna Nome da Coluna, use o campo Campo Variável (o seletor Selecione os campos) para associar aquela coluna do arquivo a um ou mais campos da plataforma. Marque como Identificador a coluna que identifica unicamente o usuário.
5. Clique em Próximo para ir à etapa Configurações.
6. Defina as Opções de importação: o comportamento para identificadores novos, a audiência de destino e a base legal de comunicação (todos detalhados abaixo).
7. Clique em Importar.

Para sair sem importar, clique em Cancelar.

Associar uma coluna a vários campos

Na etapa Associação de Colunas, cada coluna do arquivo pode ser associada a um ou mais campos da plataforma. O seletor Campo Variável é de múltipla escolha: ao marcar vários campos para a mesma coluna, o valor daquela coluna é gravado em todos os campos selecionados.

Por exemplo, uma coluna identificador pode ser associada ao mesmo tempo a Identificador, E-mail e a um campo personalizado — o mesmo valor do arquivo é escrito em cada um deles.

Regras da etapa:

• Pelo menos uma coluna precisa ser marcada como Identificador — é o campo que identifica unicamente o usuário na base. Os demais campos são opcionais.
• A coluna Pré-visualização mostra o valor real da primeira linha do arquivo, para você confirmar que está associando a coluna certa antes de avançar.

Campos disponíveis para associação

O seletor Campo Variável agrupa os campos em três categorias:

Use o campo Buscar campo no topo do seletor para filtrar a lista quando houver muitos campos.

Se o campo que você precisa não existe

O seletor lista apenas os campos já registrados na conta. Os Campos personalizados vêm da Estrutura de dados — se o campo que você quer usar no mapeamento não aparece, crie-o antes:

1. Acesse Configurações > Estrutura de dados.
2. Na aba Campos customizáveis, clique em + Adicionar Campo.
3. No modal Adicionar Novo Campo, preencha o Nome do Campo e selecione o Tipo (por exemplo, Texto).
4. Clique em Adicionar.
5. Volte à importação: o novo campo passa a aparecer no grupo Campos personalizados do seletor Campo Variável.

Observação de nomenclatura: no mapeamento da importação o grupo se chama Campos personalizados; na Estrutura de dados a mesma coisa aparece como Campos customizáveis. São o mesmo conjunto de campos.

Opções de importação (etapa Configurações)

Na última etapa, Configurações, você define como a base será importada e a audiência de destino:

Bases legais de comunicação disponíveis

O campo Base legal de comunicação oferece as seguintes opções:

• Consentimento
• Legítimo Interesse
• Contrato pré-existente
• Obrigação Legal, Processo Judicial ou Proteção ao Crédito
• Interesse vital ou Tutela da saúde
• Interesse público
• Não sei dizer / Não possuo base legal

Escolha a base que corresponde à forma como você obteve esses contatos. A base legal fica registrada na audiência criada pela importação.

Como validar

Depois de clicar em Importar:

• Os contatos importados aparecem em Público > Todo Público. Use a busca para localizar um identificador conhecido do arquivo e confirmar que ele entrou.
• A audiência definida na última etapa aparece em Público > Audiências, com os contatos importados associados.
• Abra o perfil de um contato importado, em Ver detalhes, para confirmar que os campos associados no mapeamento foram preenchidos com os valores do arquivo.

Problemas comuns

• O botão Processar arquivo fica indisponível → nenhum arquivo foi selecionado → arraste ou selecione um arquivo CSV antes de avançar.
• O arquivo é recusado → formato ou tamanho fora do permitido → confirme que o arquivo é CSV em UTF-8, com até 30 MB e 50.000 linhas. Um arquivo com uma única coluna também pode ser recusado; inclua ao menos uma segunda coluna.
• O campo que eu quero não aparece no seletor → ele ainda não existe na conta → crie-o em Configurações > Estrutura de dados > Campos customizáveis e volte à importação.
• Nenhuma coluna marcada como Identificador → a importação precisa de uma coluna que identifique unicamente o usuário → marque essa coluna como Identificador antes de avançar.
• Contatos importados sem telefone ou e-mail → a coluna correspondente não foi associada aos campos Telefone ou E-mail no mapeamento → refaça a importação associando essas colunas.
• Contatos novos não foram criados → a opção Importar usuário caso identificador não seja encontrado na base estava desligada, então só os contatos já existentes foram atualizados → ligue a opção e importe novamente.
• Os contatos não aparecem após a importação → o arquivo não tinha a coluna de identificador associada, ou os identificadores já existiam e a opção de criar novos estava desligada → confirme o mapeamento do Identificador e a opção de importação.