Resolução de problemas
Última atualização:
Para operadores de oficina e gestores técnicos. Anterior:
Encontre a mensagem que vê no ecrã e siga os passos na tabela relevante. As mensagens são guardadas em inglês para que as possas associar à interface.
Verificações rápidas
Antes de resolver um problema específico:
- Verifique se está a operar na oficina certa.
- Abrir ** PrestaKick Conexão → IA** no módulo.
- Verifique o estado do Connected.
- Se acabou de mudar a configuração, selecione Save configuration.
- Abra Cron Jobs → Logs e verifique a última corrida.
- No Dashboard, verifique o estado do Healthy, Degraded, Offline ou Unknown.
- Tente novamente com uma janela incógnita para excluir dados antigos no navegador.
Erro de ligação ao módulo
| Mensagem ou sintoma | Causa comum | O que fazer |
|---|---|---|
| API connection required | Módulo que não se liga ou falha em chamar a API | Abrir Connection, voltar a ligar e selecionar Save configuration |
| Not connected | OAuth incompleto ou desligado | Escolha Connect with PrestaKick, escolha a loja certa e confirme |
| Connected mas Features ainda reporta um erro | Definições não guardadas, URL incorreto ou ausência de acesso à Internet de saída | Guarda as definições, verifica https://api.prestakick.com e depois usa Test connection |
| Connection failed / Connection test failed | Informação em falta ou APIs inacessíveis | Verifique Module Secret, API Base URL, Shop ID e conectividade de rede |
| Invalid API Base URL format |
Não submeta Segredos de Módulo ou Chaves API em pedidos de suporte.
OAuth Erro
| Mensagem | O que fazer |
|---|---|
| Invalid connection request | Fecha a página atual e começa novamente a partir de Connect with PrestaKick no módulo |
| OAuth connection token has expired | Recomeçar a partir do módulo; O link antigo expirou |
| OAuth connection token has already been used | Não reabra o link antigo; iniciar um novo fluxo de ligação |
| Shop is already connected to another PrestaShop URL | Verifique URLs antigos e novos antes de escolher religar |
| Only the shop owner can connect this shop | Inicie sessão com uma conta de proprietário ou peça ao proprietário para o fazer |
| No unconnected shops | Crie uma loja ou volte a ligar uma loja existente, se for isso que pretende fazer |
Abra apenas um processo OAuth de cada vez.
Módulo offline ou sincronização carece de dados
| Fenómeno | Como lidar |
|---|---|
| Relatórios de módulos Offline | Verifica se o módulo está ativado, o cron está a correr e o servidor tem acesso à Internet |
| Relatórios de módulos Degraded | Abrir Cron Jobs → Logs, verificar erros repetidos e a fila, depois monitorizar se o estado recupera |
| Os relatos do módulo Unknown após uma nova ligação | Espera uns minutos e executa o cron uma vez |
| Dados antigos ou em falta do Dashboard | Verifica o estado do módulo e abre a Data sync para pedir a resincronização |
| Manual sync is rate limited to once per hour per entity type | Espere que o limite de tempo expire antes de voltar a executar o tipo de dado |
| Relatórios de trabalho de sincronização Failed | Abra os detalhes, resolva a causa e depois execute o trabalho novamente |
| Unauthorized: Invalid or missing API Key | Verifique a Chave da API da Loja, selecione Save configuration ou volte a ligar usando o OAuth |
| Unauthorized: invalid or missing cron token. |
Widget não aparece
Verifique por esta ordem:
- Show Widget ativado, ou o IP de teste está na Preview IPs.
- Selecionaste Save configuration.
- O nome de domínio atual está na Allowed storefront domains.
- O módulo não está Offline estado.
- O navegador não está a usar JavaScript antigo; Experimenta uma atualização forçada ou uma janela de incógnito.
- Se o teste for por telefone, Show on Mobile está ligado.
| Mensagem | O que fazer |
|---|---|
| Widget origin is not allowed for this shop | O proprietário adiciona o nome de domínio correto em Definições → Domínios & Acesso e depois seleciona Save rules |
| Invalid widget key | Reconecte o OAuth ou atualize uma nova Chave de Widget na sua configuração atual |
| Failed to save widget configuration | Verifique a ligação, permissões e limites do plano, depois guarde novamente |
| Upgrade to Starter or higher to allow image uploads | Atualiza para Starter ou superior, ou desliga Allow image uploads |
Chat e assistentes de IA
| Mensagem ou sintoma | O que fazer |
|---|---|
| O chat abre-se mas a IA não responde | Verifique quotas, estado dos módulos, dados sincronizados e notificações de serviço |
| You are sending messages too fast... | Espera alguns segundos e depois volta a submeter |
| AI credits have been exhausted | Os proprietários compram mais créditos, atualizam o plano ou aguardam um novo limite |
| Too many requests. Please try again later | Espera e tenta outra vez; Se acontecer frequentemente com tráfego real, contacte o suporte |
| Service is temporarily unavailable | Tenta novamente mais tarde; os agentes podem assumir as conversas se a Caixa de Entrada de Chat ainda estiver ativa |
| O assistente dá uma resposta genérica | Verifique descrições de produtos, páginas de políticas, sincronização e instruções do Assistente |
| Message could not be sent. | Verifica a ligação e tenta novamente |
| Could not send the image. | Verifique o formato da imagem, o tamanho do ficheiro e se o plano permite o carregamento de imagens |
Login e segurança
| Mensagem | O que fazer |
|---|---|
| Invalid credentials | Verifique o email, a palavra-passe e o Caps Lock; Use Forgot password se necessário |
| Account is not verified | Abra um email de verificação ou solicite o reenvio do link |
| Account is suspended or locked | Contacte o suporte através dos canais oficiais |
| TOTP code is required | Introduza um código de seis dígitos a partir de uma aplicação autenticadora |
| TOTP code is invalid | Espere por um novo código e verifique se o seu telemóvel define automaticamente a hora |
| Refresh token has expired | Volte a entrar no Dashboard |
| Operação sensível incompleta | Verifique o seu cargo e complete a reautenticação |
| You need an active shop membership... | Verifique o estado da loja e da associação selecionada |
Se perder o dispositivo de autenticação, use um código de recuperação não utilizado. Não envie códigos TOTP ou de recuperação a terceiros.
Planos e limites
| Mensagem | O que fazer |
|---|---|
| Image search is not available on the current plan | Atualiza para Starter ou superior, ou desativa a funcionalidade |
| Recommendations are not available on the current plan | Atualiza para Lançar ou superior, ou desativa as recomendações |
| The monthly recommendation request quota has been reached | Espere pelo próximo período de quota ou atualize o plano |
| Current usage exceeds the selected plan limits | Reduza o seu consumo abaixo do limite ou escolha um plano diferente |
| Your current plan does not allow connecting another shop | Melhore o seu plano ou utilize uma loja dentro dos seus limites atuais |
| Image storage quota exceeded | Apague dados desnecessários se houver uma opção adequada, ou melhore o plano |
Quando precisares de contactar o suporte
Preparação:
- Nome da loja e nome de domínio do site.
- Captura de ecrã completa da mensagem de erro.
- A hora de ocorrência, com o fuso horário.
- Passos acabados de tomar.
- Se o erro afeta todos ou apenas uma conta, dispositivo ou endereço IP.
- O registo relevante nos Cron Jobs → Logs, se aplicável.
Não envie palavras-passe, códigos TOTP, códigos de recuperação, Segredos de Módulo, Chaves API, Chaves de Widget ou tokens cron.