Dépannage
Dernière mise à jour:
Pour les exploitants d’atelier et les responsables techniques. Précédent:
Trouvez le message que vous voyez à l’écran, puis suivez les étapes du tableau concerné. Les messages sont conservés en anglais pour que vous puissiez les associer à l’interface.
Vérifications rapides
Avant de résoudre un problème spécifique:
- Vérifiez que vous travaillez dans le bon atelier.
- Ouvrir ** PrestaKick connexion IA →** dans le module.
- Vérifier le statut Connected.
- Si vous venez de changer la configuration, sélectionnez Save configuration.
- Ouvrez les emplois → journaux de cron et vérifiez la dernière exécution.
- Sur le tableau de bord, vérifiez le statut de Healthy, Degraded, Offline ou Unknown.
- Réessayez avec une fenêtre incognito pour exclure les anciennes données du navigateur.
Erreur de connexion du module
| Message ou symptôme | Cause commune | Que faire |
|---|---|---|
| API connection required | Module qui ne se connecte pas ou ne parvient pas à appeler l’API | Ouvre Connection, reconnecte et sélectionne Save configuration |
| Not connected | OAuth incomplet ou déconnecté | Choisissez Connect with PrestaKick, choisissez la bonne boutique et confirmez |
| Connected mais Features signale toujours une erreur | Paramètres non enregistrés, URL incorrecte ou aucun accès Internet sortant | Sauvegardez les paramètres, https://api.prestakick.com vérifiez, puis utilisez Test connection |
| Connection failed / Connection test failed | Informations manquantes ou API inaccessibles | Vérifiez Module Secret, API Base URL, Shop ID et connectivité réseau |
| Invalid API Base URL format |
Ne soumettez pas de secrets de module ni de clés API dans les requêtes de support.
Erreur OAuth
| Message | Que faire |
|---|---|
| Invalid connection request | Fermez la page actuelle et recommencez depuis Connect with PrestaKick dans le module |
| OAuth connection token has expired | Recommencez depuis le module; L’ancien lien est expiré |
| OAuth connection token has already been used | Ne rouvrez pas l’ancien lien; Lancer un nouveau flux de connexion |
| Shop is already connected to another PrestaShop URL | Vérifiez les anciennes et nouvelles URL avant de choisir de vous reconnecter |
| Only the shop owner can connect this shop | Connectez-vous avec un compte propriétaire ou demandez au propriétaire de le faire |
| No unconnected shops | Créez une boutique ou reconnectez une boutique existante si c’est ce que vous comptez faire |
N’ouvrez qu’un seul processus OAuth à la fois.
Le module hors ligne ou la synchronisation manque de données
| Phénomène | Comment gérer |
|---|---|
| Rapports de modules Offline | Vérifiez que le module est activé, que le cron fonctionne et que le serveur a accès à Internet |
| Rapports de modules Degraded | Ouvrez Cron Jobs → Logs, vérifiez les erreurs répétées et la file d’attente, puis surveillez si le statut se rétablit |
| Les rapports du module Unknown après une nouvelle connexion | Attends quelques minutes et lance cron une fois |
| Anciennes ou manquantes données du tableau de bord | Vérifiez le statut du module et ouvrez la Data sync pour demander une resynchronisation |
| Manual sync is rate limited to once per hour per entity type | Attendez l’expiration de la durée avant d’exécuter à nouveau le type de données |
| Synchronisation des rapports de travail Failed | Ouvre les détails, règle la cause, puis relance le travail |
| Unauthorized: Invalid or missing API Key | Vérifiez la clé API du magasin, sélectionnez Save configuration, ou reconnectez-vous via OAuth |
| Unauthorized: invalid or missing cron token. |
Widget qui n’apparaît pas
Vérifiez dans cet ordre:
- Show Widget activé, ou l’IP de test est dans le Preview IPs.
- Vous avez choisi Save configuration.
- Le nom de domaine actuel se trouve dans le Allowed storefront domains.
- Le module n’est pas en Offline état.
- Le navigateur n’utilise pas d’ancien JavaScript; Essayez un rafraîchissement intense ou une fenêtre incognito.
- Si le test est sur téléphone, Show on Mobile est en cours.
| Message | Que faire |
|---|---|
| Widget origin is not allowed for this shop | Le propriétaire ajoute le nom de domaine correct dans Paramètres → Domaines & Accès, puis sélectionne Save rules |
| Invalid widget key | Reconnectez OAuth ou mettez à jour une nouvelle clé de widget dans votre configuration actuelle |
| Failed to save widget configuration | Vérifiez la connexion, les permissions et les limites du forfait, puis sauvegardez à nouveau |
| Upgrade to Starter or higher to allow image uploads | Passez à Starter ou plus, ou désactivez Allow image uploads |
Chat et assistants IA
| Message ou symptôme | Que faire |
|---|---|
| Le chat s’ouvre mais l’IA ne répond pas | Vérifiez les quotas, l’état des modules, les données synchronisées et les notifications de service |
| You are sending messages too fast... | Attends quelques secondes puis renvoie |
| AI credits have been exhausted | Les propriétaires achètent plus de crédits, mettent à niveau leur forfait ou attendent une nouvelle limite |
| Too many requests. Please try again later | Attends et réessaie; Si cela arrive fréquemment avec du trafic réel, contactez le support |
| Service is temporarily unavailable | Réessayez plus tard; les agents peuvent prendre en charge les conversations si la boîte de réception du chat est encore active |
| L’assistant donne une réponse générique | Vérifiez les descriptions de produits, les pages de politiques, la synchronisation et les instructions de l’Assistant |
| Message could not be sent. | Vérifie la connexion et réessaie |
| Could not send the image. | Vérifiez le format de l’image, la taille du fichier et si le plan autorise le téléchargement d’images |
Connexion et sécurité
| Message | Que faire |
|---|---|
| Invalid credentials | Vérifiez l’email, le mot de passe et le Verru majuscule; Utilisez Forgot password si besoin |
| Account is not verified | Ouvrez un e-mail de vérification ou demandez un lien de réenvoi |
| Account is suspended or locked | Contactez le support via les canaux officiels |
| TOTP code is required | Saisissez un code à six chiffres depuis une application d’authentification |
| TOTP code is invalid | Attendez un nouveau code et vérifiez que votre téléphone règle automatiquement son heure |
| Refresh token has expired | Reconnectez-vous au tableau de bord |
| Opération sensible incomplète | Vérifiez votre rôle et réauthentification complète |
| You need an active shop membership... | Vérifiez le statut de votre boutique et de votre adhésion |
Si vous perdez votre dispositif d’authentification, utilisez un code de récupération inutilisé. N’envoyez pas de codes TOTP ou de récupération à d’autres.
Plans et limites
| Message | Que faire |
|---|---|
| Image search is not available on the current plan | Passez à Starter ou plus haut, ou désactivez la fonction |
| Recommendations are not available on the current plan | Passer à Lancement ou plus haut, ou désactiver les recommandations |
| The monthly recommendation request quota has been reached | Attendez la prochaine période de quota ou améliorez le plan |
| Current usage exceeds the selected plan limits | Réduisez votre consommation en dessous de la limite ou choisissez un autre forfait |
| Your current plan does not allow connecting another shop | Améliorez votre forfait ou utilisez une boutique dans vos limites actuelles |
| Image storage quota exceeded | Supprimez les données inutiles s’il y a une option appropriée, ou améliorez le forfait |
Quand contacter le support
Préparation:
- Nom de la boutique et nom de domaine du site web.
- Capture d’écran complète du message d’erreur.
- L’heure de l’occurrence, avec le fuseau horaire.
- Des étapes viennent de se prendre.
- Si l’erreur affecte tout le monde ou seulement un compte, un appareil ou une adresse IP.
- L’enregistrement pertinent dans les Cron Jobs → Logs, le cas échéant.
N’envoyez pas de mots de passe, codes TOTP, codes de récupération, secrets de module, clés API, clés widget ou jetons cron.