Skip to main content

Como gerenciar listas e contatos — Organize bases de contatos e empresas para campanhas e agentes

Updated today

O módulo de Listas é onde você organiza seus contatos e empresas na Nuvia. Uma lista é um conjunto estático de registros que pode ser reutilizado em Campanhas, Funis Inteligentes e como base de dados para prospecção. Neste artigo, você aprende a criar listas, adicionar e remover registros, personalizar colunas e usar views para segmentar seus dados.


Neste artigo:


Disponível em: todos os planos.

Quem pode fazer: qualquer usuário com acesso ao módulo de Listas.

Módulo: Menu lateral > Listas

O que você precisa antes de começar

  • Ter acesso ao módulo de Listas no menu lateral

  • (Para importar CSV) Ter um arquivo .csv com máx. 10MB e até 1.000 linhas

  • (Para adicionar de busca) Ter realizado uma busca com resultados no módulo Busca

Conceitos fundamentais

Conceito

O que é

Quando usar

Lista

Conjunto estático de registros (contatos ou empresas). Referencia registros existentes na plataforma

Para organizar leads em grupos reutilizáveis para campanhas e funis

Record (Registro)

Entidade-base — contato ou empresa — que existe de forma independente na plataforma

É o dado em si. A lista apenas referencia records

View

Filtro salvo com nome dentro de uma lista. Permite criar recortes reutilizáveis

Para segmentar dados sem criar listas separadas (ex: "CFOs de fintech", "Sem e-mail")

Coluna customizada

Coluna adicional exclusiva de uma lista, com dados extras

Para armazenar dados específicos do contexto da lista

  • Listas são estáticas: a lista representa um snapshot do momento de criação. Novos contatos que atendessem aos mesmos critérios no futuro não entram automaticamente. Para manter a lista atualizada, repita a operação de adição periodicamente.

  • Dois tipos de objeto: uma lista é sempre de Contatos (pessoas) ou Empresas (organizações). Você define o tipo ao criar.

  • Registros não são duplicados: a lista apenas referencia o registro — os dados do contato não são copiados. Se o contato for atualizado (nome, telefone, e-mail), a lista reflete a mudança automaticamente.

Criar uma lista

Existem 3 formas de criar uma lista. Escolha a mais adequada ao seu cenário.

Forma 1 — Lista vazia

Use quando quer começar do zero e adicionar contatos depois.

  1. No menu lateral, clique em Listas

  2. Clique em Nova lista

  3. No modal que abre, preencha:

    • Nome — obrigatório (máx. 100 caracteres)

    • Tipo de objeto — Contato ou Empresa

    • Descrição — opcional

  4. Clique em Criar lista

A lista é criada imediatamente com status Pronta e sem registros.

Forma 2 — A partir dos resultados de busca

Use quando aplicou filtros na Busca e quer salvar os resultados como lista.

  1. Acesse o módulo Busca e aplique os filtros desejados

  2. Selecione os registros (individualmente ou todos da página)

  3. Clique em Adicionar a lista

  4. Escolha Criar nova lista e nomeie, ou selecione Selecionar existente

  5. Clique em Salvar

Para o passo a passo completo, consulte Como criar listas a partir de resultados de busca.

Forma 3 — Importação via CSV

Use quando tem uma planilha externa com os dados dos contatos.

  1. Dentro de uma lista, clique em Importar / Exportar > Importar CSV

  2. Faça upload do arquivo e siga o wizard de 5 passos

Para o passo a passo completo, consulte Como importar contatos via CSV.

Adicionar registros manualmente

Use quando o contato já existe na plataforma e você quer adicioná-lo a uma lista específica.

  1. Abra a lista desejada

  2. Clique em + Adicionar contatos (ou + Adicionar empresas, conforme o tipo da lista)

  3. Use o campo de busca para encontrar registros pelo nome ou outros atributos

  4. Use os filtros avançados para refinar os resultados, se necessário

  5. Marque os checkboxes dos registros desejados (ou "Selecionar todos desta página")

  6. Clique em Adicionar (X)

