---
title: Erros e como resolvê-los
description: Mensagens de erro exatas apresentadas na plataforma e a solução para cada uma delas: chaves Claude e Gemini, Instagram, TikTok, YouTube, Telegram, pagamento, plano e anexos.
section: guide
keywords: erro, não funciona, problemas, chave rejeitada, chave inválida, Instagram não conecta, TikTok não funciona, agente AI não responde, resolução de problemas, solucionar problemas, Claude erro, Gemini erro, pagamento falhou, plano não funciona
updated: 2026-09-06
---
Aqui estão as mensagens que pode ver na sua área pessoal, com a formulação exata — para que as possa procurar facilmente na página. Se o seu caso não estiver aqui, escreva-nos no Telegram, e nós adicionamos.

## O agente não responde

### «O assistente ainda não está ligado»

Visível na pré-visualização e na página do agente. Significa uma de duas coisas: a chave Anthropic não foi definida ou o plano não está ativo.

O que fazer: abra «Definições» → «Chaves e Modelos» e verifique o cartão Anthropic. Se disser «não definida», introduza a sua chave ou ative o plano «Tudo Incluído» — as nossas chaves funcionam com ele.

### «Chave Anthropic não definida: adicione-a em Definições»

O mesmo, mas ao iniciar a análise de fontes. A análise não começará enquanto a chave ou o plano não estiverem disponíveis.

### «Para iniciar isto, ative o plano: os primeiros 7 dias são grátis»

A área pessoal está aberta sem um plano, mas as ações que custam dinheiro estão bloqueadas: análise de fontes, respostas do agente, ativação do widget. Clique no botão na janela da oferta — após a ativação, a ação interrompida continuará automaticamente.

### «O agente fez uma pausa: o limite de respostas foi atingido neste plano»

Isto é o que o cliente vê. O limite é mensal, e o saldo restante é visível na página principal da área pessoal. Há duas soluções: esperar pelo próximo mês ou mudar para um plano com um limite maior. No «Ваш ИИ», a restrição é praticamente levantada.

## Chaves Claude e Gemini

### «Este é um token OAuth Claude Code / de subscrição, não uma chave API»

O erro mais comum. O token da subscrição Claude e a chave API são coisas diferentes. Precisa da chave de console.anthropic.com → Settings → API keys → Create key, que começa com `sk-ant-api`.

### «Esta é uma chave API de Administrador, não pode invocar modelos»

A chave foi criada na secção Admin keys. Crie uma chave normal em API keys.

### «Anthropic rejeitou a chave (401)»

A chave não foi copiada na íntegra, foi revogada ou pertence a outra conta. Copie-a novamente, na íntegra, sem espaços nas extremidades.

### «A chave não tem permissões para modelos (403)»

As permissões da chave são limitadas ou o pagamento não foi confirmado na conta. Verifique a secção Billing na consola Anthropic.

### «A chave está correta, mas não há fundos na conta Anthropic»

Carregue o saldo ou associe um cartão na consola Anthropic. Não pagamos pelos tokens no plano «Ваш ИИ» — o custo é diretamente seu.

### «Chave aceite, mas o modelo não está disponível para esta conta (404)»

Selecione outro modelo no campo abaixo. A lista de modelos é carregada com base na sua chave.

### «Não parece uma chave Gemini: começa com AIza»

Foi introduzida a chave errada no campo ou o navegador preencheu uma palavra-passe guardada. A chave é obtida em aistudio.google.com/api-keys.

### «Google rejeitou a chave»

A chave foi revogada, não foi criada no AI Studio ou o acesso à API Gemini não está ativado para o projeto.

## Instagram

### «Instagram não está ligado ou a sessão expirou»

A sessão tem uma duração limitada, e o Instagram termina-a em caso de atividade suspeita. Inicie sessão novamente na secção de fontes.

### «Instagram pede para confirmar o início de sessão: introduza o código»

Comportamento normal ao iniciar sessão pela primeira vez a partir do servidor. O campo para o código aparece diretamente na área pessoal, e o código é enviado por SMS, e-mail ou para a aplicação de autenticação. Introduza-o no prazo de um minuto.

Se o código não chegar ou o início de sessão continuar a falhar, especifique o seu proxy no campo «Proxy» — assim, o início de sessão ocorrerá a partir da região habitual da conta.

### «O gateway do Instagram está indisponível, tente novamente mais tarde»

Um problema temporário do nosso lado ou do lado do Instagram. Geralmente resolve-se em poucos minutos; se persistir por mais de uma hora, contacte-nos.

### «Não há publicações no perfil»

O perfil está fechado, vazio ou o Instagram não forneceu o feed. Verifique se a conta é pública e se tem publicações.

## TikTok

### «Indique o nome do perfil TikTok: @perfil ou link»

Campo vazio ou endereço não reconhecido. Tanto `@shop`, como `shop`, ou o link completo para o perfil são aceites.

### «Não foi possível ler o perfil»

