Manual Completo

Como usar o
Consultor Platinum

Da instalação ao primeiro aluno — tudo que você precisa para colocar os 5 especialistas de IA funcionando dentro da sua plataforma.

5Agentes de IA
8Passos guiados
100%Pronto para embed
Ponto de partida

O que é o Consultor Platinum?

Uma ferramenta interativa com 5 especialistas de IA que conversam individualmente com seus alunos, guiando cada etapa da jornada de vendas no Mercado Livre.

Aluno abre a ferramenta
Escolhe um especialista
Faz sua pergunta
IA responde com orientação especializada
💡
Como funciona por baixo dos panos: cada agente é um chat independente com um "system prompt" especializado. Quando o aluno digita uma pergunta, o texto vai direto para a API do Claude, que responde como aquele especialista específico. Sem banco de dados, sem backend complexo — só React + API.
🎯 Caçador de ProdutosNicho → Validação
🏭 Especialista em FornecedoresProduto → Sourcing
✍️ Criador de AnúnciosProduto → Anúncio completo
💰 Especialista em PrecificaçãoCusto → Preço ideal
🚀 Mentor de EscalaVendas → Crescimento
Os especialistas

Conheça os 5 Agentes

Cada agente foi treinado para uma fase específica da jornada do vendedor. O aluno usa cada um no momento certo.

🎯
Caçador de Produtos
Analisa nichos, estima demanda e concorrência, e pontua cada oportunidade de 0 a 10. Ideal para o aluno que ainda não sabe o que vender.
"Quero vender produtos para pets. O que tem mais oportunidade?"
🏭
Especialista em Fornecedores
Mapeia fornecedores nacionais e internacionais (Alibaba, 1688, atacadistas), com preços estimados e riscos de cada opção.
"Quero comprar capinhas de celular para revender. Onde buscar?"
✍️
Criador de Anúncios
Cria título SEO, 5 variações, descrição completa, bullet points, FAQ e 6 prompts de imagem para IA. Tudo de uma vez.
"Crie um anúncio de suporte ergonômico para notebook."
💰
Especialista em Precificação
Calcula todos os custos (comissão ML, frete, imposto, embalagem) e entrega 3 preços estratégicos com margem real.
"Comprei por R$45. Como precificar no ML com margem saudável?"
🚀
Mentor de Escala
Cria plano de 90 dias, estratégia de Mercado Ads, reputação e crescimento — do zero até MercadoLíder.
"Já tenho 10 vendas. Como acelero meu crescimento no ML?"
🎯
Dica de uso na plataforma: apresente os agentes como uma "equipe de consultores" do aluno. Isso aumenta muito o valor percebido e a retenção da assinatura mensal.
Guia do aluno

Passo a passo para o aluno

O que mostrar no onboarding — como o aluno aprende a usar a ferramenta da forma certa desde o primeiro acesso.

1
Acesse a ferramenta pela plataforma
O Consultor Platinum fica embutido como módulo dentro do seu curso

O aluno acessa o Consultor Platinum diretamente dentro da sua plataforma de treinamento — sem precisar sair ou criar conta em outro serviço. Ele aparece como uma seção do módulo, como um vídeo ou exercício.

  • A ferramenta carrega instantaneamente no browser
  • Não exige login adicional — acesso pelo login da plataforma
  • i Funciona em celular e computador (design responsivo)
2
Escolha o especialista certo para o momento
Cada agente resolve um problema específico da jornada de venda

A tela inicial mostra os 5 especialistas em cards. O aluno deve escolher com base em onde está na jornada:

  • Não sei o que vender → 🎯 Caçador de Produtos
  • Sei o produto, não sei onde comprar → 🏭 Especialista em Fornecedores
  • Tenho o produto, preciso anunciar → ✍️ Criador de Anúncios
  • Preciso precificar corretamente → 💰 Especialista em Precificação
  • Já vendo, quero crescer → 🚀 Mentor de Escala
3
Faça perguntas específicas e concretas
Quanto mais contexto o aluno der, mais útil a resposta será

A qualidade da resposta depende da qualidade da pergunta. Ensine seus alunos a perguntar com contexto:

Pergunta fraca: "Quais produtos vender?"
Resultado: resposta genérica, pouco útil.
Pergunta forte: "Tenho R$2.000 para investir, moro em SP, quero vender produtos para casa e nunca vendi no ML. Quais nichos têm menos concorrência e margem acima de 30%?"
Resultado: análise detalhada e personalizada.

Oriente os alunos a incluir sempre: nicho ou produto de interesse, capital disponível, experiência atual e objetivo principal.

4
Continue a conversa para aprofundar
O agente lembra o histórico da sessão — use isso a favor

