Organize bases de contatos e empresas para campanhas e agentes
O módulo de Listas é onde você organiza seus contatos e empresas na Nuvia.
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
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 |
| Registro | Entidade-base (contato ou empresa) que existe de forma independente na plataforma | É o dado em si. A lista apenas referencia registros |
| Vista/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 registro do momento em que foi criada. 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 Pessoas (contatos) ou Empresas (organizações).
-
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 o upload do arquivo e siga as 5 etapas.
Forma 4 – 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
-
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 registros desejados ou escolha Selecionar todos nesta página.
-
Clique em Adicionar
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.”
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
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 |
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
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 |
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 |