Workplace

Пользовательские интеграции

Интегрируйте Workplace в существующие рабочие процессы и воспользуйтесь всеми преимуществами API Workplace. Пользовательские интеграции полезны в ситуации, если вы планируете разработку программного продукта для своей организации (или для единственного клиента Workplace по индивидуальному заказу).

Обзор

Пользовательские интеграции в Workplace — это сервисы, которые расширяют функциональность Workplace с помощью API Graph и API Account Management.

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

Пользовательские интеграции также позволяют создавать групповые боты и чат-боты, которые могут общаться в группах в Workplace и Чате Workplace.

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

Маркеры доступа, сгенерированные для пользовательских интеграций, не связаны с пользователем, создавшим маркер. Поэтому таким маркерам не грозит ни истечение срока действия, ни ротация, если пользователи удалены или деактивированы. Маркеры доступа остаются действительными, пока администратор Workplace не выполнит ротацию вручную либо интеграция будет отключена.

Создание приложений для Workplace

API Graph и API Account Management для Workplace представляют собой общедоступные API, к которым может обращаться любой разработчик, умеющий совершать вызовы к API на основе REST. Доступ к этим API контролируется приложениями с определенными разрешениями и защищается маркерами доступа.

Создавать приложения и генерировать маркеры доступа для сообщества Workplace могут только системные администраторы этого сообщества.

Приложения и страницы

При создании пользовательской интеграции создается два объекта:

  • приложение с определенными разрешениями, которые задаются на экране редактирования приложения;
  • страница типа "Бот", которая видна только в пределах сообщества Workplace. Имя страницы соответствует имени пользовательской интеграции, а фото профиля представляет собой значок, который вы выбрали при создании интеграции.

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

Создание пользовательских интеграций

Чтобы создать приложение для Workplace, выполните указанные ниже действия.

  1. На панели администратора откройте вкладку Интеграции.
  2. Нажмите кнопку Создать приложение.
  3. Укажите имя и описание для приложения.
  4. Добавьте фото профиля для приложения. Оно будет использоваться для его визуального представления (например, если приложение размещает публикацию в группе).
  5. Выберите разрешения для своего приложения в зависимости от функций, которые должны быть у вашей интеграции.
  6. Скопируйте и сохраните маркер доступа, который отобразится на экране. Он потребуется вам для совершения вызовов API.

Подробнее

Чтобы узнать больше о создании приложений для Workplace или ознакомиться со сценариями применения пользовательских интеграций, воспользуйтесь ресурсами ниже.