Manual do Usuário
Voltar ao app
Manual do Usuário

Bem-vindo à Expertise IA

Plataforma de consultoria por IA onde especialistas publicam sua base de conhecimento e clientes fazem perguntas diretamente para uma IA treinada com os documentos do profissional.

Especialistas
Publique sua IA
Clientes
Consulte por IA
Tecnologia
RAG + LLM
🤖 RAG sob demanda

As respostas são geradas com base nos documentos reais do especialista, não em dados genéricos

💳 Pagamento por pergunta

Perguntas avulsas, pacotes de 10 ou assinatura mensal com renovação automática

📱 PWA instalável

Funciona como app no celular, com suporte offline e instalação via navegador

🔒 Acesso controlado

Cada especialista controla quem pode engajar com sua IA e a que preço

🚀

Primeiros passos

Como criar conta e começar a usar a plataforma

Público Cliente Especialista
📝 Criando sua conta
Acesse /register ou clique em "Criar conta" na navegação principal
Preencha seu nome completo e e-mail e defina uma senha segura (mínimo 8 caracteres)
Confirme seu e-mail clicando no link enviado para sua caixa de entrada
Após verificar o e-mail, você é redirecionado ao Painel automaticamente
💡 Por padrão toda conta criada tem o perfil de Cliente. Para se tornar Especialista, entre em contato com o administrador da plataforma.
🔍

Marketplace de Especialistas

Descubra e compare especialistas disponíveis na plataforma

Público Cliente
🗂 Como navegar pelo marketplace
  • Acesse /specialists ou clique em "Buscar IA" na navegação
  • Use a barra de busca para pesquisar por nome, bio ou especialidade
  • Filtre por especialidade usando o seletor ou os chips rápidos abaixo da busca
  • Cada card mostra: avatar, especialidade, preço por pergunta, nome, headline, bio resumida, contagens de avaliações e documentos
  • Clique em "Ver perfil" para acessar a página completa do especialista
📄 Perfil do especialista — o que você encontra
SeçãoO que tem
SobreBio completa, formação, especialidade, anos de experiência, modo de interação
PerguntarChat com a IA treinada, histórico da conversa atual, atalhos inteligentes
Comprar acessoSeletor de plano (avulsa / pacote / assinatura), checkout Stripe
HistóricoConversas anteriores com este especialista
AvaliaçõesReviews de clientes com nota e comentário, formulário para avaliar
👤

Conta de Cliente

Como funciona o perfil de cliente na plataforma

Cliente
ℹ️ Como cliente você pode navegar pelo marketplace, comprar acesso a especialistas, fazer perguntas para as IAs, avaliar o atendimento e exportar todo o seu histórico.
🔑 Acesso e créditos
  • Créditos são perguntas disponíveis que você comprou e ainda não usou
  • Cada pergunta feita consome 1 crédito, independente do especialista
  • Créditos de assinatura renovam mensalmente na data de cobrança
  • Créditos de pacote ou avulso não expiram
📊

Painel do Cliente

Central de controle com seus créditos, histórico e assinaturas

Cliente
📋 O que você vê no painel
Créditos disponíveis

Perguntas que podem ser feitas agora mesmo

Histórico total

Total de perguntas feitas desde o cadastro

Assinaturas ativas

Quantos especialistas você assina mensalmente

  • Pagamentos recentes com status e valor
  • Assinaturas ativas com data de renovação
  • Alertas de pagamentos com problema (falha, disputa, reembolso)
  • Conversas recentes com links para continuar
⚠️ Alertas de pagamento

Se um pagamento falhar, você verá um aviso em destaque no painel. Acesse sua conta Stripe ou entre em contato com o suporte para resolver.

💬

Fazer Perguntas

Como consultar a IA treinada de um especialista

Cliente
🛠 Como funciona o chat
Acesse o perfil do especialista em /specialists/{slug}
Verifique se você tem acesso liberado — é exibido acima do campo de texto
Digite sua pergunta na área de texto. Use os atalhos inteligentes para perguntas comuns
Clique em Enviar e aguarde a resposta da IA (alguns segundos)
A resposta aparece com indicador de contextos recuperados — os trechos dos documentos usados
💡 Cada pergunta inicia ou continua uma sessão de conversa. Você pode fazer perguntas em sequência mantendo o contexto da conversa anterior.
🚀 Atalhos inteligentes