Você verá uma mensagem de confirmação como: "X contato(s) adicionado(s) com sucesso!" Se algum registro já existia na lista, a mensagem indicará: "X contato(s) adicionado(s). Y já existia(m) na lista."

💡 Dica: O sistema previne duplicatas automaticamente — registros que já estão na lista são ignorados.

Remover registros da lista

  1. Na tabela da lista, passe o mouse sobre a linha do registro

  2. Clique no ícone "⋯" que aparece à direita

  3. Selecione "Remover"

  4. Confirme no modal de confirmação

⚠️ Importante: Remover um registro da lista não exclui o contato ou empresa da plataforma — apenas remove a referência da lista. O registro continua existindo e disponível em outras listas e módulos.

Gerenciar colunas

As listas exibem dados do contato ou empresa como colunas na tabela. Você pode personalizar quais colunas aparecem e adicionar colunas com dados extras.

Adicionar coluna

  1. Na tabela da lista, clique no botão Adicionar coluna no canto superior direito

  2. Escolha o tipo de coluna:

    • Campo do registro — espelha um atributo nativo do contato ou empresa (ex: E-mail, Telefone, CNPJ)

    • Campo customizado — campo personalizado já configurado na plataforma (consulte Como usar campos personalizados)

    • Coluna customizada — coluna nova exclusiva desta lista

  3. Para colunas customizadas, defina o tipo de dado:

Tipo

Descrição

Texto (String)

Texto livre

Número (Number)

Valores numéricos

Data (Date)

Data

Booleano (Boolean)

Sim/Não

E-mail

Endereço de e-mail

URL

Link

Moeda (Currency)

Valor monetário

Referência

Aponta para outro registro (contato ou empresa)

Opções de coluna

Clique no ícone no cabeçalho de qualquer coluna para acessar as opções:

Ação

Disponível quando

Renomear

Coluna customizada sem referência

Mover para esquerda / direita

Há colunas adjacentes

Ocultar coluna

Há uma view selecionada

Remover coluna

Sem view selecionada

🚨 Crítico: Remover coluna apaga permanentemente todos os dados armazenados naquela coluna. O sistema exibe confirmação antes de executar, mas não há desfazer.

Ocultar coluna apenas esconde da view atual — os dados são preservados.

Colunas com ícone de cadeado não podem ser renomeadas nem removidas (ex: a coluna Nome).

Edição inline

Células de colunas customizadas dos tipos Texto, Número e Data são editáveis diretamente na tabela. Clique na célula para editar, pressione Enter para salvar ou Escape para cancelar.

Usar views para segmentar dados

Views são filtros salvos com nome. Útil para criar recortes reutilizáveis dentro de uma lista sem criar listas separadas.

Criar uma view

  1. Aplique filtros na lista usando o botão Filtros

  2. Clique em Criar vista nova

  3. Nomeie a view e confirme

Gerenciar views

  • Atualizar: com a view selecionada, modifique os filtros e clique em Atualizar

  • Duplicar: no menu de ações da view, selecione Duplicar

  • Renomear: no menu de ações da view, selecione Renomear

  • Apagar: no menu de ações da view, selecione Apagar

  • Ocultar colunas: com uma view selecionada, use Ocultar coluna no cabeçalho da coluna. A ocultação é salva na view e não afeta outras views

Configurações de visualização

Clique em Visualização para acessar o painel de Configurações de visualização, onde você pode:

  • Ver as Colunas mostradas e Colunas ocultas

  • Reorganizar a ordem das colunas

  • Adicionar ou remover colunas da view

Ordenação

Clique em Ordenar para configurar a ordenação dos registros na tabela. Você pode adicionar múltiplas colunas de ordenação.

Usar a lista em campanhas

Para usar uma lista como audiência de uma campanha:

  1. No módulo de Campanhas, selecione a campanha desejada

  2. Na etapa de audiência, selecione a lista criada como fonte

Regras importantes:

  • A lista é usada como snapshot no momento do enrollment. Contatos adicionados à lista depois não entram automaticamente na campanha

  • A lista não é bloqueada após ser vinculada a uma campanha — pode continuar sendo editada

  • Para campanhas de WhatsApp, garanta que a lista contém contatos com telefone preenchido

