Dépannage — résoudre les problèmes courants de votre bot WaBot
Le bot ne répond pas, le QR code ne s'affiche pas, les messages s'envoient en double — guide de résolution des problèmes les plus fréquents.
Le bot ne répond pas aux messages
Vérification 1 : le bot est-il démarré ? Sur la page du bot, le statut doit afficher 'Actif' (cercle vert). Sinon, cliquez sur 'Démarrer'.
Vérification 2 : la clé OpenAI est-elle configurée ? Dans les paramètres du bot, vérifiez que la variable OPENAI_API_KEY est présente. Sans clé, le bot utilise un message de fallback.
Vérification 3 : vérifiez le solde de votre compte OpenAI sur platform.openai.com. Un quota dépassé ou une carte expirée bloque les appels API.
Vérification 4 : le numéro qui envoie le message est-il différent du numéro du bot ? Le bot ignore ses propres messages.
Le QR code ne s'affiche pas
Cliquez sur 'Démarrer le bot' et attendez 10-15 secondes. Le QR code est généré de façon asynchrone après connexion au serveur WhatsApp.
Si le QR ne s'affiche toujours pas, vérifiez votre connexion réseau. Le dashboard utilise Server-Sent Events (SSE) pour recevoir le QR — certains proxies d'entreprise bloquent ces connexions.
Essayez de déconnecter le bot (bouton 'Déconnecter') puis de le redémarrer. Cela force une nouvelle session et un nouveau QR.
Le bot se déconnecte fréquemment
Une déconnexion fréquente peut indiquer que le numéro WhatsApp est utilisé simultanément sur un autre appareil. WhatsApp multi-device tolère 4 appareils liés, mais des conflits peuvent survenir.
Si votre téléphone a une connexion Internet instable, WhatsApp peut déconnecter les appareils liés. Assurez-vous que votre téléphone est régulièrement connecté.
WaBot gère automatiquement la reconnexion (délai de 3 secondes) après une déconnexion non volontaire. Si la reconnexion échoue (logout WhatsApp), le bot passe en état 'Arrêté' et un nouveau QR est nécessaire.
Le bot répond de façon incorrecte ou hors sujet
C'est généralement un problème de prompt. Ouvrez les paramètres du bot et affinez les instructions : soyez plus précis sur les limites et le contexte.
Consultez l'onglet Conversations pour identifier exactement quels messages posent problème. Copiez ces messages et testez différentes formulations d'instructions.
Si le bot invente des informations (hallucinations), ajoutez explicitement dans les instructions : 'Ne fabrique jamais d'informations. Si tu ne connais pas la réponse, dis-le honnêtement et propose une alternative (contacter par email, etc.).'
Erreurs liées à l'API OpenAI
'Rate limit exceeded' : vous avez dépassé le quota de requêtes par minute. Ajoutez OPENAI_MODEL=gpt-4o-mini dans les variables d'environnement pour utiliser un modèle moins sollicité.
'Insufficient credits' : rechargez votre compte OpenAI ou configurez un mode de paiement valide sur platform.openai.com.
Réponses tronquées : si les réponses s'arrêtent brutalement, augmentez max_tokens en ajoutant OPENAI_MAX_TOKENS=600 dans les variables d'environnement du bot.