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
.csvcom 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.
No menu lateral, clique em Listas
Clique em Nova lista
No modal que abre, preencha:
Nome — obrigatório (máx. 100 caracteres)
Tipo de objeto — Contato ou Empresa
Descrição — opcional
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.
Acesse o módulo Busca e aplique os filtros desejados
Selecione os registros (individualmente ou todos da página)
Clique em Adicionar a lista
Escolha Criar nova lista e nomeie, ou selecione Selecionar existente
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.
Dentro de uma lista, clique em Importar / Exportar > Importar CSV
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.
Abra a lista desejada
Clique em + Adicionar contatos (ou + Adicionar empresas, conforme o tipo da lista)
Use o campo de busca para encontrar registros pelo nome ou outros atributos
Use os filtros avançados para refinar os resultados, se necessário
Marque os checkboxes dos registros desejados (ou "Selecionar todos desta página")
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
Na tabela da lista, passe o mouse sobre a linha do registro
Clique no ícone "⋯" que aparece à direita
Selecione "Remover"
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
Na tabela da lista, clique no botão Adicionar coluna no canto superior direito
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
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
|
| 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
Aplique filtros na lista usando o botão Filtros
Clique em Criar vista nova
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:
No módulo de Campanhas, selecione a campanha desejada
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
|
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.
