Documentação GestorPro

Tudo que você precisa para começar a usar a plataforma de IA que gerencia sua operação de e-commerce.

O que é o GestorPro?

GestorPro é um escritório de agentes de IA que opera as contas de marketplace do vendedor: preço, promoção, estoque, catálogo, mídia paga e atendimento. Não é um painel para você preencher — é um time que trabalha sozinho dentro das regras que você define. Você fala com o Gestor; ele aciona os outros agentes e responde pelo resultado.

❌ Sistema tradicional

Abrir painel → Navegar menus → Exportar relatório → Interpretar dados → Decidir → Executar manualmente

✅ GestorPro

"Gestor, o que o time fez hoje?" → Resumo do dia, o que precisa da sua aprovação e o que já foi resolvido

Três garantias que valem em toda ação

Banda de margem — preço e promoção só se movem entre o piso e o teto que você definiu. Fora disso, vira pedido de aprovação.
Modo sombra — todo agente começa mostrando o que faria, sem escrever no marketplace. Você libera quando quiser.
Registro e desfazer — toda escrita guarda conta, valor antes, valor depois, a regra que disparou e quem aprovou, com botão de desfazer.

Como começar

1. Crie sua conta

Acesse gestorpro.tiops.com.br e crie a conta com e-mail e senha ou usando o Marketplace Connect. O Marketplace Connect já vem incluído: é a camada de integração com as APIs oficiais dos marketplaces (Mercado Livre, Shopee, Magalu, TikTok Shop, Shein, Amazon) e dos ERPs (Olist e Bling).

2. Ative a operação

Ao entrar pela primeira vez no Escritório, o time já vem montado: rotinas de cada agente, atendimento em modo aprovação, habilidades de fábrica instaladas e uma varredura completa das contas que gera o relatório inicial e o plano de trabalho dos próximos dias. Os agentes nascem em modo sombra. Preencha a banda de margem (piso e teto) em Configurações → Regras do negócio para liberar as escritas.

3. Fale com o Gestor

Na sala do Escritório, clique no Gestor e pergunte:

O que os agentes fizeram hoje?
Quais tarefas estão pendentes para eu aprovar?
Como está a saúde da operação?
Quanto vendemos hoje na Shopee?

O Gestor decide se responde direto, aciona um agente ou abre uma reunião do time. Só ele fala com você — os outros agentes trabalham e registram.

💡 Versão anterior: ao entrar você escolhe entre o Escritório de agentes e o painel anterior. Chave, contas e plano são os mesmos nos dois.

Os nove agentes

Cada agente tem função definida, escala de trabalho e regra de margem. Todos trabalham em todas as contas conectadas ao mesmo tempo.

Agente	Responsabilidade	O que entrega
Gestor	Coordena o time, cobra cada área, audita quem rodou	Reunião das 9h, relatório do dia, fila de aprovação resumida
Guardião de margem	Preço, promoções e subsídio dentro da banda	Margem real por anúncio (comissão, taxa fixa, frete, imposto, custo); recusa desconto que fura o piso
Comprador de mídia	Campanhas e verba no Mercado Livre e na Shopee	ACoS, ROAS, TACoS, o que gasta sem vender e quanto dá para economizar
Curador de catálogo	Ficha técnica, títulos, imagens e disputa de catálogo	Anúncio esfriando e o que falta para a nota subir
Atendente	Perguntas de pré-venda e pós-venda	Responde sozinho ou deixa a resposta pronta para aprovação; reclamações, mediações, cancelamentos e devoluções
Analista de estoque	Cobertura pela velocidade real de venda	Ruptura antes do prazo de reposição e capital parado
Analista de mercado	Categoria, tendências e concorrentes	Mais vendidos, termos em alta que os títulos não cobrem, nota de qualidade, concorrentes vigiados por link
Analista financeiro	Conciliação com o ERP (Bling / Olist) e nota fiscal	Pedido pago → pedido no ERP → NF-e; o que falta faturar; conferência de recebimentos. Nota só sai pela fila de aprovação
Agente de comunicação	Avisa você e fala com o cliente	E-mail e WhatsApp por operação: fila de aprovação, pergunta nova, ruptura, pedido sem nota, falha de agente e o resumo do dia

Quem precisa aprovar o quê

Dentro da banda — o agente executa e registra. Você vê no feed e pode desfazer.
Fora da banda ou sem regra — vira item na fila de aprovação, com antes, depois e motivo. O Gestor resume a fila quando você pedir.
Modo sombra — nada é escrito; o agente só mostra o que faria.

O que você encontra no Escritório

Sala — os agentes trabalhando, feed ao vivo do que cada um fez, fila de aprovação e conversa com o Gestor
Organograma — Gestor no topo, cada agente com habilidades, tarefas do dia e produção do mês
Anúncios e catálogo — saúde de cada anúncio, margem por unidade, esfriados, inertes e sem custo cadastrado
Promoções — o que o marketplace subsidia, o que sai do seu bolso e o que queima margem
Estoque — ruptura, reposição, giro e estoque parado com valor em reais
Campanhas — ML e Shopee lado a lado, com sugestão e economia estimada; pausar, retomar e mudar verba pela tela
Pós-venda — reclamações, mediações, cancelamentos e devoluções, abertas e encerradas, com o detalhe de cada caso
Mercado e concorrentes — ranking da categoria, termos em alta e concorrentes vigiados por link
Criativo — até 20 imagens por anúncio, na ordem que converte, com a principal em fundo branco. Usa a sua própria chave da OpenAI
Financeiro — faturamento, taxas, imposto, custos fixos e margem líquida real
Conciliação ERP — qual conta do Bling ou do Olist concilia cada loja, o que está automatizado (importar pedido, emitir NF-e, baixar estoque, conferir recebimentos) e o cruzamento pedido → pedido no ERP → nota. Emissão de nota sempre passa pela fila de aprovação
Notificações — uma linha por operação do time, com interruptor de e-mail e de WhatsApp, horário de silêncio e resumo diário
Configurações — conta, regras do negócio, usuários com privilégio menor, Atendente, imagens, conector e preferências

