Интеграция с электронной почтой для виджета переписок

Данный раздел описывает настройку интеграции системы с электронной почтой для работы с переписками. Работа осуществляется в разделе Настройки → Интеграции → Интеграции сообщений веб-интерфейса системы.

Об интеграциях сообщений

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

При настройке интеграции между системой и внешними сервисами через внутреннюю шину сообщений устанавливается соединение, необходимое для отправки и получения сообщений. Внутренняя шина сообщений является связующим звеном между системой и используемым транспортом. Она обеспечивает соединение и передачу сообщений между системой и внешними сервисами: для транспорта email — почтовыми серверами SMTP, IMAP и POP3.

В данной статье рассматривается почтовая интеграция, предназначенная для подключения системы к инфраструктуре электронной почты.

Интерфейс раздела

Панель инструментов раздела включает следующие компоненты:

  • Кнопка plus позволяет создать новую интеграцию.

  • Кнопка Удалить (trash) позволяет удалить из списка интеграции, напротив которых установлены флажки. Кнопка становится доступной после выбора хотя бы одной интеграции из списка.

  • Поле Поиск предназначено для быстрого поиска интеграций в отображаемом списке по имени.

В рабочей области раздела отображается таблица имеющихся интеграций. Таблица содержит следующие столбцы:

  • Имя — название интеграции. Рекомендуется указывать человекочитаемое название, однако допустимо совпадение названия с адресом.

  • Включить — флажок, указывающий на то, включена или выключена интеграция.

При работе с таблицей интеграций доступны следующие операции:

Работа с интеграциями сообщений

Доступные операции над интеграциями сообщений:

Создание почтовой интеграции

Чтобы создать почтовую интеграцию:

  1. Перейдите в раздел Настройки → Интеграции → Интеграции сообщений. Система отобразит список существующих интеграций.

  2. Нажмите на кнопку plus и выберите из выпадающего списка опцию Почтовая интеграция. Отобразится окно создания интеграции.

  3. При необходимости выберите организацию, к которой должна принадлежать интеграция. Если организация не выбрана, интеграция будет доступна во всех организациях.

  4. Введите название интеграции.

  5. Выберите тип интеграции из выпадающего списка. Доступные типы:

    • Исходящая;

    • Входящая.

  6. Укажите почтовый сервер для соединения с внутренней шиной сообщений.

  7. Выберите протокол, который внутренняя шина сообщений использует для подключения к почтовому серверу. Доступные протоколы:

    • EWS;

    • POP3;

    • IMAP.

  8. Введите порт, на котором почтовый сервер принимает соединения по выбранному протоколу.

  9. Укажите метод авторизации между внутренней шиной сообщений и почтовым сервером. Доступные варианты:

    • Basic;

    • OAuth2;

    • NTLM;

    • No auth;

    • Plain;

    • Login;

    • Cookie.

  10. Укажите логин и пароль, если в качестве методов авторизации был выбран один из следующих вариантов:

    • Basic;

    • Login;

    • NTLM;

    • Cookie;

    • Plain.

    • Логин — учетная запись почтового ящика, от имени которого ведется переписка.

    • Пароль — пароль от почтового ящика.

  11. В поле Client ID укажите идентификатор и токен, если в качестве методов авторизации был выбран вариант OAuth2.

    • Поле Client ID — идентификатор приложения при аутентификации OAuth2.

    • Токен — токен доступа при аутентификации OAuth2.

  12. Если необходимо, выберите из выпадающего списка тип шифрования между системой и почтовым сервером. Доступные типы:

    • Отсутствует;

    • SSL/TLS;

    • STARTTLS.

  13. Если вы указали тип шифрования для вашего соединения, выберите из выпадающего версию протокола SSL/TLS. Доступные версии:

    • Отсутствует;

    • TLS 1.2;

    • TLS 1.3.

  14. Установите переключатель Проверить подлинность сертификата в активное положение, если требуется проверить подлинность сертификата SSL/TLS.

  15. Нажмите на поле Сертификат, чтобы прикрепить сертификат центра сертификации.

  16. Установите переключатель Использовать прокси-сервер в активное положение, если необходимо обеспечить соединение системы с почтовым сервером через прокси-сервер. Для этого заполните следующие поля:

    • Протокол (прокси) — выберите один из доступных вариантов:

      • HTTP;

      • HTTPS;

      • SOCKS4;

      • SOCKS5.

    • Сервер (прокси);

    • Порт (прокси);

    • Логин (прокси);

    • Пароль (прокси).

  17. Введите название группы воркеров, на которой будет выполняться интеграция.

  18. Установите переключатель Запуск по расписанию в активное положение, если требуется включить интеграцию сразу после ее создания.

    Данный переключатель запускает триггер на основе полей, заполняемых ниже.

  19. Выберите часовой пояс из выпадающего списка.

  20. Выберите формат расписания, на основании которого будет запускаться интеграция. Доступные форматы:

    • Cron-выражение;

    • Расписание.

  21. Если была выбрана опция Cron-выражение, задайте cron-выражение для запуска интеграции по расписанию.

  22. Если была выбрана опция Расписание, выполните следующие шаги:

    1. Выберите режим запуска интеграции из выпадающего списка. Доступные режимы:

      • Каждый месяц;

      • Каждую неделю;

      • Каждый день;

      • Каждый час;

      • Каждую минуту.

    2. Введите интервал повторения — период между запусками в единицах времени.

    3. Введите дни повторения запуска через запятую.

    4. Выберите день недели из выпадающего списка.

    5. Выберите время запуска интеграции.

      Доступны интервалы в 15 минут с 00:00 до 24:00.

  23. Нажмите на кнопку Добавить. Система создаст интеграцию и отобразит соответствующее уведомление. Новая интеграция отобразится в списке раздела.

