Продвинутое администрирование по API

В Пачке можно полностью автоматизировать управление сотрудниками. Это сильно упрощает процессы в больших командах. Вам не нужно будет вручную добавлять и удалять пользователей, приглашать и удалять их из чатов и менять важную информацию в профилях — все это могут автоматизировать ваши технические специалисты с помощью открытого API Пачки.

Для управления пользователями по API необходимо:
1. Создать сервисную учетную запись в системе, от лица которой будут производиться действия по управлению пользователями
2. Назначить ей роль "Администратор"  в разделе "Компания" -> "Сотрудники"
3. Получить Acсess Token для учетной записи в разделе "Автоматизации" -> "API"

Управление пользователями

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

  • Добавлять нового сотрудника в Пачку при трудоустройстве и отправлять ему приглашение в Пачку по почте.
  • Удалять сотрудника из Пачки при увольнении.
  • Настраивать уровень доступа сотрудника. Например, если вы добавляете партнера, который не должен иметь доступ к корпоративной информации, то ему можно назначить гостевой доступ. А если хотите дать сотруднику расширенные права на администрирование, то можно назначить доступ администратора.
  • Обновлять информацию о сотруднике при смене должности или руководителя.
  • Задавать общий стандарт имен сотрудников. Например, в AD у вас пользователи на латинице, а вы хотите, чтобы в Пачке все имена были на кириллице.
  • Получать информацию о сотруднике (имя, почта, уровень доступа и т.д.).

Для управления пользователями подходят следующие методы:

  • POST api/shared/v1/users — создание пользователей с актуальной корпоративной информацией в профиле
  • DELETE api/shared/v1/users — удаление пользователей
  • PUT api/shared/v1/users — обновление пользователей в Пачке (изменение полей, изменение ролей, приостановление доступов)
  • GET api/shared/v1/users — получение списка пользователей в Пачке, либо пользователей по email

Управление беседами и каналами

Через API можно управлять беседами и каналами в вашей компании. Что можно делать:

  • Добавлять новых сотрудников в чаты своей команды.
  • Удалять сотрудника из чатов и добавлять в новые при переходе в другую команду/отдел.
  • Получать список всех чатов в системе, чтобы контролировать список участников и основные параметры беседы (описание, открытая/закрытая, добавленные теги и интеграции).
  • Получать состав участников чата, название и другие параметры чатов.
  • Получать список сообщений бесед, каналов, обсуждений, личных сообщений и поставленных реакций по идентификатору чата.

    Важно! Вы можете получить список всех открытых чатов.  Из закрытых вы можете получить только те чаты, в которых будет состоять сервисная учетная запись.
  • Обновлять основные параметры чата. Например, для удобства все важные чаты в компании вы называете через #info и хотите автоматически проставлять такую пометку в названии.

    Важно!
    Вы можете менять параметры только тех чатов, в которых сервисная учетная запись будет назначена администратором.

Для управления беседами и каналами подходят следующие методы:

  • GET api/shared/v1/chats — список каналов
  • POST api/shared/v1/chats/{chat.id}/members — добавление пользователей в канал
  • DELETE api/shared/v1/chats/{chat.id}/members — удаление пользователя из канала

Управление групповыми тегами

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

С помощью автоматизированного управления тегами можно:

  • Создавать необходимые теги и присваивать их сотрудникам. Например, всем сотрудникам команды DevOps можно назначить тег DevOps.
  • Получать полный список тегов с названиями, идентификаторами и количеством сотрудников, которым назначен тег.
  • Добавлять теги в нужные каналы и беседы. Таким образом команду DevOps можно добавить во все обязательные чаты для DevOps. Тогда в таких чатах тег можно будет упоминать, а участники тега не смогут выйти из этого чата.
  • Исключать теги из чата.

Для управления групповыми тегами подходят следующие методы:

  • PUT api/shared/v1/users/chats/{id}/group_tags — добавление тегов в чат
  • DELETE api/shared/v1/users/chats/{id}/group_tags — исключение тегов из чата
  • PUT api/shared/v1/users — обновление пользователей в Пачке (создание тегов и присвоение тегов пользователям)

Все указанные методы можно посмотреть в открытой документации API Пачки
Обновлено 
27.9.2023