Dépannage
Solutions aux problèmes les plus courants avec Kaiply. Chaque section couvre les symptômes, les causes probables et les actions correctives.
Widget
Le widget n'apparaît pas sur le site
- Vérifiez que le script est bien ajouté avant
</body> - Le
data-chatbot-iddoit correspondre exactement à votre ID chatbot (visible dans Dashboard → Intégrer) - Ouvrez la console du navigateur (F12) et vérifiez s'il y a des erreurs JavaScript
- Désactivez temporairement les extensions de navigateur (ad blockers)
- Vérifiez que le chatbot est bien actif dans vos paramètres
Erreur CORS dans la console
Access to fetch at 'https://app.kaiply.fr/...' has been blocked by CORS policy
- Ajoutez votre domaine exact dans Dashboard → Paramètres → Sécurité → Origines autorisées
- Incluez les deux variantes si nécessaire :
https://monsite.frethttps://www.monsite.fr - Assurez-vous d'utiliser
https://(pashttp://) - Pas de slash à la fin de l'URL
Le widget s'affiche mais n'envoie pas de messages
- Vérifiez votre connexion Internet
- Vérifiez que le chatbot n'a pas atteint son quota de messages du plan
- Vérifiez les logs dans le dashboard pour voir si des erreurs sont remontées
Réponses de l'IA
L'IA répond "je ne sais pas" trop souvent
- Ajoutez plus de contenu sur les sujets non couverts dans Sources
- Vérifiez que vos documents ont bien été vectorisés (statut dans Sources)
- Abaissez le seuil de similarité dans les paramètres avancés (essayez 0.5)
- Reformulez votre contenu en format question/réponse pour une meilleure correspondance
L'IA donne des informations incorrectes
- Recherchez et supprimez les fragments obsolètes ou contradictoires dans Sources
- Mettez à jour votre contenu avec les informations actuelles
- Ajoutez des instructions précises dans le prompt système pour les sujets sensibles
Les réponses sont lentes
- Réduisez le nombre de fragments à récupérer (réglage avancé, < 10 000 fragments total)
- Passez à un modèle plus léger : GPT-4o Mini au lieu de GPT-4o
- Vérifiez la région Supabase configurée — plus elle est proche, plus c'est rapide
Live Chat
Impossible de prendre en charge une conversation
- Vérifiez que la feature Live Chat est bien activée (Dashboard → Features)
- Vérifiez qu'un autre agent n'a pas déjà pris la conversation en charge
- Vérifiez vos permissions — vous devez avoir le droit
inbox:takeover - Rafraîchissez la page et réessayez
Les notifications en temps réel ne fonctionnent pas
- Autorisez les notifications du navigateur pour votre dashboard
- Vérifiez que vous n'êtes pas en mode "Ne pas déranger" sur votre système
- La connexion WebSocket (Supabase Realtime) peut être bloquée par certains proxies/VPN — essayez sans
- Rechargez la page pour rétablir la connexion temps réel
Tickets
Les tickets ne sont pas créés hors horaires
- Vérifiez que les horaires d'ouverture sont bien activés (Dashboard → Paramètres → Horaires)
- Vérifiez le fuseau horaire configuré — une erreur de fuseau peut décaler les horaires
- Testez en dehors des plages horaires définies
Import CSV produits
L'import CSV échoue ou importe mal les données
- Vérifiez que le fichier est encodé en UTF-8 (pas Latin-1 ou Windows-1252)
- Le séparateur doit être une virgule
,(pas un point-virgule) - Les colonnes
name,descriptionetpricesont obligatoires - Le prix doit être un nombre (ex.
29.99, pas29,99€) - Consultez le rapport d'erreurs affiché après l'import pour identifier les lignes problématiques
Besoin d'aide supplémentaire ?
Vous n'avez pas trouvé la solution ? Contactez notre équipe support avec une description du problème et les éventuels messages d'erreur.
Contacter le support