Limites e regras

Regra

Valor

Tamanho do arquivo CSV

Máx. 10MB

Linhas por importação CSV

Máx. 1.000

Registros por adição em batch

Máx. 1.000

Nome da lista

Máx. 100 caracteres

Registros por página na tabela

10, 25, 50 ou 100 (padrão: 50)

Máximo de registros por lista

Sem limite definido

Tipos de coluna customizada

Texto, Número, Data, Booleano, E-mail, URL, Moeda, Referência

Deduplicação dentro da lista

Automática — o mesmo contato não pode aparecer duas vezes

Status das listas

Status

Significado

Processando

Importação em andamento — aguarde a conclusão

Pronta

Lista disponível para uso

Parcial

Importação concluída com erros em algumas linhas

Erro

Falha no processamento — verifique o arquivo e tente novamente

Listas nos estados Pronta ou Parcial podem ser usadas em Campanhas e Funis Inteligentes.

Erros comuns e soluções

Problema

Causa provável

Solução

Lista com status "Erro"

Falha no processamento do arquivo CSV

Verifique o formato do CSV (deve ser .csv com cabeçalho na primeira linha) e tente novamente

Lista com status "Parcial"

Algumas linhas do CSV tinham formato inválido ou campo obrigatório ausente

Os registros válidos foram importados. Corrija as linhas com erro e reimporte

Registros não aparecem na lista após adicionar da Busca

Processamento assíncrono em andamento

Aguarde a notificação de conclusão. Para volumes grandes, o processamento pode levar alguns minutos

Coluna removida acidentalmente

Ação irreversível

Os dados da coluna são perdidos permanentemente. Recrie a coluna e preencha os dados novamente

Não consigo editar uma lista

Sem permissão de edição

Verifique com o administrador se você tem permissão para editar a lista

Perguntas frequentes

Posso desfazer a importação de um CSV?

Não há desfazer automático. Para remover os registros importados por engano, acesse a lista e remova-os individualmente ou exclua a lista inteira.

A lista se atualiza automaticamente quando altero dados de um contato?

Os campos nativos do contato (nome, telefone, e-mail) são exibidos em tempo real na lista — se o contato for atualizado em outro lugar, a lista reflete a mudança. Apenas a composição da lista (quais contatos fazem parte) é estática.

Posso usar a mesma lista em mais de uma campanha?

Sim. A lista pode ser associada a múltiplas campanhas. Atenção para sobreposição de contato — o mesmo lead pode receber mensagens de campanhas diferentes.

O que acontece se importar um contato sem telefone para uma campanha de WhatsApp?

A plataforma não bloqueia o vínculo. O problema aparecerá no momento do disparo, quando o sistema não conseguirá enviar para registros sem telefone válido.

Posso criar uma lista só com empresas?

Sim. Ao criar a lista, selecione Empresa como tipo de objeto. A lista aceitará apenas registros do tipo Empresa.

O que é uma coluna do tipo Referência?

É uma coluna que aponta para outro registro da plataforma (um Contato ou uma Empresa). Permite criar relações entre registros. Pode ser configurada como valor único (1:1) ou múltiplos valores (1:N).

Posso exportar uma lista para CSV?

Sim. Use a opção Importar / Exportar > Exportar CSV dentro da lista. O limite de exportação é de 10.000 registros por operação.

Qual a diferença entre Ocultar e Remover uma coluna?

Ocultar coluna apenas esconde da view atual — os dados são preservados e você pode reexibir a coluna depois. Remover coluna apaga permanentemente a coluna e todos os dados armazenados nela. Não há desfazer.

Como filtrar dentro de uma lista?

Use o botão Filtros na barra de ações da lista para aplicar critérios de filtragem. Para salvar esse filtro e reutilizá-lo, crie uma view clicando em Criar vista nova.

O que é o status "Parcial" de uma lista?

Indica que a importação foi concluída, mas algumas linhas tiveram erro (ex: formato inválido, campo obrigatório ausente). Os registros válidos foram importados normalmente. A lista pode ser usada no estado Parcial.

Did this answer your question?