Skip to main content

🔧 Troubleshooting

Installation Issues​

"Cannot connect to database"​

  1. Try 127.0.0.1 instead of localhost
  2. Verify credentials via phpMyAdmin
  3. Check MySQL user privileges
  4. On cPanel, the DB host is always localhost

Installer redirects to homepage​

config/database.php already exists from a previous attempt. Delete it and try again.

Login shows blank page​

Check PHP error log for Fatal error or Call to undefined function. Most common: missing pdo_mysql extension.

Messages Not Appearing​

Webhook messages not arriving​

  1. Is the webhook URL configured in the provider's dashboard?
  2. Does the URL use HTTPS?
  3. Is the channel active (toggle on)?
  4. Check webhook_events table for failed entries

Email messages not appearing​

  1. Is the cron job running?
  2. Is the PHP imap extension loaded?
  3. Are IMAP credentials correct?

SSE real-time updates not working​

  1. Check browser DevTools → Network for /sse request
  2. Nginx buffering? Set X-Accel-Buffering: no
  3. CDN/Cloudflare? Enable streaming mode
  4. PHP max_execution_time must be at least 60 seconds

Sending Failures​

WhatsApp reply not delivered​

  1. Is the Access Token valid? Temporary tokens expire in ~24 hours
  2. Is the phone number in E.164 format without +?
  3. Is the Meta app still in Development mode?

Email replies not arriving​

PHP mail() may not be configured on VPS. Configure Postfix or use an email API.

Common PHP Errors​

ErrorFix
Call to undefined function imap_open()Shared hosting: cPanel → Select PHP Version → enable imap. VPS: sudo apt install php-imap
Permission denied: config/database.phpSet config/ to 755 via File Manager or chmod 755 config/
Maximum execution time exceededSet max_execution_time = 120 in php.ini

Getting More Help​

  1. PHP Error Log — cPanel: Logs → Error Log. VPS: /var/log/apache2/error.log
  2. Webhook Event Log — inspect webhook_events table in phpMyAdmin
  3. Cron Output — visit your cron URL in the browser
  4. Browser Console — F12 → Console for JavaScript errors