O botão de atalhos sugere perguntas frequentes como "Pedir resumo", "Plano de ação" e "Próximos documentos". Clique em um atalho para preenchê-lo automaticamente no campo de texto.

💳

Comprar Acesso

Planos de acesso disponíveis em cada especialista

Cliente
📦 Tipos de plano
PlanoCréditosValidadeIdeal para
Pergunta avulsa1 perguntaNão expiraTirar dúvida pontual
Pacote intensivo10 perguntasNão expiraProjeto ou imersão
Assinatura mensalIlimitadas*Renova mensalmenteUso recorrente

*A assinatura garante acesso contínuo enquanto estiver ativa. Cancele a qualquer momento antes do próximo ciclo.

💳 Como comprar
No perfil do especialista, clique na aba "Comprar acesso"
Selecione o tipo de plano desejado
Clique em "Comprar acesso" — você será redirecionado ao checkout do Stripe
Preencha os dados do cartão no formulário seguro do Stripe
Após aprovação, você é redirecionado de volta com o acesso já liberado
⚠️ Todos os pagamentos são processados pelo Stripe. A plataforma não armazena dados de cartão. Em caso de disputa ou reembolso, entre em contato com o suporte.
🔄

Assinaturas

Como gerenciar assinaturas mensais com especialistas

Cliente
📅 Gerenciar assinaturas
  • Acesse o Painel (/dashboard) para ver todas as assinaturas ativas
  • Cada assinatura exibe o especialista, valor mensal e a data de renovação
  • Para cancelar, clique em "Cancelar" ao lado da assinatura desejada
  • O cancelamento é imediato — o acesso permanece até o fim do período pago
  • Se a assinatura estiver em atraso, você verá um alerta vermelho no painel

Avaliações

Como avaliar especialistas após consultas

Cliente
⭐ Como deixar uma avaliação
Após uma consulta, acesse a aba "Avaliações" no perfil do especialista
Se você tiver uma conversa ativa e ainda não avaliou, o formulário aparecerá automaticamente
Selecione uma nota de 1 a 5 estrelas
Escreva um comentário (opcional, até 2000 caracteres)
Clique em "Enviar avaliação"
💡 Avaliações passam por moderação do administrador antes de aparecerem publicamente. Uma avaliação por conversa é permitida.
📥

Exportar Dados

Baixe um relatório completo de sua atividade na plataforma

Cliente
📊 Relatório de atividade (CSV)

No painel, clique em "Exportar atividade" para baixar um arquivo CSV com:

  • Todos os pagamentos com status, valor e data
  • Todas as assinaturas com plano e intervalo
  • Todas as conversas com especialista e contagem de mensagens
🔧

Configurar Perfil de Especialista

Como editar suas informações públicas no marketplace

Especialista
✏️ Campos do perfil
CampoDescriçãoLimite
Nome públicoNome exibido no marketplace255 chars
HeadlineTagline que aparece no card do marketplace255 chars
EspecialidadeÁrea de atuação (ex: "Direito Digital")
Anos de experiênciaNúmero inteiro de 0 a 600–60
Preço por perguntaValor cobrado por pergunta avulsa (R$)mín. R$0
BioDescrição completa exibida no perfil5.000 chars
FotoImagem de perfil (JPG/PNG/GIF)máx. 2MB
VisibilidadeSe ativo, aparece no marketplace
💡 O campo slug (URL do seu perfil) é gerado automaticamente a partir do seu nome. Para alterar, entre em contato com o administrador.
📈

Painel Operacional

Métricas de receita, consultas e desempenho da sua IA

Especialista
📊 O que você vê no painel
Receita

Total líquido recebido já descontada a comissão da plataforma

Base

Número de documentos já processados e prontos para RAG

Confiança

Média das avaliações dos seus clientes (1 a 5 estrelas)

💰 Faturamento por produto

Veja o detalhamento de receita separado por: Pergunta avulsa, Pacote intensivo e Assinatura mensal. Para cada tipo você vê: quantidade vendida, valor bruto total (do cliente) e valor líquido (sua parte).

📄 Status dos documentos
  • Processados — documentos indexados e prontos para responder perguntas
  • Aguardando — documentos na fila de processamento
  • Com falha — documentos que falharam ao ser processados (ação necessária)
📄

Base de Conhecimento

Como adicionar e gerenciar documentos que treinam sua IA