Habilidades (Skills)

Habilidades são rotinas que os agentes executam sem depender de um modelo de linguagem: mais rápidas, previsíveis e auditáveis. Existem três origens:

De fábrica — vêm prontas com a conta (ruptura de estoque, margem por anúncio, campanhas que gastam sem vender, perguntas sem resposta, promoções subsidiadas, entre outras)
Aprendidas — quando um pedido seu se repete, o time transforma em habilidade e passa a rodar sozinho
Ensinadas — você descreve uma tarefa em português ("emitir a nota no Bling quando o pedido for pago"), o sistema monta a habilidade, o Gestor audita e ela entra na escala. Se já existir algo parecido, ele avisa em vez de duplicar

Toda habilidade pode ser baixada como SKILL.md e usada direto no seu Claude ou em outro assistente. A habilidade Configurar meu Claude vem de fábrica e ensina o assistente a operar o seu escritório.

Rotinas e escala de trabalho

Cada agente tem horários fixos. Antes de rodar, ele verifica se há trabalho; se não houver, registra a checagem e segue. Você acompanha no Organograma e no detalhe de cada agente: última checagem, resultado, próximas execuções.

"Gestor, monte a escala do time"
"Atendente, responda as perguntas pendentes todo dia às 8h"
"Me avise se algum produto ficar com menos de 10 unidades"

❌ Sem automação

Você precisa lembrar de verificar todo dia, abrir o painel, analisar manualmente

✅ Com o time

Os agentes verificam sozinhos e só te chamam quando precisa de decisão humana

Regras do negócio

Em Configurações → Regras do negócio você define o que o time pode fazer sem perguntar:

Piso e teto de margem — a banda dentro da qual preço e promoção se movem
Custos — custo do produto, imposto e custos fixos para a margem real
Atendente — responde sozinho, deixa para aprovação ou só sugere
Modo sombra por agente — libere um agente de cada vez quando se sentir seguro

Conector para o seu assistente (MCP)

O mesmo time trabalha dentro do Claude, ChatGPT ou qualquer cliente MCP, com as suas contas e as suas regras. Duas formas de conectar:

Sem digitar chave (OAuth): adicione o conector pela URL https://gestorpro.tiops.com.br/api/mcp/oauth e faça login quando o assistente pedir.

Com chave:

{
  "mcpServers": {
    "gestorpro": {
      "url": "https://gestorpro.tiops.com.br/mcp",
      "headers": {
        "x-api-key": "sua_chave_aqui"
      }
    }
  }
}

Sua chave está em: Escritório → Configurações → Conector.

💡 Dica: escrita em marketplace feita pelo assistente passa pela mesma banda de margem e pela mesma fila de aprovação do Escritório.

Multi-conta e multi-marketplace

Várias lojas do mesmo marketplace ao mesmo tempo. Cada consulta e cada escrita fica presa à conta certa; o consolidado soma sem misturar. O seletor de contas fica no topo de todas as telas. Na ativação você escolhe quais lojas o time opera, e esse número entra no cálculo do preço.

Plano

Existe um plano só, com o time completo: o Gestor e os nove agentes, a fila de aprovação, o registro com desfazer, o conector para o seu assistente, o Criativo, a conciliação com ERP e os avisos por e-mail e WhatsApp. Não há versão reduzida.

O preço é calculado pelo tamanho do que o time vai operar:

Faturamento dos últimos 90 dias, lido direto do marketplace
Tamanho do catálogo — cada anúncio é lido pelos agentes em toda ronda de preço, margem e catálogo
Lojas que você escolhe colocar sob o time

Ao conectar suas lojas, o próprio sistema mede tudo isso e mostra o valor antes de qualquer cobrança. Na tela você marca e desmarca as lojas e vê o preço mudar na hora. Depois de ativado, incluir ou tirar loja é imediato, com o ajuste entrando na fatura seguinte — nunca uma cobrança avulsa no meio do mês.

A revisão é mensal, com os 90 dias anteriores. Quem cresce tem 30 dias no preço antigo; quem diminui desce sozinho, sem precisar pedir. 7 dias grátis, sem fidelidade.

Ver tudo o que o time faz →

Perguntas frequentes

Preciso instalar algo?

Não. O GestorPro funciona 100% na nuvem. Basta criar a conta e conectar as lojas. O conector para o seu assistente é opcional.

Quais marketplaces funcionam?

Mercado Livre, Shopee, Magalu, TikTok Shop, Shein e Amazon, além dos ERPs Olist e Bling, via Marketplace Connect.

Os agentes podem mexer na minha loja sem eu saber?

Não. Todo agente começa em modo sombra. Quando você libera, ele só age dentro da banda de margem que você definiu; fora dela, pede aprovação. Toda escrita fica registrada e pode ser desfeita.

É seguro?

Seus dados ficam isolados por conta e nenhum dado é compartilhado com outros usuários. A geração de imagens usa a sua própria chave da OpenAI, que fica guardada na sua conta.

Posso usar sem o Claude?

Sim. O Escritório é completo por si só. O conector existe para quem prefere comandar o time de dentro do próprio assistente.

Consigo dar acesso para a minha equipe?

Sim. Em Configurações → Usuários você cria acessos com privilégio menor (somente leitura ou operação sem alterar regras).

O que acontece se eu cancelar?

Seus dados ficam disponíveis por 30 dias. Após isso, são removidos. Não há fidelidade.