Esta é uma tradução automática do documento original em inglês. Em caso de conflito entre esta tradução e a versão original em inglês, a versão em inglês prevalecerá. Ler a versão original em inglês

Solução de problemas

Algo não está funcionando? Comece por aqui.

Problemas com a Extensão do Navegador

A extensão não carrega

  1. Certifique-se de que a instalou pela Chrome Web Store (não uma versão de desenvolvimento)
  2. Vá para chrome://extensions e procure por mensagens de erro
  3. Tente desativar a extensão e ativá-la novamente
  4. Reinicie o Chrome completamente se isso não funcionar

O painel lateral não abre

  1. Clique no ícone do Caiioo na sua barra de ferramentas (canto superior direito)
  2. Certifique-se de que está em uma página da web comum (algumas páginas como as configurações do Chrome não permitem extensões)
  3. Vá para chrome://extensions, encontre o Caiioo e clique em "Recarregar"
  4. Tente clicar no ícone novamente

Barra lateral em branco ou quebrada após uma atualização

  • Limpe o cache do navegador e recarregue a extensão
  • Feche e reabra o painel lateral
  • Se nada ajudar, desative e reative a extensão

Problemas de Login

Não consigo entrar com Google / Apple / Microsoft

  1. Certifique-se de que seu navegador não está bloqueando pop-ups — o OAuth requer uma janela pop-up
  2. No iOS, se o login do Google travar, tente a opção "Entrar com a Apple"
  3. Limpe os cookies de caiioo.ai e tente novamente
  4. Se você alterou senhas recentemente, saia do provedor no seu navegador primeiro e tente de novo

Travado na tela de login após entrar

  • Aguarde alguns segundos — o app está buscando seu perfil
  • Se continuar travado, feche e abra o app (ou recarregue a extensão)
  • Certifique-se de que o relógio do dispositivo está correto — a validação do token OAuth falha se o relógio estiver errado

Problemas com Chave de API

A chave de API não está funcionando

  1. Copie a chave novamente do site do provedor e cole com atenção (sem espaços antes ou depois)
  2. Verifique se sua conta ainda tem créditos disponíveis
  3. Tente gerar uma nova chave e usá-la em vez da anterior
  4. Verifique se o formato da chave está correto — chaves do OpenRouter começam com sk-or-

Não consigo encontrar minha chave de API

  • OpenRouter: openrouter.ai/keys
  • Ollama: não precisa de chave — confirme apenas se o servidor local está em execução em http://localhost:11434

Consulte Provedores de IA e Chaves de API para mais detalhes.

Mensagem de "Limite de taxa atingido" ou "sobrecarregado" no modelo escolhido

Isso ocorre no lado do provedor, não na sua chave. Quando um modelo escolhido por você atinge o limite de taxa, fica sobrecarregado ou indisponível, o Caiioo indica o nome do modelo e explica o ocorrido em vez de mudar silenciosamente para outro. Aguarde um minuto e envie novamente, ou escolha outro modelo manualmente. (Quando o Caiioo seleciona o modelo automaticamente, ele faz a troca por conta própria — essa é a diferença.)

Um modelo gratuito recusa minhas solicitações com frequência

Certos modelos gratuitos do OpenRouter rejeitam solicitações vindas de aplicativos que não constam em sua própria lista de permissões. O Caiioo memoriza os modelos que recusaram, sinaliza-os no seletor e os ignora em tentativas de contingência — verificando novamente mais tarde para o caso de o bloqueio ter sido suspenso. Enquanto isso, selecione outro modelo.

Integração Google (Nível Pro)

Não é possível ligar ao Google

  1. Aceda a Configurações > Conectores
  2. Clique em "Ligar Conta Google"
  3. Certifique-se de que aprova todas as permissões solicitadas
  4. Verifique se a sua conta aparece como ligada
  5. Se ainda assim não funcionar, desligue e tente novamente

As ferramentas Google não estão a funcionar

  1. Verifique se o Google está ligado (Configurações > Conectores)
  2. Tente atualizar a sua ligação Google (botão "Voltar a ligar ao Google")
  3. Certifique-se de que a ferramenta específica está ativada (Configurações > Ferramentas e Integrações > Configuração de Ferramentas)

Problemas com a Sincronização Privada

A sincronização não está funcionando

  1. Verifique se a sincronização privada está de fato ativada (Configurações > Conectividade > Sincronização Privada)
  2. Verifique se sua conta Google está conectada
  3. Certifique-se de que há espaço de armazenamento livre no seu Google Drive
  4. Clique em "Reconectar Google" se o token tiver expirado
  5. Tente desativar e reativar a sincronização

Os dados não sincronizaram entre dispositivos

  • A sincronização privada funciona em segundo plano — aguarde alguns segundos
  • Confira se você está usando a mesma conta Google em todos os aparelhos
  • Certifique-se de que a sincronização privada também está ativada no outro dispositivo
  • Atualize manualmente desativando e reativando a sincronização

Problemas de Acesso Remoto pelo Navegador

A página relay.caiioo.ai/app não se liga

  • No seu dispositivo principal, certifique-se de que o Private Relay está ativado (Configurações > Conectividade > Dispositivos e Retransmissão) e indica "Ligado"
  • Inicie sessão no navegador remoto com a mesma conta do seu dispositivo principal — a retransmissão apenas alcança a sua própria instância
  • A extensão ou aplicação de computador do seu dispositivo principal tem de estar em execução e online para que o navegador remoto a controle
  • Numa abertura a frio, a página pode apresentar um indicador de "a ligar" durante alguns segundos enquanto estabelece a sessão encriptada — aguarde que termine antes de recarregar