Especialista
📁 Modos de adicionar documentos
ModoFormatosLimite
📎 ArquivoPDF, DOCX, TXT, MD15 MB por arquivo
🌐 URL externaPáginas web com textoSem limite de tamanho
▶️ YouTubeVídeos com legenda/transcriçãoSem limite
🎤 Nota de vozGravação pelo microfoneSem limite
🔄 Ciclo de processamento
Você faz o upload ou importa o conteúdo — status muda para Enviado
O serviço de IA extrai o texto e divide em chunks — status Processando
Os chunks são vetorizados (embedding) e armazenados no banco vetorial — status Processado
Documento disponível para responder perguntas de clientes via RAG
⚠️ Documentos com falha

Se um documento falhar, um botão "Tentar novamente" aparecerá na biblioteca. Clique nele para reenviar ao processamento. Se o erro persistir, verifique se o arquivo está íntegro e no formato suportado.

🔗 Importar de URL — Preview

Antes de importar uma URL, a plataforma exibe um preview do conteúdo capturado (título, resumo, tamanho em caracteres). Você pode confirmar ou cancelar antes de enviar ao processamento.

💰

Receita e Comissões

Como a plataforma calcula e distribui os pagamentos

Especialista
💸 Estrutura de comissão
  • A plataforma retém uma comissão percentual sobre cada pagamento
  • O valor líquido (sua parte) é o valor bruto menos a comissão da plataforma
  • Cada pagamento exibe: Bruto (pago pelo cliente), Taxa (comissão da plataforma) e Líquido (sua parte)
📊 Exportar suas operações

No painel, clique em "Exportar operação" para baixar um CSV com pagamentos, conversas, avaliações e documentos com todas as métricas financeiras.

👁

Visibilidade no Marketplace

Como controlar quando você aparece para os clientes

Especialista
🔘 Toggle de visibilidade

Em /specialist/profile, há um campo "Visibilidade" com estados:

  • Ativo — seu perfil aparece no marketplace e aceita novas perguntas
  • Inativo — seu perfil é ocultado do marketplace (buscas e listagens)

Ao desativar, conversas em andamento continuam funcionando. Apenas novos clientes não encontram seu perfil na busca.

🛡

Painel Administrativo

Visão geral completa da plataforma em tempo real

Admin
📊 Métricas do dashboard
Usuários

Total de contas cadastradas

Especialistas

Perfis de especialistas ativos/inativos

Receita

Total bruto de pagamentos bem-sucedidos

Mensagens IA

Total de respostas geradas pela IA

Assinaturas

Assinaturas pagas com sucesso

Avaliações

Reviews visíveis no marketplace

Falhas

Pagamentos com status "failed"

Disputas

Chargebacks em aberto

Reembolsos

Pagamentos reembolsados

🔗 Navegação admin

No topo do painel há chips de navegação rápida para: Usuários, Especialistas, Conversas, Pagamentos e Log de atividade.

👥

Gestão de Usuários

Busca, filtragem, edição e controle de contas

Admin
🔍 Filtros disponíveis
  • Busca — por nome ou e-mail (parcial)
  • Papel — Admin, Especialista, Cliente
  • Status — Ativo, Inativo
  • E-mail verificado — Verificado, Não verificado
  • Ordenação — Mais recente, Mais antigo, A-Z por nome/e-mail
✏️ Editar usuário

Na tela de detalhes (/admin/users/{id}) você pode alterar:

  • Nome, e-mail, papel (role), status ativo/inativo
  • Ao mudar o papel para Especialista, um perfil de especialista é criado automaticamente
  • Ao mudar para Cliente, um perfil de cliente é criado automaticamente
🚫 Desativar/Reativar conta

Você pode ativar ou desativar contas diretamente na listagem ou na tela de detalhes. Contas inativas não podem fazer login. Especialistas inativos são removidos do marketplace.

🎭

Impersonação de Usuário

Login temporário como qualquer usuário da plataforma

Admin
🎭 Como usar a impersonação
Acesse /admin/users ou a tela de detalhes do usuário
Clique no botão "Impersonar" (ícone de máscara) ao lado do usuário
Você será logado como aquele usuário — um banner laranja no topo da tela confirma a impersonação
Navegue pelo app como se fosse o usuário, para depurar ou verificar algo
Clique em "Voltar ao Admin" no banner para encerrar a impersonação
⚠️ Toda impersonação é registrada no log de atividade com IP e timestamp. Não use para fazer ações não autorizadas em nome do usuário.
🏆

