Яндекс 360: организация, Телемост, Формы

Агент управляет организацией Яндекс 360, создаёт видеовстречи и работает с формами — подключение через «Войти через Яндекс».

Что это даёт

Три коннектора для ноды «Интеграция», которые закрывают офисные задачи в экосистеме Яндекса:

  • Яндекс 360 (организация) — агент управляет организацией Яндекс 360 для бизнеса: сотрудники (добавить, изменить, заблокировать), подразделения, группы-рассылки, общие ящики, аудит-лог почты.
  • Яндекс Телемост — агент создаёт видеовстречу и присылает ссылку для подключения, добавляет соорганизаторов, настраивает трансляции.
  • Яндекс Формы — агент создаёт формы и вопросы, публикует их и читает ответы.

Все три подключаются кнопкой «Войти через Яндекс» — API-ключи вводить не нужно.

Что нужно заранее (честно)

  • Все три сервиса работают только с организацией Яндекс 360 для бизнеса (Формы — также с организацией Yandex Cloud). На личном аккаунте Яндекса без организации они не заработают.
  • Яндекс 360 (организация): подключать должен администратор организации — обычному сотруднику API вернёт ошибку доступа (403).
  • Телемост: нужен аккаунт на домене организации Яндекс 360; трансляции доступны только на тарифах с трансляциями.
  • Формы: работают только «Формы для бизнеса»; при подключении понадобится ID организации.

Как подключить

  1. Откройте раздел «Интеграции» → «Подключить сервис».
  2. Выберите нужный сервис — «Яндекс 360 (организация)», «Яндекс Телемост» или «Яндекс Формы» — и дайте подключению название.
  3. Только для Форм: впишите ID организации — заполняется одно из двух полей: ID организации Яндекс 360 или ID организации Yandex Cloud.
  4. Нажмите «Подключить» → на странице Яндекса разрешите доступ.
  5. Подключение появится в списке «Подключённые сервисы».

Где взять ID организации для Форм: Админка Яндекс 360 для бизнеса → внизу левого меню поле «ID организации». Вариант Yandex Cloud — только если ваша организация заведена в Yandex Cloud.

Что умеет агент

Яндекс 360 (организация)

  • Список организаций — отсюда агент берёт ID организации для остальных операций.
  • Сотрудники: список, карточка, добавить, изменить (в т.ч. заблокировать/разблокировать).
  • Подразделения: список, создать.
  • Группы-рассылки: список, создать, добавить участника.
  • Общие почтовые ящики: список.
  • Аудит-лог почты: кто, когда и что отправил/получил/прочитал.

Яндекс Телемост

  • Создать видеовстречу (в т.ч. с трансляцией) — в ответе ссылка для участников.
  • Получить информацию о встрече, изменить её настройки.
  • Соорганизаторы: посмотреть, добавить, заменить, удалить.

Яндекс Формы

  • Создать форму, добавить вопросы (текст, выбор из вариантов, шкала-матрица).
  • Опубликовать форму и снять с публикации.
  • Прочитать ответы: постраничный список или один ответ по его ID.

Полезно знать

  • Яндекс 360: почти каждой операции нужен числовой ID организации — агент получает его операцией «Список организаций» (или посмотрите в Админке 360 внизу левого меню).
  • Телемост: удалить встречу через API нельзя — только создать, изменить и посмотреть.
  • Формы: списка всех форм в API нет — ID формы виден в адресе формы в конструкторе Яндекс Форм.
Разворачиваете Дирижёр самостоятельно?

Подключение идёт через то же приложение Яндекса, что и для Яндекс.Диска/Трекера (YANDEX_OAUTH_CLIENT_ID). На oauth.yandex.ru приложению нужно добавить права (scope):

  • Яндекс 360 (организация): directory:read_organization, directory:read_users, directory:write_users, directory:read_departments, directory:write_departments, directory:read_groups, directory:write_groups, ya360_admin:mail_read_shared_mailbox_inventory, ya360_security:audit_log_mail.
  • Телемост: telemost-api:conferences.create, telemost-api:conferences.read, telemost-api:conferences.update.
  • Формы: forms:read, forms:write.

Redirect URI приложения: {ваш-адрес}/api/connectors/oauth/callback.