Просмотр почтовой интеграции

Чтобы просмотреть настройки почтовой интеграции:

  1. Перейдите в раздел Настройки → Интеграции → Интеграции сообщений. Система отобразит список существующих интеграций.

  2. Нажмите на строку интеграции в списке. Система отобразит в правой части экрана карточку этой интеграции с подробной информацией о ней.

В верхней части карточки отображается название интеграции. Справа от названия расположена кнопка more vertical, при нажатии на которую открывается выпадающее меню с действиями, доступными для выбранной интеграции.

Карточка интеграции содержит следующие вкладки:

  • Основное — основная информация об интеграции.

  • История — история выполненных с интеграцией операций.

  • Конфигурация — информация о внутренних настройках интеграции.

Вкладка Основное

На вкладке Основное отображаются основные параметры интеграции:

  • Организация — организация, к которой принадлежит интеграция.

  • Название — имя интеграции. Как правило, указывается в формате: <протокол интеграции:логин>.

  • Тип интеграции — определяет направление взаимодействия внутренней шины сообщений с почтовой системой. Доступные варианты:

    • Исходящая — возможность отправки писем из системы.

    • Входящая — возможность поступления писем в систему.

  • Проверить соединение (check) — нажмите на кнопку, чтобы проверить соединение системы с почтовым сервером. Результат отображается в полях Статус подключения и Детали подключения.

  • Статус подключения — заполняется автоматически в результате проверки соединения с почтовым сервером. Доступные варианты:

    • Успешно — соединение с сервером выполнено успешно.

    • Ошибка — ошибка соединения с сервером.

  • Детали подключения — подробные детали подключения по интеграции. Заполняется автоматически после проверки соединения в случае ошибки.

  • Почтовый сервер — почтовый сервер, с которым внутренняя шина сообщений устанавливает соединение по выбранному протоколу: SMTP, IMAP или EWS.

  • Протокол — протокол, который внутренняя шина сообщений использует для подключения к почтовому серверу. Доступные протоколы:

    • EWS;

    • POP3;

    • IMAP.

  • Порт — сетевой порт, на котором почтовый сервер принимает соединения по выбранному протоколу.

  • Метод авторизации — метод авторизации между внутренней шиной сообщений и почтовым сервером. Доступные варианты:

    • Basic;

    • OAuth2;

    • NTLM;

    • No auth;

    • Plain;

    • Login;

    • Cookie.

  • Логин — учетная запись почтового ящика, от имени которой ведется переписка в системе.

  • Пароль — пароль от почтового ящика.

  • Client ID — идентификатор приложения при методе авторизации OAuth2.

  • Токен — токен доступа при методе авторизации OAuth2.

  • Шифрование — тип шифрования между внутренней шиной сообщений и почтовым сервером. Доступные типы:

    • Отсутствует;

    • SSL/TLS;

    • STARTTLS.

  • Версия SSL/TLS — версия протокола шифрования SSL/TLS. Доступные версии:

    • Отсутствует;

    • TLS 1.2;

    • TLS 1.3.

  • Проверять подлинность сертификата — определяет, требуется ли проверить подлинность сертификата SSL/TLS при установке соединения почтового сервера с внутренней шиной сообщений.

  • Сертификат — наименование файла прикрепленного сертификата.

  • Использовать прокси-сервер — определяет, необходимо ли обеспечить соединение между внутренней шиной сообщений и почтовым сервером через прокси-сервер.

  • Протокол (прокси) — протокол прокси-сервера, участвующего в соединении между внутренней шиной сообщений и почтовым сервером.

  • Сервер (прокси) — адрес прокси-сервера, участвующего в соединении между внутренней шиной сообщений и почтовым сервером.

  • Порт (прокси) — значение TCP-порта, на котором прокси-сервер принимает соединения.

  • Логин (прокси) — учетная запись для аутентификации на прокси-сервере.

  • Пароль (прокси) — пароль от учетной записи для аутентификации на прокси-сервере.

  • Запуск по расписанию — определяет, происходят ли запуски интеграции по заданному расписанию или интеграция выключена.

  • Часовой пояс — часовой пояс для времени запуска интеграции.

  • Формат расписания — формат расписания для запуска интеграции. Доступные форматы:

    • Cron-выражение;

    • Расписание.

  • Cron-выражение — cron-выражение для запуска интеграции по расписанию.

    Данное поле становится активным при выборе опции Cron-выражение в поле Формат расписания.

  • Запускать — режим запуска интеграции. Доступные значения:

    • Каждый месяц;

    • Каждую неделю;

    • Каждый день;

    • Каждый час;

    • Каждую минуту.

    Данное поле становится активным при выборе опции Расписание в поле Формат расписания.

  • Интервал повторения — количество единиц времени между последовательными запусками интеграции.

    Данное поле становится активным при выборе опции Расписание в поле Формат расписания.

Вкладка История

На вкладке отображается история операций с интеграцией. Информация загружается в зависимости от выбранных дат.

Вкладка Конфигурация

На вкладке отображается поле Группа воркеров — логическое объединение воркеров, на которых будет выполняться данная интеграция.

Изменение почтовой интеграции

Вы можете изменить поля интеграции через меню действий или кнопку редактирования в карточке интеграции.

Удаление почтовой интеграции

Вы можете удалить интеграцию через меню действий или выполнить массовое удаление интеграций.

Была ли полезна эта страница?

+7 (499) 755 55 70 sales@rvision.ru

О компании Пользовательское соглашение Политика cookies

Обратная связь