ДокументацияСотрудники и роли

Сотрудники и роли

4 минПоследнее обновление: 2026-03-31

Модель сотрудника

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

Роли и доступ к агентам

Роли определяют, какими агентами может пользоваться сотрудник. При создании роли укажите список ID агентов, к которым она дает доступ:

POST /api/v1/groups/:groupId/roles
{
  "name": "Customer Service Rep",
  "agent_access": [
    "agent-uuid-1",
    "agent-uuid-2"
  ]
}

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

Юрисдикция

Юрисдикция определяет, к данным каких подгрупп сотрудник имеет доступ:

  • null: только своя группа. Сотрудник видит данные только своей группы.
  • ["all"]: все дочерние группы. Сотрудник видит данные своей группы и всех групп ниже нее.
  • [12, 34]: конкретные группы. Сотрудник видит данные только перечисленных групп.

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

Вход в портал сотрудников

Сотрудники входят в портал по адресу /portal/g/:slug. Для аутентификации используется JWT с областью действия портала (тип: portal, срок действия 8 часов), полностью отделенный от аутентификации платформы и покупателей.

Была ли эта статья полезна?