Enriquecer contatos com o Nectar AI

O Enriquecedor de contatos é o agente do Nectar AI que completa os cadastros com dados da web: ramo de atividade, número de funcionários, faturamento, descrição, telefone, e-mail, LinkedIn e CNPJ ou razão social. Com a aprovação ligada, você confere cada dado antes de ele entrar no contato.

Quem pode

• O Nectar AI e os agentes precisam estar contratados.
• Configurar e ligar o agente, usar o botão "Enriquecer" do contato e aprovar pela aba "Logs": só quem tem a permissão "Administrador".
• "Enriquecer com IA" na listagem de contatos: quem tem a permissão "Administrador" ou "Contatos: Gestor".

Como configurar

1. No menu lateral, clique em "Nectar AI", abra a aba "Agentes" e clique em "Enriquecedor de contatos". Se ele nunca foi configurado, clique antes em "Ativar agente".
2. Abra a aba "Configuração".
3. Em "Identidade do Agente", escolha o "Nível de autonomia":
   • "Automático": o agente grava sozinho, só nos campos marcados em "Campos para enriquecer".
   • "Com aprovação": você vê tudo o que ele encontrou e escolhe o que salvar.
   • "Apenas sugestão": o agente só sugere, sem aplicar nada. É o padrão.
4. Em "Quando Executar":
   • marque "Ao criar um contato", "Ao atualizar um contato" ou os dois;
   • em "Disparar quando algum destes estiver preenchido", marque "Site / domínio", "E-mail", "Telefone" ou "CNPJ". O agente roda se qualquer um dos marcados estiver preenchido; sem nenhum marcado, roda em toda criação ou edição;
   • em "Ciclo de vida do contato", marque "Lead", "Suspect", "Prospect" ou "Cliente". O agente só enriquece contatos nos ciclos marcados; sem nenhum marcado, vale para todos.
5. Em "Quais contatos", marque os "Campos de busca para enriquecimento", que são os dados do contato usados para encontrar as informações: "Site / domínio", "CNPJ", "Nome da empresa", "E-mail", "LinkedIn" e "Telefone".
6. Em "Campos para enriquecer", marque o que o agente pode preencher: "Ramo de atividade", "Nº de funcionários", "Faturamento", "Descrição", "Telefone", "E-mail", "LinkedIn" e "CNPJ / razão social".
7. Em "Configuração", defina o "Máximo de campos por execução", de 1 a 50 (padrão 10), e deixe ligado "Proteger campos já preenchidos" para não sobrescrever campos que já têm valor. Ele vem ligado.
8. Clique em "Salvar" e ligue a chave do agente. Ele só liga com pelo menos um campo de busca, um campo para enriquecer e um gatilho marcados; sem isso, aparece "Configure antes de ativar:" com o que falta.

Fila e Descartados

Com o agente ligado, cada contato criado ou editado que atende às condições entra na fila do agente, que é processada num ritmo por hora. Na tela do agente:

• "Fila": quantos contatos esperam ("N na fila"), o "Ritmo" e a estimativa "esvazia em aproximadamente N h". "Remover" tira um contato da fila; "Limpar fila" tira todos, e eles só voltam a ser enriquecidos se forem editados outra vez.
• "Descartados": os contatos que o agente avaliou e deixou de fora, com o motivo e a data em "Avaliado em".
• "Resultados": as "Execuções recentes", com o contato e quantos campos foram preenchidos.

Enriquecer um contato

Com o agente ligado, o cartão do contato ganha o botão "Enriquecer", com a dica "Enriquecer dados do contato".

1. Abra o contato e clique em "Enriquecer". O botão mostra "Buscando..." enquanto o agente trabalha, por até 2 minutos.
2. Com o agente em "Com aprovação", abre a janela "Aprovar Sugestões": cada campo mostra o "Sugerido" e, quando o campo já tem valor, o "Atual".
3. Marque os campos que quer gravar, ou use "Selecionar todos".
4. Clique em "Aprovar N campo(s)" para gravar ou em "Rejeitar" para descartar.

• Se o agente não achar nada, aparece "Nenhuma informação nova foi encontrada para este contato".
• Se der errado, aparece "O enriquecimento falhou".
• O botão passa na frente da fila, mas conta no limite de execuções por hora do agente. Com o limite atingido, aparece "Limite de N execuções por hora atingido para esta conta. Tente novamente mais tarde."

Enriquecer vários contatos de uma vez

1. Em "Contatos", marque os contatos, ou selecione todos do filtro.
2. No rodapé, clique em "Enriquecer com IA".
3. A janela "Enriquecer contatos com IA" explica que os contatos entram na fila do Enriquecedor e que ele respeita os critérios do agente. Ela mostra quantos contatos foram selecionados e o ritmo: "No ritmo atual, o agente processa até N contato(s) por hora."
4. Clique em "Enfileirar".

Nada muda na hora: os contatos são enriquecidos depois, no ritmo do agente. Ao terminar, a notificação da ação em massa mostra o resumo:

• "N contato(s) entraram na fila do Enriquecedor.";
• "N já estavam na fila ou foram enriquecidos há pouco.";
• "N ficaram de fora:", com o motivo, por exemplo "fora do ciclo de vida configurado", "o agente não tem gatilho de contato configurado", "o Enriquecedor está desativado" ou "o Enriquecedor não está liberado para esta conta".

Aprovação pela aba Logs

Os enriquecimentos disparados pela criação ou edição de contatos, com o agente em "Com aprovação", ficam na aba "Logs" do agente, no status "Aguardando aprovação". Quem disparou recebe no canto da tela o aviso "Aprovação pendente". Na aba "Logs", "Aprovar" aplica tudo o que o agente encontrou, sem escolher campo, e "Rejeitar pendentes" descarta todas as pendências; os contatos ficam livres para serem enriquecidos outra vez.

Créditos e Extrato de enriquecimento

O enriquecimento usa créditos de enriquecimento, com saldo próprio. Para acompanhar, abra "Nectar AI" > "Histórico" > "Extrato de enriquecimento":

• no topo, "Saldo", "Alocados", "Consumidos" e "Período";
• na tabela, cada movimento, com "Data", "Tipo" ("Alocação", "Consumo" ou "Ajuste"), "Créditos", "Saldo" e "Descrição".

O total de contatos enriquecidos no mês também aparece em "Entregas", na aba "Dashboard". Veja "A tela Nectar AI: consumo, aproveitamento e histórico".

Veja também

• "Agentes do Nectar AI: o que são e como ativar"
• "Encontrar e unir contatos duplicados"
• "Agente SDR: e-mails de prospecção com aprovação"
• "A tela Nectar AI: consumo, aproveitamento e histórico"