Sessão iniciada, mas a página remota fica bloqueada no ecrã de início de sessão

  • Dê-lhe alguns segundos — a aplicação só arranca assim que a sessão encriptada for estabelecida
  • Se continuar bloqueada, confirme se o seu dispositivo principal está online e com o Private Relay ligado; depois, recarregue a página

Problemas de desempenho

As respostas estão lentas

  1. Verifique se o provedor de IA está com problemas (verifique a página de status deles)
  2. Tente usar um modelo mais rápido e barato (como Gemini Flash ou Mistral)
  3. Arquive conversas antigas se você tiver centenas delas
  4. Verifique sua conexão com a internet

As conversas estão demorando muito

  • A IA está trabalhando—procure pelo indicador de carregamento
  • Alguns modelos são mais lentos que outros. Mude para um mais rápido se estiver com pressa
  • Se estiver demorando mais que alguns minutos, a IA pode estar travada. Clique em Parar e tente novamente

Subscrição e Faturação

Não consegue ver "Gerir Plano"

  • Certifique-se de que tem sessão iniciada com a conta associada à subscrição
  • Se subscreveu no iOS, o botão Gerir Plano reencaminha para as definições de subscrição da Apple
  • Se subscreveu na web, reencaminha para o portal de faturação do Stripe
  • Termine sessão e inicie-a novamente para atualizar o estado da sua subscrição

"Gerir Plano" abre o sítio errado

  • As compras dentro da aplicação no iOS são geridas em Definições > ID Apple > Subscrições — e não em caiioo.ai/account
  • As subscrições do Stripe são geridas através da ligação do portal em Definições > Conta > Perfil de Utilizador ou em caiioo.ai/account
  • O Caiioo reencaminha automaticamente com base no local onde efetuou a subscrição — isto é o comportamento esperado

Atualizou mas continua no nível antigo

  • As atualizações do Stripe demoram um minuto a propagar-se — recarregue a aplicação
  • As compras in-app da Apple podem demorar até 24 horas a verificar. Toque em "Restaurar Compras" em Definições > Conta > Perfil de Utilizador para acelerar o processo
  • Se já tiver uma subscrição noutra plataforma, o botão Subscritor indicará para a gerir lá em vez disso

Outros Problemas

Ecrã em branco na aplicação de computador ou móvel

  • Reinicie a aplicação completamente
  • Verifique se está ligado à internet
  • Tente limpar a cache da aplicação (varia consoante a plataforma)
  • Atualize para a versão mais recente

As ferramentas não estão a funcionar

  1. Aceda a Configurações > Ferramentas e Integrações > Configuração de Ferramentas e confirme se a ferramenta está ativada
  2. Algumas ferramentas requerem permissões ou configuração (como uma conta Google ligada para ferramentas Google)
  3. Se vir um erro a indicar "requer permissão", volte a ligar o fornecedor em Configurações > Conectores e volte a aprovar os âmbitos

A extensão não consegue ligar à aplicação de computador

  • Primeiro, verifique se Ativar Caiioo Bridge está ligado (Configurações > Conectividade > Dispositivos e Retransmissão) — está desativado por predefinição, e enquanto estiver desativado a extensão nunca se liga à aplicação de computador e os controlos de Voltar a ligar/porta ficam a cinzento
  • Se estiver a usar tanto a extensão de navegador como a aplicação de computador, a extensão liga-se à aplicação de computador através de um WebSocket local (ponte de capacidades, não sincronização)
  • Reinicie a aplicação de computador e recarregue a extensão
  • Certifique-se de que nenhuma outra cópia da aplicação de computador está em execução — múltiplas instâncias entram em conflito

Aviso de "Navegador não ligado" no macOS mesmo com um navegador aberto

  • O Caiioo reconhece agora o Chrome, Safari, Edge e Firefox — o aviso desaparece assim que qualquer um deles se ligar
  • O Safari liga-se através de um canal diferente e pode ficar brevemente inativo quando não é a aplicação em primeiro plano; mantém-se ligado e o Caiioo acorda-o automaticamente quando um comando precisa dele
  • Se o aviso persistir, traga o navegador para primeiro plano uma vez e tente de novo

Os anexos de mensagens não carregam

  • Verifique se o formato do ficheiro é suportado (PDF, imagens, documentos do Word, folhas de cálculo, apresentações)
  • Tente um ficheiro mais pequeno
  • Certifique-se de que tem ligação à internet

Obter ajuda

  • Respostas rápidas: Clique no ícone ? no cabeçalho
  • Definições e resolução de problemas: Clique no ícone de engrenagem
  • Este guia: Definições > Ajuda > Documentação e Legal
  • Deixe o Caiioo criar um relatório de erro por si: Peça-lhe para relatar um problema e ele abre o formulário de suporte integrado pré-preenchido com uma descrição detalhada para rever e enviar. Diga "apenas envia" e — com a sua aprovação — o ticket é submetido diretamente, anexando os detalhes técnicos da conversa para que a equipa possa reproduzir o que viu.

Veja também

This guide is maintained by the Caiioo team using Slate, our built-in editor.