openthorDocumentação

Perguntas frequentes

As dúvidas que mais chegam ao suporte, respondidas em um parágrafo. Não achou a sua? Escreva para o suporte.

Dados e números

Os dados são ao vivo?

Quase — e a resposta sempre diz o quão frescos eles estão. O coletor lê o seu Winthor em ciclos de poucos minutos, e cada resposta da IA carrega a linha “Dados de N min atrás”. Se você precisa do minuto exato de agora, o lugar é o próprio Winthor; para gestão, minutos de atraso não mudam a decisão.

A IA pode alterar o meu Winthor?

Não. Todas as ferramentas são de leitura — não existe nenhuma ação de escrita, em nenhum plano. E o coletor instalado na sua rede só envia dados para fora; ele não recebe comandos de volta. Detalhes em Segurança e privacidade.

Por que o número de hoje mudou desde de manhã?

Porque a operação continua acontecendo: cancelamentos, notas retroativas e devoluções entram ao longo do dia e mexem nos totais de períodos recentes. Isso é o ERP vivo, não um defeito. Por isso, qualquer conferência contra uma rotina do Winthor deve ser feita no mesmo dia — comparar a resposta de hoje com um relatório de ontem garante diferença.

O número não bate com a rotina do Winthor. E agora?

Primeira pergunta: qual base cada lado está usando? Existem pelo menos três “líquidos” diferentes — líquido de devoluções (sem abater impostos), a venda líquida da margem realizada (abate também impostos retidos) e as bases fiscais das rotinas de faturamento. Cada resposta da IA declara a sua base; confira se a rotina usa a mesma. Segunda pergunta: a conferência foi no mesmo dia? Veja Faturado, vendido e líquido e As três margens.

Conectar e usar

Posso usar sem saber programar?

Sim — o caminho principal é justamente esse. Você conecta o seu assistente de IA (claude.ai, ChatGPT ou Claude Desktop) via MCP e pergunta em português; a IA escolhe a ferramenta certa. Não há código, planilha ou SQL no meio. Comece por Crie sua conta e Conectar o claude.ai.

Preciso do ChatGPT pago?

Sim. Conectores personalizados exigem o modo desenvolvedor, que não existe no ChatGPT Free — é preciso Plus ou superior. No claude.ai, o plano Free funciona, com limite de 1 conector personalizado. Passo a passo: ChatGPT e claude.ai.

Onde colo minha chave de API no claude.ai?

Em lugar nenhum — e isso confunde muita gente. No claude.ai, no ChatGPT e no Claude Desktop a conexão é “entrar e aprovar”: você cola a URL do OpenThor, faz login na sua conta e clica em Aprovar. Não existe campo para colar chave nesses aplicativos. A chave ot_live_ serve só para a API REST e o Claude Code — veja Claude Code e API REST.

Por que vejo menos ferramentas que meu colega?

Porque a lista de ferramentas é filtrada pela sua credencial, no servidor. Um administrador enxerga o catálogo inteiro; um membro com escopo (só Vendas, ou limitado à própria carteira) vê menos — e isso é o desenho funcionando, não um defeito. Quem define o escopo de cada pessoa é o administrador, na Equipe do painel.

Quantas perguntas posso fazer?

Depende do plano da sua organização — os limites são por requisições por minuto e linhas por mês, e valem para o conjunto de chaves e conexões da empresa. A tabela completa está em Limites e planos.

Chaves, equipe e acesso

Como dou acesso ao meu vendedor só à carteira dele?

No painel, em Configurações → Equipe: convide a pessoa com papel Membro ou Visualizador, marque os domínios que ela pode consultar e preencha “Limitar ao vendedor (rep)” com o código do RCA. O recorte é aplicado no servidor: quando ele conectar o próprio Claude ou ChatGPT, verá apenas os clientes e números da carteira dele — e nenhuma pergunta amplia isso.

Esqueci de copiar a chave de API. Como recupero?

Não recupera — o valor completo aparece uma única vez, na criação, e não fica guardado em lugar nenhum. O caminho é rápido: em Chaves & Uso, revogue a chave antiga e crie outra. A revogada fica no histórico, para auditoria.

Como cancelo o acesso de um app ou de uma pessoa?

Dois cortes, conforme o caso. Integração ou script com chave de API: revogue a chave em Chaves & Uso — as requisições passam a ser rejeitadas na hora. Pessoa conectada pelo próprio assistente (claude.ai/ChatGPT): em Configurações → Equipe, abra o membro e revogue a conexão na lista Apps conectados — ou remova o membro, o que também desconecta os apps dele automaticamente. Ajustar o escopo do membro vale para as próximas consultas.