メインコンテンツまでスキップ

トラブルシューティング

インストールの問題​

「データベースに接続できません」​

  1. localhost の代わりに 127.0.0.1 を試す
  2. phpMyAdmin で認証情報を確認
  3. MySQL ユーザー権限を確認
  4. cPanel では、DB ホストは常に localhost

インストーラーがホームページにリダイレクトされる​

前回の試行から config/database.php がすでに存在しています。削除してから再試行してください。

ログインで空白ページが表示される​

PHP エラーログで Fatal error または Call to undefined function を確認してください。最も一般的な原因：pdo_mysql 拡張機能の欠如。

メッセージが表示されない​

Webhook メッセージが届かない​

  1. プロバイダーのダッシュボードで webhook URL が設定されていますか？
  2. URL は HTTPS を使用していますか？
  3. チャネルはアクティブですか（トグルがオン）？
  4. webhook_events テーブルで failed エントリを確認

メールメッセージが表示されない​

  1. cron ジョブは実行されていますか？
  2. PHP imap 拡張機能はロードされていますか？
  3. IMAP 認証情報は正しいですか？

SSE リアルタイム更新が動作しない​

  1. ブラウザの DevTools → ネットワークで /sse リクエストを確認
  2. Nginx のバッファリング？ X-Accel-Buffering: no を設定
  3. CDN/Cloudflare？ストリーミングモードを有効化
  4. PHP max_execution_time は少なくとも 60 秒必要

送信失敗​

WhatsApp の返信が配信されない​

  1. Access Token は有効ですか？一時トークンは約 24 時間で期限切れ
  2. 電話番号は + なしの E.164 形式ですか？
  3. Meta アプリはまだ Development モードですか？

メールの返信が届かない​

VPS で PHP mail() が設定されていない可能性があります。Postfix を設定するか、メール API を使用してください。

一般的な PHP エラー​

エラー修正
Call to undefined function imap_open()共有ホスティング： cPanel → PHP バージョン選択 → imap を有効化。VPS： sudo apt install php-imap
Permission denied: config/database.phpファイルマネージャーで config/ を 755 に設定、または chmod 755 config/
Maximum execution time exceededphp.ini で max_execution_time = 120 を設定

さらなるヘルプ​

  1. PHP エラーログ — cPanel: ログ → エラーログ。VPS: /var/log/apache2/error.log
  2. Webhook イベントログ — phpMyAdmin で webhook_events テーブルを確認
  3. Cron 出力 — ブラウザで cron URL にアクセス
  4. ブラウザコンソール — F12 → Console で JavaScript エラーを確認