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

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

Для управления пользователями по API необходимо:

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

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

Или использовать описание нашего публичного API в формате openapi

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

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

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

‍