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

Configuration Steps

Следуйте этим шагам для настройки личного подключения к почтовому ящику в модуле Mailbox в Perfex CRM.

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

Authentication Methods​

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

  1. OAuth2 Authentication (Рекомендуется для Gmail и Outlook) — безопасное подключение без пароля
  2. Password Authentication — традиционное IMAP-подключение на основе пароля

Option A: OAuth2 Authentication (Gmail/Outlook)​

OAuth2 — рекомендуемый метод для учетных записей Gmail и Outlook/Microsoft 365. Он обеспечивает безопасную аутентификацию без пароля и требуется многими современными почтовыми провайдерами.

For Gmail Users​

  1. Admin Setup (Один раз, выполняет администратор):

    • Перейдите в Setup → Settings → Mailbox Settings
    • Прокрутите до раздела OAuth Settings
    • Введите Gmail OAuth Client ID и Client Secret
    • Нажмите Save

  2. Staff Setup (Каждый сотрудник):

    • Перейдите в Mailbox → Emails (или Profile → Mailbox Config)
    • Выберите OAuth как метод аутентификации
    • Нажмите кнопку Connect Gmail
    • Авторизуйте приложение во всплывающем окне
    • Ваш аккаунт Gmail будет подключён автоматически
подсказка

Подробные инструкции по настройке Gmail OAuth см. в Gmail OAuth Setup.

For Outlook/Microsoft 365 Users​

  1. Admin Setup (Один раз, выполняет администратор):

    • Перейдите в Setup → Settings → Mailbox Settings
    • Прокрутите до раздела OAuth Settings
    • Введите Outlook OAuth Client ID, Client Secret и Tenant ID
    • Нажмите Save

  2. Staff Setup (Каждый сотрудник):

    • Перейдите в Mailbox → Emails (или Profile → Mailbox Config)
    • Выберите OAuth как метод аутентификации
    • Нажмите кнопку Connect Outlook
    • Авторизуйте приложение во всплывающем окне
    • Ваш аккаунт Outlook будет подключён автоматически
подсказка

Подробные инструкции по настройке Outlook OAuth см. в Outlook OAuth Setup.

к сведению

OAuth-токены автоматически обновляются до истечения срока. Вам нужно авторизоваться только один раз.

Option B: Password Authentication​

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

1. Enter Your Email Account's Information​

Перейдите в раздел Mailbox Configuration Settings, выбрав "Emails" в меню "Mailbox" слева.

Введите имя пользователя IMAP и пароль, связанные с вашим адресом электронной почты (например, если вы вошли как [email protected], настройте [email protected] как почтовый ящик), и при необходимости добавьте подпись.

В целях безопасности [email protected] не может настроить подключение для [email protected] в своей учётной записи CRM. Для настройки [email protected] создайте учётную запись сотрудника George в Perfex CRM, а затем настройте почтовый ящик George из его профиля пользователя. Это обеспечивает надлежащую изоляцию электронной переписки каждого сотрудника и безопасную привязку к его учётной записи.

После ввода учётных данных и (при необходимости) подписи нажмите Save для завершения настройки подключения.

2. Set Up Your IMAP Server Details​

Настройки IMAP можно настроить двумя способами:

Method 1: Per-Staff IMAP Configuration (Recommended)

Каждый сотрудник может настроить свои параметры IMAP-сервера:

  1. Перейдите в Mailbox → Emails (или Profile → Mailbox Config)
  2. Прокрутите до раздела IMAP Server Configuration
  3. Введите IMAP Server (например, imap.gmail.com)
  4. Выберите Encryption Method (SSL, TLS или None)
  5. IMAP Port обновится автоматически в зависимости от шифрования (993 для SSL, 143 для TLS)
  6. Настройте Folder Mappings:
    • Folder to Scan (обычно "INBOX")
    • Sent Folder (например, "Sent", "Sent Items")
    • Drafts Folder (например, "Drafts")
    • Trash Folder (например, "Trash", "Deleted Items")
    • Spam Folder (например, "Spam", "Junk")
    • Archive Folder (например, "Archive")
  7. Нажмите Save
подсказка

Если оставить сопоставление папок пустым, модуль попытается определить их автоматически.

Method 2: Global IMAP Settings (Fallback)

Если индивидуальные настройки не настроены, модуль будет использовать глобальные настройки:

  1. Нажмите меню Setup в Perfex и найдите раздел Settings
  2. Перейдите вниз и найдите Mailbox Settings
  3. Нажмите и заполните необходимые данные в соответствии с настройками вашего почтового провайдера

Обязательные параметры:

  • IMAP Server (например, imap.gmail.com)
  • Encryption Method (обычно SSL)
  • Folder (папка для мониторинга — обычно "Inbox")
  • Check Every (частота задачи получения писем, в минутах)

На этой же странице можно изменить несколько простых опций работы модуля. Обязательно используйте правильные настройки для вашего провайдера — некорректные данные помешают успешному подключению.

3. Configure Personal Preferences​

На странице Mailbox Config можно также настроить:

  • Import Only Unread Emails: Включить для получения только непрочитанных писем (быстрее синхронизация)
  • Enable HTML Rendering: Включить для отображения HTML-писем с форматированием
  • Auto-mark as Read on Preview: Автоматически помечать письма как прочитанные при просмотре в панели предпросмотра или одиночном режиме
  • Sync Read Status to Email Server: Синхронизировать статус прочтения с IMAP-сервером (держит Gmail/Outlook в синхронизации, но медленнее)
к сведению

"Sync Read Status to Email Server" полезен, если вы хотите, чтобы ваш почтовый ящик Gmail/Outlook был синхронизирован с Perfex. При включении чтение письма в Perfex будет помечать его как прочитанное на почтовом сервере.

4. You're All Set!​

После сохранения настроек модуль Mailbox попытается подключиться к вашему почтовому ящику при условии, что cron-задачи Perfex CRM выполняются корректно.

подсказка

Проверить работу cron можно по выполнению запланированных задач или активности синхронизации модуля. Также можно использовать кнопку Manual Sync в Settings → Mailbox Settings для немедленной проверки подключения.

Important Notes​

  • При первом подключении, если в почтовом ящике много непрочитанных писем, все они будут импортированы в модуль и сохранены в базе данных Perfex.
  • Это нормально — но первоначальная синхронизация может занять несколько минут.
  • При ограниченных ресурсах сервера возможны временные таймауты во время синхронизации. Просто подождите и обновите страницу через некоторое время.
  • Пользователи OAuth: OAuth-токены автоматически обновляются до истечения срока. При ошибках подключения попробуйте отключить и снова подключить OAuth-аккаунт.
  • Пользователи пароля: Для Gmail и Outlook при включённой 2FA может потребоваться App Password вместо обычного пароля. Подробности см. в разделе Troubleshooting.