Da instalação ao primeiro aluno — tudo que você precisa para colocar os 5 especialistas de IA funcionando dentro da sua plataforma.
Uma ferramenta interativa com 5 especialistas de IA que conversam individualmente com seus alunos, guiando cada etapa da jornada de vendas no Mercado Livre.
Cada agente foi treinado para uma fase específica da jornada do vendedor. O aluno usa cada um no momento certo.
O que mostrar no onboarding — como o aluno aprende a usar a ferramenta da forma certa desde o primeiro acesso.
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 tela inicial mostra os 5 especialistas em cards. O aluno deve escolher com base em onde está na jornada:
A qualidade da resposta depende da qualidade da pergunta. Ensine seus alunos a perguntar com contexto:
Oriente os alunos a incluir sempre: nicho ou produto de interesse, capital disponível, experiência atual e objetivo principal.
Dentro de cada agente, o histórico da conversa é mantido durante a sessão. O aluno pode fazer perguntas de acompanhamento naturalmente:
As respostas dos agentes são para uso imediato. Oriente seus alunos a:
Você tem o arquivo consultor-platinum.jsx — veja como colocar ele no ar.
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):
# 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:
// 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:
<iframe src="https://SEU-APP.vercel.app" width="100%" height="700px" style="border:none;border-radius:16px;" allow="clipboard-write" ></iframe>
Importe o componente diretamente no seu projeto:
import ConsultorPlatinum from '../components/ConsultorPlatinum'; export default function ConsultorPage() { return ( <ProtectedRoute> <ConsultorPlatinum /> </ProtectedRoute> ); }
claude-sonnet-4-20250514. Você pode trocar por um modelo mais barato se quiser reduzir custo.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. |
error no Response. O erro da API sempre vem com uma mensagem clara.Valide cada ponto antes de liberar o acesso para seus alunos. Esse checklist garante que tudo vai funcionar na prática.
As dúvidas mais comuns de quem está configurando a ferramenta pela primeira vez.
Siga os passos deste guia na ordem e você terá o Consultor Platinum funcionando em menos de 2 horas.