Перейти к основному содержимому

Troubleshooting

Если у вас возникли проблемы с подключением к почтовому аккаунту или синхронизацией писем, следуйте этому чеклисту для расследования и решения распространённых проблем.

1. Check the Activity Log​

Перейдите в Utilities → Activity Log внутри Perfex CRM для просмотра сообщений об ошибках, связанных с IMAP-подключением или сбоями синхронизации.

2. Enable Debug Mode​

Для получения более подробного вывода ошибок:

  1. Откройте index.php в корне вашей установки Perfex CRM
  2. Найдите строку:
define('ENVIRONMENT', 'production');
  1. Измените на:
define('ENVIRONMENT', 'development');
  1. Сохраните файл и перезагрузите страницу для просмотра исходных сообщений об ошибках
warning

Не забудьте вернуть обратно на production после тестирования!

3. Inspect Your Hosting Error Logs​

Если экран становится пустым или ошибки не отображаются в Perfex:

  1. Доступ к панели управления хостингом (например, cPanel или Plesk)
  2. Найдите "Error Log", обычно в разделе "Metrics" или "Logs"
  3. Проверьте последние ошибки: "memory exhausted", "timeout" или проблемы, связанные с IMAP

4. Double-Check Cron Setup​

Убедитесь, что cron-задачи выполняются. Без них модуль Mailbox не может синхронизировать письма.

Обратитесь к документации Perfex CRM или администратору сервера для устранения неполадок cron.

5. OAuth vs Password Authentication​

Модуль Mailbox поддерживает два метода аутентификации:

Для пользователей Gmail и Outlook рекомендуется OAuth2. Он более безопасен и не требует хранения паролей.

Частые проблемы OAuth:

IssueSolution
"OAuth connection failed"Проверьте учётные данные OAuth в Setup → Settings → Mailbox Settings. Проверьте настройку redirect URI. Убедитесь, что приложение OAuth имеет необходимые области.
"Token expired"OAuth-токены автоматически обновляются. Попробуйте отключиться и подключиться снова. Для Gmail: токены истекают через 7 дней для непроверенных приложений.
"OAuth not available"OAuth доступен только для Gmail и Outlook. Используйте парольную аутентификацию для других провайдеров.

Password Authentication​

Для почтовых провайдеров, не поддерживающих OAuth2, используйте парольную аутентификацию.

Проверьте, требует ли ваш провайдер App Password

Некоторые провайдеры, такие как Gmail, Yahoo и Outlook, требуют использования App Password вместо фактического пароля учётной записи — особенно если включена 2FA (Two-Factor Authentication).

Пример: пользователи Gmail

  1. Перейдите на https://myaccount.google.com/security
  2. Включите 2-Step Verification, если ещё не включено
  3. В разделе "Signing in to Google" найдите App Passwords
  4. Создайте новый пароль приложения для "Mail"
  5. Используйте этот пароль в Mailbox Config модуля вместо обычного пароля Gmail
warning

Неиспользование App Password при необходимости приведёт к ошибкам аутентификации или блокировке попыток входа.

подсказка

Для Gmail и Outlook настоятельно рекомендуем использовать OAuth2 вместо App Passwords для повышения безопасности и удобства. См. 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. Проверьте сопоставление папок (особенно при нестандартных именах папок)
  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: Используйте кнопку Manual Sync в Settings для проверки подключения

Still Need Help?​

Если вы застряли или не можете решить проблему, наша команда поддержки готова помочь. Создайте тикет через Themesic Support Portal, и мы поможем вам как можно скорее.