Mail.ru

Интеграция позволяет работать с письмами в Почте Mail.ru. Для входа доступны пароль внешнего приложения (Basic) и OAuth 2.0.

Доступные операции

Статус сервера:
  • Проверка входа и число писем Inbox.

Чтение и поиск писем:
  • Последние письма Inbox, при необходимости за диапазон дат.

  • Поиск по теме, отправителю и диапазону дат в указанной папке.

  • Текст письма и метаданные вложений.

Вложения:
  • Содержимое вложения в base64 в пределах лимита.

  • Запись вложения в файлы текущей сессии через write_url.

Управление письмами и папками:
  • Папки и их IMAP-идентификаторы.

  • Признак прочтения.

  • Перемещение в существующую папку.

  • Перемещение в корзину.

Отправка писем:
  • Немедленная отправка письма с необязательными вложениями и сохранение копии в «Отправленных».

Черновики:
  • Сохранение черновика с необязательными вложениями без отправки.

  • Добавление файла к существующему черновику с возвратом нового ID.

Подготовка и добавление из витрины

Подготовка выполняется администратором GigaCowork и только если интеграция добавляется с авторизаций OAuth 2.0.

Для авторизации через OAuth 2.0 предварительно нужно создать приложение в кабинете OAuth Mail.

Для создания приложения:
  1. Откройте кабинет OAuth Mail по адресу https://o2.mail.ru/app/.

  2. Нажмите Создать приложение.

    connector mailru 6
  3. Укажите:

    • Название проекта — любое название.

    • Все redirect_uri — Redirect URl из подключаемой интеграции.

      Где взять Redirect URl:
      1. В разделе button settings Администрирование → button blocks Интеграции нажмите Добавить интеграцию.

      2. В витрине интеграций откройте подключаемую интеграцию.

      3. Нажмите Далее и скопируйте значение из поля Callback URL.

    • Примите лицензионное соглашение

      connector mailru 7
  4. Нажмите Подключить сайт.

  5. Включите чекбокс Доступ к почтовому ящику по IMAP, POP и SMTP и нажмите Сохранить изменения.

    connector mailru 8
  6. Скопируйте ID Приложения / Client ID и Секрет / Client Secret.

  7. Вставьте полученные ClientID и Client secret в поля ClientID приложения Mail.ru и Client secret OAuth-приложения соответственно, в окне добавления интеграции из витрины.

  8. Нажмите Далее, а затем Добавить.

Авторизация в интеграции

Подготовка

Для работы интеграции включите доступ к почте по SMTP.

Если администратор GigaCowork добавил интеграцию с авторизацией по логину и паролю, дополнительно создайте пароль для внешних приложений.
Для настройки доступа по SMTP:
  1. Откройте Настройки → Все настройки → Безопасность и найдите раздел Внешние сервисы.

    connector mailru 3
  2. Включите доступ по SMTP.

    connector mailru 4

Создание пароля для внешних приложений.

Если администратор GigaCowork добавил интеграцию с авторизацией по логину и паролю, для работы интеграции в личном кабинете Mail.ru необходимо создать пароль для внешних приложений.
Для создания пароля внешних приложений:
  1. Войдите в свою почту Mail.ru через браузер на вашем устройстве.

  2. Откройте Настройки → Все настройки → Безопасность и найдите раздел Пароли для внешних приложений.

    connector mailru 0
  3. Придумайте название для пароля (например, GigaCowork), чтобы потом понять, для чего он.

  4. Нажмите Продолжить и на шаге Настройка доступа выберите Полный доступ к почте

  5. Подтвердите ваш основной пароль от аккаунта Mail.ru.

    connector mailru 1
  6. Mail.ru сгенерирует пароль — сразу скопируйте его, он показывается только один раз.

connector mailru 2

Авторизация

Для работы с интеграцией:
  1. Проверьте, что интеграция находится в разделе button grid 2x2 Каталоги → button blocks Интеграции. Если ее нет, попросите администратора GigaCowork ее включить.

  2. Откройте интеграцию и нажмите Войти в аккаунт. Интеграция уже может быть авторизована администратором, а кнопка входа и выхода из аккаунта недоступна. Это означает, что с ней уже можно работать.

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

      connector mailru 5
    • Для авторизации по OAuth 2.0 — подтвердите доступ к личным данным.

      connector mailru 9