Vitreum Hub

Configurações

IA

Conectar Claude e OpenAI e escolher qual IA atende cada atividade.

Atualizado em 22/11/2026

A tela IA concentra os provedores de inteligência artificial do Hub e decide qual deles atende cada tarefa. Você conecta o Claude (Anthropic) e/ou a OpenAI e, no roteamento, escolhe por atividade quem responde — ou desliga a IA naquela função. Cada atividade usa um provedor por vez, nunca os dois ao mesmo tempo. Manter os dois conectados dá resiliência: se um ficar indisponível, você aponta a atividade para o outro.

Onde fica

Em Configurações, no menu lateral, abra IA. Antes essas chaves ficavam em Integrações — agora a IA tem tela própria.

Conectar o Claude (Anthropic)

  1. Abra o card Claude AI (Anthropic).
  2. Cole a API Key gerada em console.anthropic.com (deixe em branco para manter a atual).
  3. Escolha o Modelo e o Limite diário de mensagens.
  4. Clique em Validar e Salvar. O card passa a exibir Conectado, o modelo e o consumo do dia.

Conectar a OpenAI (ChatGPT)

  1. Abra o card OpenAI (ChatGPT).
  2. Cole a API Key gerada em platform.openai.com.
  3. Informe o Modelo — o ID exato da sua conta (ex.: gpt-4o).
  4. Clique em Validar e Salvar.

Roteamento por atividade

No card Roteamento de IA por atividade, escolha para cada função Claude, OpenAI ou Desligado:

  • Classificação de tickets — preenche tipo, serviço, categoria e resumo dos chamados que chegam.
  • Triagem de chamados — avalia a qualidade do chamado que chega e retém até ter detalhes suficientes.
  • Análise de reabertura por IA — decide se a resposta de um cliente a um chamado encerrado deve reabri-lo.
  • Chat de Tarefas (Kanban) — assistente que cria e gerencia cards em linguagem natural.
  • Chat de Projetos — assistente de IA dentro dos projetos.

Clique em Salvar roteamento. Escolher Desligado desativa a IA naquela atividade.

Triagem de Chamados

No card Triagem de Chamados você define se os chamados que chegam por e-mail/portal passam por uma checagem de qualidade antes de entrar na fila. O Estado tem três posições:

  • Desligado — nada muda; os chamados nascem normais.
  • Modo teste — só os endereços listados em E-mails de teste passam pela triagem; todo o resto segue normal. É a forma segura de experimentar antes de valer para todos.
  • Ligado — produção: vale para todas as empresas por padrão (cada empresa pode ser exceção no próprio cadastro).

Ainda no card, ajuste a Nota mínima para aprovar (de 0 a 100 — abaixo dela a IA pede detalhes ao cliente) e o Máximo de pedidos automáticos (quantas vezes a IA pode pedir mais informações antes de liberar o chamado ao agente). Clique em Salvar triagem.

A triagem exige que a atividade Triagem de chamados tenha um provedor (Claude ou OpenAI) escolhido no roteamento acima — sem isso, ela não roda mesmo ligada.

Quando a IA fica bloqueada

Quando uma chamada de IA falha — chave sem crédito, chave revogada, limite de requisições —, o card do provedor passa a mostrar o aviso IA bloqueada com a mensagem exata que a API devolveu, e a hora da última falha. Abra o card para ver o texto completo.

O aviso se desfaz sozinho: a cada 5 minutos o Hub re-testa o provedor que está bloqueado e, assim que a IA volta a responder (você recarregou crédito no console do provedor, trocou a chave), o aviso desaparece e as funções de IA voltam a rodar. Não é preciso clicar em nada. O card mostra Última verificação automática há X para você saber que a checagem está acontecendo.

Se quiser conferir na hora, sem esperar o próximo ciclo, clique em Validar e Salvar no card do provedor (deixando a API Key em branco, a chave atual é mantida). Provedor que está funcionando não é testado por conta própria — o teste só roda em quem está bloqueado, para não consumir crédito à toa.