Agendar Demo
Cases
Agendar Demo

Como enriquecer contatos em uma lista

Como enriquecer e-mail profissional e telefone dos contatos dentro de uma lista, em bulk ou por célula, com consumo de créditos e monitoramento de execução.

Disponível em
todos os planos com cota de créditos ativa.
Quem pode fazer
qualquer usuário com acesso à lista

Nesta página6 seções

O enriquecimento preenche automaticamente e-mail profissional e telefone dos contatos de uma lista usando fontes externas.

Conceitos fundamentais

Antes de executar o enriquecimento, vale entender três termos que aparecem na interface:

ConceitoO que é
Campos enriquecíveis E-mail profissional (1 crédito) e Telefone (10 créditos). São os dois únicos campos preenchidos pelo enriquecimento.
Dados de origem O que a Nuvia usa para identificar o contato nas fontes externas: Nome, Empresa, LinkedIn, E-mail e Telefone já existentes no registro.
Elegibilidade Um contato é elegível se tem Nome + Empresa, OU LinkedIn, OU E-mail. Sem nenhum desses combos, ele não é consultado e nenhum crédito é cobrado.

Enriquecer vários contatos de uma vez

  1. No menu lateral, clique em Listas e abra a lista desejada

  2. Marque os checkboxes dos contatos que quer enriquecer (ou use o checkbox do cabeçalho para selecionar a página inteira)

  3. Na barra de ações que aparece, clique em Enriquecer

  4. No painel Enriquecer, confira:

    • Dados de origem disponíveis: quantos dos selecionados têm cada dado (ex: “12/15 com LinkedIn”)

    • Campos a enriquecer: ative os toggles dos campos que quer preencher

    • Estimativa de créditos: total calculado já considerando só os contatos elegíveis

  5. Clique em Enriquecer no rodapé do painel

Enriquecer um contato ou campo específico

  1. Abra a lista e localize o contato

  2. Na coluna E-mail ou Telefone, clique em Enriquecer (o botão já mostra o custo em créditos)

  3. A célula passa para Enriquecendo… enquanto a consulta roda

  4. Quando terminar, a célula exibe o valor encontrado ou o status Não encontrado

Entender os estados da célula

EstadoO que apareceO que significa
Disponível Botão Enriquecer com custo ao lado Célula vazia, pronta para consultar
Enriquecendo… Spinner + texto “Enriquecendo…” Consulta em andamento
Valor preenchido O e-mail ou telefone encontrado Busca retornou dado válido
Não encontrado Badge vermelha Não encontrado A cascata rodou em todas as fontes elegíveis e nenhum dado foi retornado. O crédito foi extornado

Limites e regras

RegraValor
Contatos por execução em bulk — seleção manual 500 por chamada
Contatos por execução em bulk — Selecionar todos em uma lista 5.000 por chamada
Campos selecionáveis por execução 2 (E-mail e Telefone)
Custo de E-mail profissional 1 crédito por contato elegível
Custo de Telefone 10 créditos por contato elegível
Cota mensal padrão 500 créditos/mês (planos podem ter cota diferente)
Renovação de créditos Automática no início de cada período mensal
Regras de elegibilidade Nome + Empresa, OU LinkedIn, OU E-mail
Retentativas automáticas pelo servidor Até 3 tentativas com backoff em caso de falha transitória
Timeout por execução 5 minutos por célula / 2 horas por bulk

Erros comuns e soluções

ProblemaCausa provávelSolução
Botão Enriquecer desabilitado no painel Créditos insuficientes para o total estimado Desative um dos campos, reduza a seleção ou aguarde a renovação. Consulte saldo em Menu lateral > Créditos
Contato aparece como não elegível Falta de dados de origem (sem Nome+Empresa, sem LinkedIn e sem E-mail) Edite o contato para adicionar pelo menos um combo elegível. Contatos inelegíveis não consomem crédito
Aviso Erro ao iniciar enriquecimento Falha ao enviar o lote para a fila Confirme que ainda há saldo e tente novamente. O crédito não é cobrado nesse caso

Perguntas frequentes

Quais campos a Nuvia consegue enriquecer hoje?

E-mail profissional (1 crédito) e Telefone (10 créditos). Outros dados do contato – como cargo, empresa ou LinkedIn – são puxados no momento da importação ou busca, mas não pelo motor de enriquecimento.

Se o dado não for encontrado, eu pago crédito do mesmo jeito?

Não. O crédito cobre o resultado da consulta nas fontes externas. Se a cascata rodou em todas as fontes elegíveis e nada foi retornado, a célula vira Não encontrado e o crédito é extornado.

Posso enriquecer o mesmo campo mais de uma vez?

Sim. Use o menu ⋮ na célula e escolha Enriquecer este dado. Cada tentativa consome créditos – não há cache automático para o usuário final.

Quantos contatos posso enriquecer de uma vez?

Depende de como você selecionou:

  • Seleção manual (marcando checkboxes): até 500 contatos por chamada. Se precisar de mais, divida em lotes.

  • Selecionar todos em uma lista: até 5.000 contatos por chamada, com os filtros da tela preservados. A Nuvia resolve os contatos no servidor, então listas grandes não travam o navegador.

Não há limite de execuções consecutivas – só de tamanho por chamada.

E se eu fechar a aba durante um enriquecimento em bulk?

O processamento continua no servidor. Quando você voltar e abrir a lista ou o Log de enriquecimento, vê o resultado final. O widget de monitoramento inline só volta a aparecer se o enriquecimento ainda estiver em andamento.

Por que meu contato apareceu como “parcial” no resumo?

Parcial significa que pelo menos um campo foi encontrado, mas não todos os solicitados. Exemplo: você pediu E-mail + Telefone, a Nuvia achou só o E-mail — o contato entra como parcial. Os créditos foram consumidos apenas pelos campos efetivamente consultados.

Este artigo ajudou?