Créditos são a unidade que a Nuvia usa para cobrar consultas a fontes externas de dados.
Quem pode realizar: qualquer usuário do workspace (consulta); o ajuste de cota é restrito ao nível administrativo.
Caminho de acesso: Tela Principal > Menu Lateral > Seu Nome > Configurações > Créditos
O que são créditos
Crédito é a unidade de cobrança para consultas feitas pela Nuvia em fontes externas de dados. Cada consulta tem um custo fixo, definido pelo tipo de dado buscado.
Hoje, créditos são consumidos apenas por enriquecimento de contatos dentro do módulo de Listas, para encontrar e-mail e telefone. Novas funcionalidades pagas em crédito podem ser adicionadas no futuro.
Ações que não consomem crédito:
-
Criar ou importar listas
-
Criar campanhas
-
Enviar mensagens via WhatsApp ou LinkedIn
-
Conversar com a IA (Funis Inteligentes)
-
Usar o módulo de Busca padrão
Onde consultar o saldo
| Local | O que mostra |
|---|---|
| Menu lateral > Créditos | Dashboard completo: saldo disponível, consumidos, estornados, percentual de uso e histórico detalhado |
| Topo da plataforma (em qualquer tela) | Pílula com o saldo disponível e o ícone de moeda (ex: 1.240 créditos). Clicar leva direto para a tela Créditos e uso |
| Painel de enriquecimento em Listas | Estimativa de custo antes de confirmar um enriquecimento, e custo individual por campo nas células da lista |
Cota mensal e renovação
Cada workspace tem uma cota mensal de créditos. A cota padrão é 500 créditos/mês, mas pode ser ajustada pelo plano contratado.
-
A cota é alocada automaticamente no início de cada período mensal
-
O período é identificado pelo formato
ano-mês(ex:2026-04) -
A virada acontece conforme o calendário civil (primeiro dia do mês)
-
Créditos não usados não acumulam – a nova alocação substitui o saldo anterior
Custos por tipo de consulta
| Tipo de consulta | Custo por contato |
|---|---|
| Enriquecimento de E-mail profissional | 1 crédito |
| Enriquecimento de Telefone | 10 créditos |
Enriquecer os dois campos no mesmo contato soma os custos: 11 créditos por contato.
O que consome crédito (e o que não consome)
| Situação | Consome? |
|---|---|
| Enriquecimento concluído com dado encontrado | Sim – cobra o custo do campo |
| Enriquecimento concluído com resultado Não encontrado | Não – o crédito é estornado automaticamente |
| Enriquecimento concluído com resultado parcial | Sim – só os campos efetivamente encontrados |
| Falha técnica na execução (timeout, erro de infraestrutura) | Não – o crédito é estornado automaticamente |
Quando um crédito é estornado por falha, ele volta para o saldo do período e aparece na aba Estornados do dashboard de Créditos.
Histórico e transparência
Em Tela Principal > Menu Lateral > Seu Nome > Configurações > Créditos você encontra o extrato completo do workspace.
Dashboard
Na aba Dashboard, ao acessar a seção de Créditos, é possível ter uma visão geral completa do uso.
No topo, você visualiza:
-
Créditos disponíveis
-
Créditos consumidos
-
Créditos estornados
-
Uso por período
Logo abaixo, estão os detalhamentos:
-
Consumo diário dos últimos 30 dias
-
Consumo por features
-
Saúde dos créditos
-
Consumo por usuário, permitindo identificar como cada usuário está utilizando os créditos
Gasto com a Meta e mensagens da Nuvia
A tela Créditos e consumo também mostra o que acontece fora dos créditos de enriquecimento, em duas abas:
-
Meta: o gasto com mensagens da Meta (custo por template, mensagens cobradas e gratuitas e consumo por número), na moeda da sua conta, com a projeção do mês.
-
Nuvia: as mensagens e conversas do período, a distribuição de conversas por quantidade de mensagens e a lista de conversas.
Assim você acompanha quanto gasta com a Meta sem precisar abrir o WhatsApp Manager.
-
As abas Meta e Nuvia aparecem só para administradores.
-
O período personalizado vai até 3 meses.
-
O gasto com a Meta é aproximado, somado por template e atualizado a cada 6 horas.
-
Quando a conta da Meta não permite ver o custo (análise de templates desligada, sem forma de pagamento ou conta usada por mais de uma empresa), a aba mostra só o volume e explica o motivo.