Commerce AgentsBase de Conhecimento
Português
РусскийEnglishDeutschFrançaisEspañolPortuguêsItalianoNederlandsPolskiУкраїнськаČeštinaSlovenčinaSlovenščinaHrvatskiСрпскиБългарскиRomânăMagyarΕλληνικάSvenskaNorskDanskSuomiLatviešuLietuviųEestiTürkçeالعربيةעברית中文
Planos Para o Gabinete
Base de Conhecimento → Guia de Utilização

Erros e como resolvê-los

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.

6 de setembro de 2026

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#

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#

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 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.

Agente Demo