Como validar termos, seções e executar pesquisas com créditos no Explory

A última etapa do assistente guiado é a mais importante: é nela que você confirma o que será analisado e quanto a consulta vai consumir antes de reservar créditos. Ignorar essa fase costuma gerar retrabalho — ou execuções bloqueadas por saldo insuficiente.

Este tutorial explica como revisar termos e seções, interpretar o custo estimado e executar a pesquisa com tranquilidade no painel Explory.


Chegando à etapa de Confirmação

Depois de definir objetivo, plataforma, termo principal, termos sugeridos e seções de análise, o wizard avança para Confirmação (VALIDATION). O painel carrega automaticamente um preview com:

  • Resumo da pesquisa — objetivo, plataforma, categoria, termos e seções selecionadas
  • Custo estimado — quantidade de créditos que a execução deve consumir
  • Saldo disponível — créditos atuais da sua conta
  • Execuções trial restantes — quando você está no plano gratuito

Se o preview demorar alguns segundos, aguarde: o backend calcula a estimativa com base nos parâmetros finais da sessão.


Revisando termos antes de executar

Na etapa Termo, você informou a palavra-chave ou produto central. Em Termos sugeridos, a IA pode propor variações para ampliar ou refinar o recorte.

Antes de executar, confira no card de resumo:

  • O termo principal reflete exatamente o que você quer estudar?
  • Os termos adicionais não puxam a análise para um nicho irrelevante?
  • A plataforma corresponde ao marketplace onde você opera?

Se algo estiver errado, clique em Voltar e ajuste. Corrigir agora é mais barato do que repetir uma execução completa.


Escolhendo as seções certas

Na etapa Seções, você marca os blocos que deseja no relatório — por exemplo tendências, concorrência, preços ou oportunidades. Cada seção influencia a profundidade da análise e, em muitos casos, o custo em créditos.

Boas práticas:

  1. Priorize seções acionáveis — inclua só o que você vai ler e aplicar.
  2. Teste com menos seções na primeira execução de um nicho novo; depois aprofunde.
  3. Compare o custo estimado ao alterar seções: o painel recalcula na confirmação.

Entendendo créditos e bloqueios

O card Custo estimado mostra:

| Campo | Significado | |-------|-------------| | Créditos estimados | Consumo previsto desta execução | | Saldo disponível | Créditos que você ainda pode usar | | Execuções trial restantes | Limite de runs no plano gratuito |

O botão Executar pesquisa só fica ativo quando canExecute é verdadeiro. Bloqueios comuns:

  • Créditos insuficientes — saldo menor que a estimativa
  • Limite trial atingido — esgotou execuções gratuitas
  • Assinatura inativa — pagamento pendente ou plano cancelado

Nesses casos, o painel exibe uma mensagem explicativa e atalhos para Ver planos (/pricing) ou Gerenciar assinatura (/panel/subscription/manage).


Executando com segurança (idempotência)

Ao clicar em Executar pesquisa, a Explory reserva créditos e inicia o processamento assíncrono. O sistema usa chave de idempotência: se a rede falhar após o clique, uma nova tentativa com a mesma chave não debita créditos em duplicidade dentro da janela de segurança.

Após o sucesso, você é redirecionado para a tela de progresso da execução. Acompanhe o status até o relatório ficar pronto; depois acesse pelo histórico ou pelo link direto do resultado.


E se a execução falhar?

Falhas de processamento podem gerar estorno de créditos conforme a política da plataforma — verifique no detalhe da execução no histórico se houve reembolso (creditsRefunded). Para erros de validação antes da execução, ajuste os parâmetros e tente novamente sem consumo.


Checklist rápido antes do clique final

  • [ ] Termo e plataforma corretos
  • [ ] Seções alinhadas ao objetivo de negócio
  • [ ] Saldo de créditos suficiente
  • [ ] Plano ativo (se aplicável)

Próximo passo

Validar termos, seções e créditos é o hábito que separa uma pesquisa estratégica de um gasto aleatório. Use a confirmação como sua última revisão antes de colocar a IA para trabalhar.

Abra uma nova consulta e valide sua próxima pesquisa →