1. [Ajuda](https://nuvia.ai/docs)

# Como consultar o log de enriquecimento

Como usar o Log de enriquecimento: KPIs, filtros, colunas da tabela e casos de uso para auditar consumo de créditos e investigar execuções.

Disponível em

todos os planos com cota de créditos ativa.

Quem pode fazer

qualquer usuário do workspace. Módulo: Menu lateral > Log de enriquecimento

Atualizado em 3 de agosto de 2026

Nesta página

1. Abrir o Log de enriquecimento
2. Ler os KPIs do período
3. Aplicar filtros
4. Entender as colunas da tabela
5. Auditar o consumo do mês
6. Investigar contatos que não foram enriquecidos
7. Ver execuções feitas por um usuário específico
8. Limites e regras

**Nesta página8 seções**

1. Abrir o Log de enriquecimento
2. Ler os KPIs do período
3. Aplicar filtros
4. Entender as colunas da tabela
5. Auditar o consumo do mês
6. Investigar contatos que não foram enriquecidos
7. Ver execuções feitas por um usuário específico
8. Limites e regras

O Log de enriquecimento é a tela de auditoria de todas as execuções de enriquecimento do workspace, com filtros, KPIs e detalhes por contato. Use para acompanhar consumo, investigar resultados específicos ou entender por que determinados contatos não foram encontrados.

## Abrir o Log de enriquecimento

1.

No menu lateral, clique em **Log de enriquecimento**

2.

A tela abre com os 4 cards de KPI no topo e a tabela de execuções abaixo

Você também chega ao Log pelo widget de monitoramento online – no final de um enriquecimento em bulk, clique em **Ver histórico de enriquecimento**.

## Ler os KPIs do período

No topo da tela, 4 cards resumem as execuções considerando o filtro de data ativo (ou o período todo, se nenhum filtro estiver aplicado).

CardO que mostra

**Execuções** Número total de enriquecimentos no período selecionado

**Créditos consumidos** Total de créditos gastos nas execuções do período

**Dados encontrados** Quantidade de contatos cujos dados foram encontrados com sucesso

**Dados não encontrados** Quantidade de contatos para os quais nenhum dado foi retornado

Os KPIs atualizam automaticamente quando você muda os filtros.

## Aplicar filtros

Use a barra acima da tabela para refinar a consulta.

FiltroOpções

**Campo** E-mail profissional, Telefone, ou todos

**Status** Encontrado, Não encontrado, Busca não realizada, Parcial, Erro, ou todos

**Período** Intervalo de datas (data inicial e final)

Os filtros são combináveis – por exemplo: só execuções de Telefone com status **Não encontrado** nos últimos 7 dias.

Dica

mudar qualquer filtro reseta a paginação para a primeira página. Os KPIs também recalculam com base nos filtros ativos.

## Entender as colunas da tabela

Cada linha representa uma execução individual (um campo, um contato, uma tentativa).

ColunaConteúdo

**Tipo** O campo enriquecido: E-mail profissional ou Telefone

**Contato** Nome e iniciais do contato. Se deletado após a execução, aparece “Contato removido”

**Lista** Nome da lista de origem (quando a execução partiu de uma lista)

**Iniciado por** Usuário da Nuvia que disparou a execução

**Data** Timestamp completo da execução

**Créditos** Créditos consumidos nessa execução específica

**Status** Badge com cor conforme o resultado: Encontrado, Parcial, Não encontrado, Busca não realizada, Erro

## Auditar o consumo do mês

1.

No filtro de **Período**, selecione o mês atual (ex: 01/04 a 30/04)

2.

Deixe os outros filtros em “todos”

3.

Veja no card **Créditos consumidos** o total gasto

4.

Compare com a cota mensal em **Menu lateral** > **Créditos**

## Investigar contatos que não foram enriquecidos

1.

No filtro de **Status**, selecione **Não encontrado**

2.

Ajuste o **Período** para o intervalo investigado

3.

A tabela mostra todos os contatos em que a cascata rodou mas não retornou dado

4.

Clique no contato para ver o perfil completo e verificar quais dados de origem existiam na hora da execução

Dica

combine com **Campo: Telefone** para entender por que o custo de telefone parece alto em relação aos resultados – o Telefone é o campo mais caro (10 créditos) e com maior taxa de “Não encontrado” em bases brasileiras.

## Ver execuções feitas por um usuário específico

A coluna **Iniciado por** identifica quem disparou cada enriquecimento. Não há filtro direto por usuário na barra de filtros – ordene ou busque visualmente pela coluna para auditar a atividade de uma pessoa específica.

### Conferir se uma execução em bulk concluiu

1.

Logo após um enriquecimento em bulk, clique em **Ver histórico de enriquecimento** no widget de monitoramento

2.

Ordene por **Data** (mais recente primeiro)

3.

As execuções do lote aparecem listadas individualmente – uma linha por contato + campo

## Limites e regras

RegraValor

Paginação padrão 10 registros por página

Paginação máxima suportada Até 150 registros por página

Retenção de logs Sem data de expiração definida – logs históricos ficam disponíveis

Atualização em tempo real Os logs aparecem automaticamente conforme as execuções terminam

Exportação Não disponível nesta versão. Para extrato contábil, use **Menu lateral** > **Créditos** > **Histórico**

## Perguntas frequentes

**Por quanto tempo os logs ficam disponíveis?**

Os logs não têm data de expiração automática – você consegue consultar execuções antigas para fins de auditoria. Use os filtros de período para restringir a consulta.

**Posso exportar os logs em CSV ou Excel?**

Não nesta versão. Se você precisa de um extrato estruturado do consumo, use **Menu lateral > Créditos > Histórico** como referência contábil. Para casos específicos, entre em contato com o suporte.

**Um contato aparece como “Contato removido” no log. Por quê?**

O contato foi deletado depois que a execução rodou. O log preserva o registro histórico da cobrança, mesmo que o contato original já não exista mais. Isso garante a rastreabilidade do consumo.

**Como sei se a execução foi disparada pela lista ou pela tela de busca?**

A coluna **Lista** mostra o nome da lista de origem quando a execução partiu da lista. Se estiver vazia, a execução provavelmente veio de outro fluxo (como enriquecimento pontual em uma célula). A coluna **Iniciado por** sempre identifica o usuário.

**Vejo “Erro” no status de algumas execuções. Vou perder o crédito?**

Não. Falhas técnicas geram extorno automático – o crédito volta para o saldo e aparece no Histórico de Créditos como **Extornado**. A linha do log permanece visível para auditoria.

**Qual a diferença entre “Não encontrado” e “Busca não realizada”?Não encontrado** – a cascata rodou em todas as fontes elegíveis e nenhuma retornou o dado. O crédito foi consumido. **Busca não realizada** – a busca sequer começou (contato sem dados de origem suficientes ou outra regra de elegibilidade). Nenhum crédito foi cobrado.

Este artigo ajudou?

## Artigos relacionados

- [Como interpretar as métricas de campanha](https://nuvia.ai/docs/artigos/14576475-como-interpretar-as-metricas-de-campanha)
- [Como enriquecer contatos em uma lista](https://nuvia.ai/docs/artigos/14688472-como-enriquecer-contatos-em-uma-lista)
- [Entendendo os créditos da Nuvia](https://nuvia.ai/docs/artigos/14688479-entendendo-os-creditos-da-nuvia)
- [Como utilizar o MCP da Nuvia](https://nuvia.ai/docs/artigos/15825545-como-utilizar-o-mcp-da-nuvia)
- [Referência das ferramentas MCP da Nuvia](https://nuvia.ai/docs/artigos/16074574-referencia-das-ferramentas-mcp-da-nuvia)

## Ainda precisa de ajuda?

Clientes falam com o suporte pelo chat dentro da plataforma. Ainda não é cliente? Fale com o nosso time.

[Falar com o suporte na plataforma](https://app.nuvia.ai) [Ainda não sou cliente](https://nuvia.ai/contact)

---
Source: https://nuvia.ai/docs/artigos/14688493-como-consultar-o-log-de-enriquecimento
