Системный пользователь

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

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

Как работает перенос

При увольнении сотрудника с активными вебхуками или приложениями открывается диалог выбора. Администратор выбирает один из двух вариантов:

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

Если сотрудник отредактирует вебхук, работающий от имени системного пользователя, вебхук автоматически переходит к этому сотруднику.

Типы системных пользователей

Существует два типа системных пользователей.

Тип Когда создается
Для вебхуков RESOURCE_TYPE: WEBHOOK При переносе вебхуков уволенного сотрудника
Для приложений RESOURCE_TYPE: APP При переносе приложения из Маркетплейса

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

Для локальных приложений перенос на системного пользователя не поддерживается.

Параметры создаваемого пользователя

Поле Тип Для вебхука Для приложения
NAME string Имя уволенного сотрудника Название приложения
LAST_NAME string Фамилия уволенного сотрудника Пустая строка
GROUP_ID array Наследуется от оригинала Наследуется от оригинала
TIME_ZONE string Наследуется от оригинала Наследуется от оригинала
LANGUAGE_ID string Наследуется от оригинала Наследуется от оригинала
EXTERNAL_AUTH_ID string rest_system rest_system
ACTIVE boolean true true

Видимость системного пользователя

Системный пользователь — технический объект. Он не отображается в списке сотрудников и не находится через поиск в Битрикс24.

Методы user.get и user.search системного пользователя не возвращают, в том числе при фильтрации по полю EXTERNAL_AUTH_ID.

Продолжите изучение