Resolução de Problemas
Problemas comuns e soluções para o módulo AI SmartTalk PrestaShop.
Instalação
O módulo não instala
- Verifique sua versão do PrestaShop: O módulo requer PrestaShop 8 ou 9
- Verifique a memória do servidor: Certifique-se de que seu servidor tenha memória suficiente para instalar módulos
- Verifique as permissões de arquivo: O diretório
modules/deve ser gravável pelo servidor web - Desative módulos conflitantes: Tente desativar outros módulos temporariamente se houver conflitos
O módulo foi instalado, mas não aparece no menu
- Limpe o cache do PrestaShop: Parâmetros Avançados > Desempenho > Limpar cache
- Tente sair e entrar novamente no seu admin do PrestaShop
Conexão
O botão "Conectar com AI SmartTalk" não funciona
- Verifique o HTTPS de saída: Seu servidor deve permitir conexões HTTPS de saída para
aismarttalk.tech - Verifique bloqueadores de pop-up: O fluxo OAuth abre em uma nova janela — certifique-se de que seu navegador não está bloqueando
- Verifique seu firewall: Certifique-se de que as portas 443 (HTTPS) não estão bloqueadas
A conexão redireciona, mas nada acontece
- O token OAuth é válido por 10 minutos. Se você esperou muito tempo, tente desconectar e reconectar
- Limpe os cookies do seu navegador e tente novamente
Multi-site: um site aparece como "Desconectado"
- Cada site precisa de sua própria conexão OAuth. Vá para a instância do PrestaShop afetada e clique em Conectar novamente
- Certifique-se de que cada site tenha um nome de domínio ou porta distintos
Chatbot
O chatbot não aparece na minha loja
- Verifique o status do módulo: Certifique-se de que o chatbot está habilitado na aba Chatbot do módulo
- Verifique a seleção do assistente: Certifique-se de que um assistente de IA está selecionado e salvo
- Verifique a conexão: O módulo deve estar conectado ao AI SmartTalk (insígnia de status verde)
- Limpe os caches: Limpe tanto o cache do PrestaShop (Parâmetros Avançados > Desempenho) quanto o cache do seu navegador
- Verifique a posição do hook: Tente alternar entre "Rodapé" e "Antes do Rodapé" nas configurações de Aparência
O chatbot aparece, mas não responde
- Verifique se sua assinatura do AI SmartTalk está ativa
- Verifique se o assistente selecionado está configurado corretamente no seu painel do AI SmartTalk
- Verifique o console de desenvolvedor do seu navegador para erros de JavaScript
API & Ações de IA
Ações de IA falham com "permissão negada" ou "não autorizado"
- Verifique sua chave de Webservice: Certifique-se de que está habilitada e tem as permissões corretas (veja Permissões da API)
- Verifique se a chave está inserida: O token de Webservice deve ser transmitido durante a conexão OAuth. Se estiver faltando, atualize-o no seu painel do AI SmartTalk nas configurações de integração do PrestaShop
Atualizações de produtos não funcionam
- Certifique-se de que
productstem permissões GET e PUT na sua chave de Webservice - Verifique se o ID do produto existe e se o produto não está bloqueado por outro módulo
Mudanças de status de pedido falham
- Certifique-se de que
order_historiestem permissões GET e POST - Verifique se o ID do estado do pedido é válido para sua loja (os IDs de estado variam conforme a configuração do PrestaShop)
A pesquisa de clientes não retorna resultados
- Certifique-se de que
customerstem permissão GET - Verifique se o endereço de e-mail está correto e corresponde a um cliente existente
Sincronização
A sincronização de produtos não inicia ou falha
- Verifique as configurações de tempo limite do PHP do seu servidor — catálogos grandes podem precisar de mais tempo
- Verifique se sua conexão com a internet está estável
- Verifique os logs de erro do PrestaShop em Parâmetros Avançados > Logs
Apenas alguns produtos são sincronizados
- Verifique se os filtros de sincronização estão ativos (um distintivo "Filtrado" aparece na aba Sincronizar)
- Revise os filtros de categoria e tipo de produto para garantir que correspondem às suas expectativas
A sincronização de clientes não funciona
- Certifique-se de que a sincronização de clientes está habilitada na aba Sincronizar
- Os clientes são exportados em lotes de 50 — bancos de dados grandes podem levar vários minutos
Webhooks
Webhooks não disparam
- Verifique se os gatilhos de webhook estão habilitados na aba Webhooks
- Verifique se seu servidor permite solicitações HTTP de saída para AI SmartTalk
- Certifique-se de que você tem um fluxo de trabalho SmartFlow configurado para receber o gatilho do webhook
- Verifique os logs do PrestaShop para quaisquer erros durante a execução do hook
Webhooks disparam, mas nada acontece no SmartFlow
- Verifique se seu fluxo de trabalho SmartFlow está publicado e ativo
- Verifique se o tipo de gatilho do fluxo de trabalho corresponde ao evento de webhook do PrestaShop
- Revise os logs de execução do SmartFlow no seu painel do AI SmartTalk
Desempenho
O módulo desacelera minha loja
- Desative gatilhos de webhook não utilizados para reduzir solicitações de saída
- Certifique-se de que o cache está funcionando corretamente — o módulo usa um cache embutido para configuração de embed
- Verifique se seu servidor tem recursos adequados (CPU, memória)
O back office está lento após a instalação do módulo
- O módulo só é executado em sua própria página de configuração e em hooks específicos — não deve impactar o desempenho geral do back office
- Se você enfrentar problemas, verifique por conflitos com outros módulos
Ainda precisa de ajuda?
Se seu problema não está coberto aqui:
- Verifique o painel do AI SmartTalk para mensagens de erro ou alertas
- Revise os logs de erro do PrestaShop (Parâmetros Avançados > Logs)
- Entre em contato com nossa equipe de suporte em contact+support@aismarttalk.tech