Dentro de cada agente, o histórico da conversa é mantido durante a sessão. O aluno pode fazer perguntas de acompanhamento naturalmente:

  • "Pode detalhar mais a segunda opção?"
  • "E se eu tiver apenas R$500 para começar?"
  • "Como ficaria o anúncio para esse produto específico?"
  • !Ao recarregar a página, o histórico é perdido — isso é normal e esperado.
5
Copie, salve e aplique as respostas
A ferramenta é um acelerador — a ação ainda é do aluno

As respostas dos agentes são para uso imediato. Oriente seus alunos a:

  • Copiar títulos e descrições gerados pelo Criador de Anúncios direto para o ML
  • Usar os prompts de imagem no Midjourney, DALL-E ou ChatGPT
  • Salvar a planilha de precificação em um doc ou planilha própria
  • iO Consultor é um ponto de partida — os números e estratégias devem ser validados com dados reais do ML
Para o criador da plataforma

Como instalar na sua plataforma

Você tem o arquivo consultor-platinum.jsx — veja como colocar ele no ar.

A
Opção recomendada — Embed via iframe (mais simples)
Hospedar em um site separado e incorporar na plataforma

Se sua plataforma suporta HTML/iframe (Hotmart, Kiwify, Thinkific, área de membros própria), essa é a opção mais rápida.

Passo 1 — Hospede o app em Vercel ou Netlify (grátis):

terminal
# Instale o Vite + React se não tiver
npm create vite@latest consultor-platinum -- --template react
cd consultor-platinum

# Substitua src/App.jsx pelo arquivo consultor-platinum.jsx
# Depois suba para o GitHub e conecte no Vercel

npm install
npm run build

Passo 2 — Adicione o proxy da API key no backend:

⚠️
Importante: nunca coloque a API key diretamente no código React (fica exposta). Crie um endpoint no seu backend que recebe as mensagens e chama a API Anthropic com a key no servidor.
vercel — api/chat.js
// Substitua a URL no fetch do app por /api/chat
export default async function handler(req, res) {
  const response = await fetch(
    'https://api.anthropic.com/v1/messages', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'x-api-key': process.env.ANTHROPIC_API_KEY,
        'anthropic-version': '2023-06-01'
      },
      body: JSON.stringify(req.body)
    }
  );
  const data = await response.json();
  res.json(data);
}

Passo 3 — Incorpore via iframe na plataforma:

HTML do módulo
<iframe 
  src="https://SEU-APP.vercel.app"
  width="100%"
  height="700px"
  style="border:none;border-radius:16px;"
  allow="clipboard-write"
></iframe>
B
Opção avançada — Integrar direto na plataforma React/Next.js
Se você tem uma área de membros própria em React

Importe o componente diretamente no seu projeto:

seu-projeto/pages/consultor.jsx
import ConsultorPlatinum from '../components/ConsultorPlatinum';

export default function ConsultorPage() {
  return (
    <ProtectedRoute>
      <ConsultorPlatinum />
    </ProtectedRoute>
  );
}
ℹ️
Nesse caso, o fetch da API deve apontar para uma rota autenticada do seu backend — assim só alunos com assinatura ativa conseguem usar.
C
Variáveis de ambiente necessárias
Configurações obrigatórias antes de ir ao ar
  • ANTHROPIC_API_KEY — sua chave da API Anthropic (console.anthropic.com). Nunca exposta no frontend.
  • i
    Modelo: o app usa claude-sonnet-4-20250514. Você pode trocar por um modelo mais barato se quiser reduzir custo.
  • !
    Rate limiting: considere limitar chamadas por usuário para controlar custo em escala.
Resolução de problemas

Bugs comuns e como corrigir

Os problemas mais frequentes ao configurar a ferramenta — e a solução exata para cada um.

Problema Causa Solução
BUG
Mensagem "Erro de conexão" ao enviar pergunta
A API key não está configurada ou o endpoint está errado FIX Verifique se ANTHROPIC_API_KEY está nas variáveis de ambiente do servidor. Se usar Vercel, adicione em Project → Settings → Environment Variables.
BUG
Iframe mostra tela branca
Erro de CORS ou problema no build FIX Certifique que o deploy foi bem-sucedido. Acesse a URL do app diretamente no browser antes de incorporar via iframe.
BUG
Resposta para depois de muito tempo ou não retorna
Timeout na chamada da API FIX Aumente o timeout do seu serverless function para 30s. No Vercel, adicione "maxDuration": 30 no vercel.json.
BUG
Botão "↑" não funciona no mobile
Evento de touch não disparando FIX Troque onClick por onPointerUp no botão de envio do componente.
BUG
Respostas muito curtas ou cortadas
max_tokens: 1000 está baixo para análises complexas FIX Aumente para max_tokens: 2000 ou 3000 no fetch da API. Cuidado: aumenta custo por resposta.
BUG
Histórico de conversa perde contexto
Estado React sendo resetado (troca de rota ou refresh) FIX Isso é comportamento esperado — o histórico só existe na sessão. Oriente o aluno a não recarregar a página durante uma conversa.
BUG
Erro 401 — Unauthorized
API key inválida ou expirada FIX Gere uma nova chave em console.anthropic.com → API Keys. Certifique que não há espaços extras ao colar a chave.
BUG
Erro 429 — Too Many Requests
Rate limit da API Anthropic atingido FIX Implemente fila de requisições ou aumente o tier do plano Anthropic. Para uso inicial, o tier gratuito é suficiente para testes.
🔍
Como debugar qualquer erro: abra o DevTools do browser (F12), vá em Network → filtre por "messages" → clique na requisição → veja o campo error no Response. O erro da API sempre vem com uma mensagem clara.
Antes de publicar

