Яндекс Почта

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

Папки:
  • Показать доступные папки IMAP и их точные имена для других инструментов Почты.

  • Получить общее число писем и число непрочитанных в указанной папке IMAP.

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

  • Прочитать письмо и метаданные вложений по UID, не помечая письмо прочитанным.

  • Найти письма по фильтрам AND и продолжить поиск с обоими значениями next_cursor.

Вложения:
  • Показать метаданные вложений и секции MIME без скачивания файлов.

  • Скачать вложение в файлы текущей сессии, не помечая письмо прочитанным.

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

Настройки и возможности интеграции:
  • Показать состояние конфигурации без раскрытия токенов и секретов клиентов.

  • Показать доступные интеграции с сервисами Яндекса и их ограничения.

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

Подготовка выполняется администратором GigaCowork.
В витрине интеграций доступны два шаблона для работы с Яндекс Почтой:
  • Яндекс Почта — личная. Для личных аккаунтов Яндекс (доступна только индивидуальная авторизация).

  • Яндекс Почта — корпоративная. Для корпоративных аккаунтов Яндекс.

Для работы требуется созданное OAuth-приложение яндекса.

Для создания приложения:
  1. Перейдите по адресу https://oauth.yandex.ru и авторизуйтесь в учетной записи Яндекс.

  2. Выберите Ваши приложения → Создать и выберите Для авторизации пользователей.

    connector yandex calendar 0
  3. Если аккаунт не верифицирован на Госуслугах, будет предложено его верифицировать. Шаг опциональный.

  4. Укажите название для сервиса, почту и иконку приложения.

    connector yandex calendar 1
  5. Выберите Веб-сервисы и вставьте Redirect URl.

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

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

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

  6. Предоставьте доступ к данным: Доступ к адресу электронной почты и Доступ к логину, имени и фамилии, полу. Также выберите дополнительные доступы для почты, которые будут разрешены в интеграции (начинаются со слова mail):

    • mail:imap_full — Чтение и удаление писем в почтовом ящике.

    • mail:imap_ro — Доступ на чтение писем в почтовом ящике.

    • mail:smtp — Отправка писем через Яндекс.Почту по протоколу SMTP.

    connector yandex calendar 3
  7. Убедитесь, что все данные указаны верно и нажмите Создать приложение.

  8. Если добавляете интеграцию корпоративной почтой, дополнительно активируйте функцию сервисных приложений с помощью запроса:
    POST https://api360.yandex.net/security/v1/org/<org_id>/service_applications/activate.
    Где org_id — ID организации, который можно взять на странице организации, в нижней части меню.

    connector yandex calendar 5
  9. Скопируйте в созданном приложении ClientID и Client secret.

    connector yandex calendar 4
  10. Вставьте полученные ClientID и Client secret в поля ClientID OAuth-приложения и Client secret OAuth-приложения соответственно, в окне добавления интеграции из витрины.

  11. Нажмите Далее, а затем Добавить — интеграция добавится для авторизации пользователями.

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

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

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

  3. Укажите учетные данные вашего аккаунта Яндекс.