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

Troubleshooting

メールアカウントへの接続やメールの同期で問題が発生している場合は、このチェックリストに従って一般的な問題を調査し解決してください。

1. Check the Activity Log​

Perfex CRM 内の Utilities → Activity Log に移動し、IMAP 接続または同期失敗に関連するエラーメッセージを確認します。

2. Enable Debug Mode​

より詳細なエラー出力を取得するには:

  1. Perfex CRM のルートにある index.php を開く
  2. 次の行を探す:
define('ENVIRONMENT', 'production');
  1. 次のように変更:
define('ENVIRONMENT', 'development');
  1. ファイルを保存してページを再読み込みし、生のエラーメッセージを確認
警告

テスト後は production に戻すことを忘れないでください。

3. Inspect Your Hosting Error Logs​

画面が真っ白になったり、Perfex にエラーが表示されない場合:

  1. ウェブホスティングコントロールパネル（cPanel や Plesk など）にアクセス
  2. 「Metrics」または「Logs」セクションの下にある "Error Log" を探す
  3. 「memory exhausted」「timeout」、IMAP 関連のエラーなどをスキャン

4. Double-Check Cron Setup​

cron ジョブが実行されていることを確認してください。cron がないと、Mailbox モジュールはメールを同期できません。

cron のトラブルシューティングについては、Perfex CRM のドキュメントまたはサーバー管理者にご相談ください。

5. OAuth vs Password Authentication​

Mailbox モジュールは 2 つの認証方法をサポートしています:

Gmail と Outlook ユーザーには、OAuth2 を推奨します。より安全で、パスワードの保存が不要です。

一般的な OAuth の問題:

IssueSolution
"OAuth connection failed"Setup → Settings → Mailbox Settings で OAuth 認証情報を確認。リダイレクト URI の設定をチェック。OAuth アプリに必要なスコープがあることを確認。
"Token expired"OAuth トークンは自動的に更新されます。切断して再接続を試してください。Gmail: 未検証アプリでは 7 日後にトークンの有効期限が切れます。
"OAuth not available"OAuth は Gmail と Outlook のみで利用可能。他のプロバイダーではパスワード認証を使用。

Password Authentication​

OAuth2 をサポートしていないメールプロバイダーでは、パスワード認証を使用します。

メールプロバイダーが App Password を必要とするか確認

Gmail、Yahoo、Outlook などの一部のメールプロバイダーでは、特に 2FA（二要素認証） が有効な場合、実際のメールアカウントパスワードの代わりに App Password の使用が必要です。

例: Gmail ユーザー

  1. https://myaccount.google.com/security にアクセス
  2. まだ有効でない場合は 2-Step Verification を有効化
  3. 「Signing in to Google」の下で App Passwords を探す
  4. 「Mail」用の新しいアプリパスワードを生成
  5. 通常の Gmail パスワードの代わりに、モジュールの Mailbox Config でそのパスワードを使用
警告

必要な場合に App Password を使用しないと、認証エラーやログイン阻害が発生します。

ヒント

Gmail と Outlook には、セキュリティと使いやすさのため、App Password ではなく OAuth2 の使用を強く推奨します。Gmail OAuth Setup または Outlook OAuth Setup を参照してください。

6. Per-Staff vs Global Settings​

モジュールはスタッフごととグローバルの IMAP 設定の両方をサポートします:

  • Per-Staff Settings: 各スタッフが独自の IMAP サーバー、ポート、暗号化、フォルダマッピングを設定可能
  • Global Settings: スタッフごとの設定がない場合に使用されるフォールバック設定

メールが同期されない場合:

  1. スタッフごとの設定について Mailbox Config ページを確認
  2. IMAP サーバー、ポート、暗号化が正しいことを確認
  3. フォルダマッピングを確認（ Non-standard フォルダ名を使用している場合）
  4. 特定のエラーメッセージについて Activity Log を確認

7. Read Status Sync Issues​

「Sync Read Status to Email Server」を有効にしても Gmail/Outlook に反映されない場合:

  • 古いメール: バージョン 2.1.7 より前にインポートされたメールには UID が保存されていない可能性があります。新しいメールのみが既読ステータスを同期します。
  • UID missing: Activity Log で「Email ID XXX has no UID stored」メッセージを確認（古いメールでは正常）
  • OAuth required: 既読ステータス同期は OAuth 認証で最も効果的
  • Manual sync: 接続をテストするには Settings の Manual Sync ボタンを使用

Still Need Help?​

行き詰まったり、問題を解決できない場合は、サポートチームがお手伝いします。Themesic Support Portal からチケットを作成してください。できるだけ早く対応いたします。