Checklist de validação

Valide cada ponto antes de liberar o acesso para seus alunos. Esse checklist garante que tudo vai funcionar na prática.

Funcionalidade
✅ Chat funciona nos 5 agentes
Teste enviando uma pergunta em cada um dos 5 especialistas e confirme que a resposta chega.
● Como testar: abra cada agente, envie "Olá" e aguarde resposta
Funcionalidade
✅ Histórico de conversa persiste
Envie 3 mensagens em sequência e confirme que o agente lembra o contexto anterior.
● Pergunta de follow-up deve ser respondida com contexto
UX
✅ Botão "voltar" funciona
Dentro de um agente, clique em ← e confirme que volta para a tela de seleção sem erros.
● Histórico deve ser apagado ao voltar e entrar novamente
UX
✅ Responsivo no celular
Acesse pelo celular ou reduza a janela para ~375px e confirme que o layout não quebra.
● Teclado virtual não deve bloquear o campo de texto
Segurança
✅ API key não está exposta
Inspecione o código-fonte da página (F12 → Sources) e confirme que a chave não aparece.
● A key deve estar somente no servidor/variável de ambiente
Segurança
✅ Acesso restrito a alunos
Tente acessar a URL sem estar logado na plataforma. Deve redirecionar para login.
● URL direta não deve abrir a ferramenta sem autenticação
Qualidade
✅ Respostas em português correto
Confirme que as respostas de todos os agentes chegam em português e sem erros de formatação.
● Textos com markdown (* ** #) devem ser exibidos corretamente
Performance
✅ Tempo de resposta aceitável
O agente deve responder em menos de 15 segundos. Acima disso, revise o timeout do servidor.
● Animação de "digitando" deve aparecer durante a espera
🎉
Todos os pontos validados? Sua ferramenta está pronta para publicar. Recomendamos fazer um soft launch com 5–10 alunos antes de abrir para toda a base — assim você coleta feedback real antes do lançamento oficial.
Dúvidas frequentes

Perguntas frequentes

As dúvidas mais comuns de quem está configurando a ferramenta pela primeira vez.

Qual é o custo por aluno para usar a ferramenta? +
O custo vem da API Anthropic. O modelo claude-sonnet custa aproximadamente $0,003 por 1.000 tokens de entrada e $0,015 por 1.000 tokens de saída. Uma conversa média de 5 trocas custa cerca de $0,05–0,10. Para 100 alunos ativos por mês usando moderadamente, espere gastar entre $20–60/mês na API.
Os alunos podem usar sem internet? +
Não. A ferramenta faz chamadas em tempo real para a API do Claude, então requer conexão ativa com a internet. O histórico da conversa também não é salvo localmente — ao fechar o browser, a sessão é perdida.
Posso personalizar os agentes com o nome e identidade visual do meu curso? +
Sim. No arquivo .jsx, os agentes estão definidos no array AGENTS no topo do arquivo. Você pode trocar nomes, emojis, cores e descrições. Para mudar o system prompt (o comportamento do agente), edite o campo "system" de cada objeto — isso define como o agente responde.
O histórico de conversas é salvo em algum lugar? +
Por padrão, não — o histórico existe apenas na sessão do browser. Se quiser salvar conversas para análise ou para o aluno retomar depois, seria necessário implementar um banco de dados e autenticação adicional. Para uma V1, a versão sem persistência já entrega valor suficiente.
Posso adicionar um 6º agente? +
Sim, é simples. No arquivo .jsx, adicione um novo objeto ao array AGENTS seguindo a mesma estrutura dos outros (id, emoji, name, color, accent, bg, description, placeholder, system). O card aparece automaticamente na tela inicial.
Funciona em Hotmart, Kiwify ou outras plataformas de infoproduto? +
Sim, via iframe. A maioria das plataformas de infoproduto permite incorporar HTML com iframe em páginas de módulos. Hospede o app no Vercel ou Netlify (grátis) e cole a tag iframe na sua plataforma.

Pronto para colocar no ar? 🚀

Siga os passos deste guia na ordem e você terá o Consultor Platinum funcionando em menos de 2 horas.