Zum Hauptinhalt springen

🔧 Fehlerbehebung

Installationsprobleme​

„Cannot connect to database"​

  1. Versuchen Sie 127.0.0.1 statt localhost
  2. Überprüfen Sie Zugangsdaten über phpMyAdmin
  3. Prüfen Sie MySQL-Benutzerrechte
  4. Bei cPanel ist der DB-Host immer localhost

Installer leitet zur Startseite weiter​

config/database.php existiert bereits von einem vorherigen Versuch. Löschen Sie es und versuchen Sie es erneut.

Login zeigt leere Seite​

Prüfen Sie das PHP-Fehlerlog auf Fatal error oder Call to undefined function. Am häufigsten: fehlende pdo_mysql-Erweiterung.

Nachrichten erscheinen nicht​

Webhook-Nachrichten kommen nicht an​

  1. Ist die Webhook-URL im Anbieter-Dashboard konfiguriert?
  2. Verwendet die URL HTTPS?
  3. Ist der Kanal aktiv (Toggle an)?
  4. Prüfen Sie die webhook_events-Tabelle auf failed-Einträge

E-Mail-Nachrichten erscheinen nicht​

  1. Läuft der Cron-Job?
  2. Ist die PHP-imap-Erweiterung geladen?
  3. Sind die IMAP-Zugangsdaten korrekt?

SSE-Echtzeit-Updates funktionieren nicht​

  1. Prüfen Sie Browser-DevTools → Netzwerk auf /sse-Anfrage
  2. Nginx-Buffering? Setzen Sie X-Accel-Buffering: no
  3. CDN/Cloudflare? Streaming-Modus aktivieren
  4. PHP max_execution_time muss mindestens 60 Sekunden sein

Sendefehler​

WhatsApp-Antwort wird nicht zugestellt​

  1. Ist das Access Token gültig? Temporäre Tokens laufen nach ~24 Stunden ab
  2. Ist die Telefonnummer im E.164-Format ohne +?
  3. Ist die Meta-App noch im Development-Modus?

E-Mail-Antworten kommen nicht an​

PHP mail() ist möglicherweise nicht auf VPS konfiguriert. Konfigurieren Sie Postfix oder verwenden Sie eine E-Mail-API.

Häufige PHP-Fehler​

FehlerLösung
Call to undefined function imap_open()Shared Hosting: cPanel → Select PHP Version → imap aktivieren. VPS: sudo apt install php-imap
Permission denied: config/database.phpSetzen Sie config/ auf 755 über den Dateimanager oder chmod 755 config/
Maximum execution time exceededSetzen Sie max_execution_time = 120 in php.ini

Weitere Hilfe​

  1. PHP-Fehlerlog — cPanel: Logs → Error Log. VPS: /var/log/apache2/error.log
  2. Webhook-Event-Log — inspizieren Sie die webhook_events-Tabelle in phpMyAdmin
  3. Cron-Ausgabe — besuchen Sie Ihre Cron-URL im Browser
  4. Browser-Konsole — F12 → Konsole für JavaScript-Fehler