O perfil está fechado, foi renomeado ou o TikTok não está a fornecer a lista temporariamente. Verifique o endereço, abra o perfil no navegador sem iniciar sessão — se não abrir, o agente também não o verá.

### «O perfil não tem vídeos públicos, o perfil está fechado ou o TikTok não está a fornecer a lista temporariamente»

Na maioria das vezes, é um bloqueio temporário de entrega. Tente novamente daqui a dez a quinze minutos.

### «Não há nada mais antigo que o N-ésimo vídeo — tudo já foi analisado»

Não é um erro, mas uma mensagem de fim de arquivo: chegou ao vídeo mais antigo.

## YouTube

### «Indique o YouTube: @canal, link para o canal, playlist ou vídeo»

Campo vazio ou endereço não reconhecido. Todas as formas funcionam: `@channel`, link para o canal, playlist, vídeo individual.

### «Vídeos longos ignorados (mais de 45 min)»

Vídeos com mais de quarenta e cinco minutos não são analisados: o custo da análise não compensa. O relatório mostra quantos foram ignorados.

### «Limite de análise por execução esgotado, vídeos sem conteúdo: N»

Uma execução não dura mais de três horas. O restante será processado se iniciar a análise novamente mais tarde.

### «Vídeos não transcritos: chave Gemini não definida»

A fala e as legendas nos vídeos são lidas pelo Gemini. Adicione a sua chave ou ative um plano onde as nossas são usadas.

## Telegram

### «Canal não encontrado ou não tem pré-visualização web (canal privado)»

O agente lê apenas canais públicos. Canais privados e grupos não estão disponíveis.

### «O canal não tem publicações com texto ou multimédia»

O canal está vazio ou contém apenas reencaminhamentos dos quais nada pode ser recolhido.

## Pagamento e Plano

### «Não tem uma subscrição Stripe — ative um plano na página de planos»

A ação requer uma subscrição ativa: mudança entre planos, código promocional, cancelamento. Ative o plano e tente novamente.

### «Primeiro, guarde as chaves Claude e Gemini»

A transição para o plano «Ваш ИИ» só é possível quando ambas as chaves estiverem guardadas e verificadas.

### «Preço do plano não encontrado no Stripe»

Um erro raro do nosso lado: os preços não estão sincronizados no Stripe. Contacte-nos, é corrigido em um minuto.

### «Este código promocional não existe ou já não é válido»

Verifique o layout do teclado e o uso de maiúsculas/minúsculas. Os códigos promocionais podem ter um prazo e um número de ativações limitados.

### «A verificação falhou» para a chave Stripe ou Monobank

A chave não foi copiada na íntegra, foi obtida do modo de teste em vez do modo de produção, ou foi revogada. Para o Stripe, é necessária uma chave secreta do tipo `sk_live_`; para o Monobank, é necessário o token de aquisição da área pessoal.

## Anexos do Comprador

### «Ficheiro maior que 20 MB — envie um mais curto»

Limite para um anexo. Os vídeos devem ser cortados ou ter a sua qualidade reduzida.

### «Este tipo de ficheiro não é suportado: são necessárias fotos, vídeos ou áudio»

O agente não aceita documentos, arquivos ou folhas de cálculo.

### «O limite de anexos para este plano foi atingido»

Cada anexo é contado como uma publicação analisada. O saldo restante é visível na página principal do painel de controlo.

## Análise Interrompida

### «A análise foi interrompida (o servidor foi reiniciado). Execute novamente»

Lançámos uma atualização durante o processo de análise. O progresso é guardado: uma nova execução continuará do ponto onde parou, e as publicações já analisadas não serão contadas novamente.

## Se Nada Ajudou

Escreva [no Telegram](https://t.me/GuruAppSheet) e inclua duas coisas: o texto exato da mensagem e a hora em que apareceu. Com esta informação, encontramos a causa nos registos em poucos minutos.

## Perguntas Frequentes

### Porque é que o agente responde «vou confirmar com o proprietário»

Isto significa que as suas condições e catálogo não contêm dados para uma resposta. Não é um erro, mas uma proteção: o agente não inventa preços ou prazos. Adicione a informação em falta às condições da loja, e a resposta aparecerá.

### A análise demora muito, isto é normal

Cinquenta publicações — três a seis minutos, os vídeos demoram mais. Se o progresso não se mover por mais de vinte minutos, reinicie: o que foi analisado não será perdido.

### Porque é que no catálogo apareceram avaliações e anúncios em vez de produtos

Isto acontece ao analisar publicações. Elimine os cartões desnecessários na secção «Catálogo» — uma nova análise não os trará de volta. Uma auditoria do catálogo através do agente do proprietário também ajuda.

### Onde foram parar os meus dados após o cancelamento da subscrição

São armazenados por 15 dias após o encerramento do acesso, depois são eliminados. Antes deste período, a subscrição pode ser reativada, e tudo voltará ao seu lugar.
