Aller au contenu principal

🔧 Dépannage

Problèmes d'Installation​

« Cannot connect to database »​

  1. Essayez 127.0.0.1 au lieu de localhost
  2. Vérifiez les identifiants via phpMyAdmin
  3. Vérifiez les privilèges de l'utilisateur MySQL
  4. Sur cPanel, l'hôte BDD est toujours localhost

L'installateur redirige vers la page d'accueil​

config/database.php existe déjà d'une tentative précédente. Supprimez-le et réessayez.

La connexion affiche une page blanche​

Vérifiez le log d'erreurs PHP pour Fatal error ou Call to undefined function. Le plus courant : extension pdo_mysql manquante.

Messages Non Visibles​

Les messages webhook n'arrivent pas​

  1. L'URL webhook est-elle configurée dans le tableau de bord du fournisseur ?
  2. L'URL utilise-t-elle HTTPS ?
  3. Le canal est-il actif (toggle activé) ?
  4. Vérifiez la table webhook_events pour les entrées failed

Les emails n'apparaissent pas​

  1. La tâche cron tourne-t-elle ?
  2. L'extension PHP imap est-elle chargée ?
  3. Les identifiants IMAP sont-ils corrects ?

Les mises à jour temps réel SSE ne fonctionnent pas​

  1. Vérifiez DevTools du navigateur → Réseau pour la requête /sse
  2. Buffering Nginx ? Définissez X-Accel-Buffering: no
  3. CDN/Cloudflare ? Activez le mode streaming
  4. max_execution_time PHP doit être d'au moins 60 secondes

Échecs d'Envoi​

La réponse WhatsApp n'est pas livrée​

  1. L'Access Token est-il valide ? Les tokens temporaires expirent en ~24 heures
  2. Le numéro de téléphone est-il en format E.164 sans + ?
  3. L'app Meta est-elle encore en mode Development ?

Les réponses email n'arrivent pas​

PHP mail() peut ne pas être configuré sur VPS. Configurez Postfix ou utilisez une API email.

Erreurs PHP Courantes​

ErreurSolution
Call to undefined function imap_open()Hébergement mutualisé : cPanel → Select PHP Version → activer imap. VPS : sudo apt install php-imap
Permission denied: config/database.phpDéfinissez config/ à 755 via le Gestionnaire de Fichiers ou chmod 755 config/
Maximum execution time exceededDéfinissez max_execution_time = 120 dans php.ini

Obtenir Plus d'Aide​

  1. Log d'Erreurs PHP — cPanel : Logs → Error Log. VPS : /var/log/apache2/error.log
  2. Log des Événements Webhook — inspectez la table webhook_events dans phpMyAdmin
  3. Sortie Cron — visitez votre URL cron dans le navigateur
  4. Console du Navigateur — F12 → Console pour les erreurs JavaScript