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