Gestão de Especialistas

Visão operacional de todos os especialistas da plataforma

Admin
📋 Informações por especialista
  • Nome, e-mail, especialidade, status (ativo/inativo)
  • Contagem de: documentos, conversas, avaliações
  • Receita bruta total gerada
  • Nota média (rating)
  • Botões: Detalhes (edição) e Ver perfil (página pública)
📋

Monitoramento de Conversas

Acompanhe e leia todas as conversas da plataforma

Admin
👁 Visualizar conversa

Em /admin/conversations/{id} você vê a transcrição completa da conversa com:

  • Mensagens do cliente com timestamps
  • Respostas da IA com indicador de contextos recuperados
  • Sidebar com informações do especialista e cliente
🏦

Gestão de Pagamentos

Controle financeiro completo de todos os pagamentos

Admin
💰 Métricas de pagamento
  • Receita total — soma de todos os pagamentos com sucesso
  • Total de transações — todos os registros de pagamento
  • Pagos — transações com status "paid"
  • Falhados — transações que não foram processadas
🔍 Filtros de pagamento
  • Status — Pendente, Pago, Falha, Disputa, Reembolso
  • Tipo — Pergunta avulsa, Pacote intensivo, Assinatura
  • Busca — por nome do especialista, cliente ou ID Stripe
⚠️

Gestão de Incidentes de Cobrança

Como tratar pagamentos com problema

Admin
🚨 Estados de incidente
EstadoSignificado
NovoIncidente detectado, ainda sem ação do admin
InvestigandoAdmin está analisando o caso
ResolvidoIncidente encerrado com solução aplicada
📝 Campos do tratamento
  • Estado do incidente — novo / investigando / resolvido
  • Nota interna — texto livre para documentar o caso (máx. 500 chars)
  • Cliente notificado — checkbox confirmando que o cliente foi avisado
  • Especialista compensado — checkbox confirmando compensação ao especialista
📝

Log de Atividade

Trilha de auditoria de todas as ações administrativas

Admin
📋 Eventos registrados
EventoDescrição
user_updatedDados do usuário alterados pelo admin
user_activated / user_deactivatedStatus de conta alterado
impersonate_start / impersonate_stopInício e fim de impersonação
review_published / review_hiddenModeração de avaliação
billing_incident_updatedTratamento de incidente de pagamento
🔍 Cada registro exibe
  • Admin que executou a ação
  • Tipo de ação
  • Sujeito afetado (usuário, pagamento, review)
  • Metadados (o que mudou)
  • Endereço IP do admin
  • Data e hora
⚙️

Configurações da Plataforma

Ajuste parâmetros operacionais da plataforma

Admin
⚙️ Acessar configurações

Acesse /admin/settings no menu do admin para ajustar todos os parâmetros da plataforma: app, banco de dados, IA, pagamentos, e-mail, armazenamento e filas.

💡 As configurações são salvas no arquivo .env do servidor. Alterações entram em vigor imediatamente após salvar.
🪪

Editar Perfil

Como atualizar nome, e-mail e dados da conta

ClienteEspecialistaAdmin
✏️ Dados da conta
  • Em /profile você pode alterar nome e e-mail
  • Ao mudar o e-mail, um novo link de verificação é enviado
  • Enquanto não verificar o novo e-mail, algumas funcionalidades ficam restritas
🔒

Senha e Segurança

Como alterar sua senha de acesso

ClienteEspecialistaAdmin
🔑 Alterar senha
Acesse /profile e clique na aba Segurança
Informe sua senha atual para confirmação
Digite a nova senha e confirme repetindo-a
Clique em Atualizar senha
💡 Se esqueceu sua senha, acesse /forgot-password para receber um link de redefinição por e-mail.
🗑

Excluir Conta

Como remover permanentemente sua conta da plataforma

ClienteEspecialista
⚠️ Esta ação é irreversível. Todos os seus dados serão excluídos permanentemente, incluindo histórico de conversas, documentos (especialistas) e registros de pagamento.
🗑 Como excluir
Acesse /profile e clique na aba Privacidade
Leia o aviso de irreversibilidade com atenção
Digite sua senha atual para confirmar a exclusão
Clique em "Excluir conta" para confirmar