Перейти к содержимому
AISARAISAR
Пользователи и команда

Пользователи и команда

Роль участника изменена

user.role_changed

Срабатывает, когда участнику компании назначают другую роль — администратором компании в кабинете или партнёром, который обслуживает компанию. Событие приходит только при фактической смене роли: повторное назначение той же роли события не создаёт (так с 29.09.2026; раньше событие отправлялось на каждое сохранение, в том числе без изменений, и без полей `previous_role` и `source`). Поле `new_role` не изменилось. Роль может быть системной (`admin`, `manager`, `agent`) или своей (`custom:<ulid>`); для читаемого названия есть `new_role_name` и `previous_role_name`. Событие также приходит каждому участнику, которого перевели на другую роль при удалении своей роли (`source: "role_deleted"`).

HTTP-запрос

AISAR отправляет подписанный POST-запрос на ваш webhook_url:

http
POST {webhook_url}
Content-Type: application/json
X-AISAR-Signature: sha256=...

{
  "event": "user.role_changed",
  "event_id": "evt_01JXXXXXXXXXXXXXXXXXXXXX",
  "timestamp": "2026-09-29T12:00:00.000000Z",
  "company_id": 1,
  "data": {
    "user": {
      "id": 55,
      "name": "Aliya Seitova",
      "email": "aliya@example.com",
      "availability": "online"
    },
    "new_role": "admin",
    "new_role_name": "Admin",
    "previous_role": "agent",
    "previous_role_name": "Agent",
    "source": "company"
  }
}

Заголовок X-AISAR-Signature содержит HMAC-SHA256 подпись тела запроса — используйте её, чтобы убедиться, что запрос пришёл от AISAR.

Пример payload

json
{
  "event": "user.role_changed",
  "event_id": "evt_01JXXXXXXXXXXXXXXXXXXXXX",
  "timestamp": "2026-09-29T12:00:00.000000Z",
  "company_id": 1,
  "data": {
    "user": {
      "id": 55,
      "name": "Aliya Seitova",
      "email": "aliya@example.com",
      "availability": "online"
    },
    "new_role": "admin",
    "new_role_name": "Admin",
    "previous_role": "agent",
    "previous_role_name": "Agent",
    "source": "company"
  }
}

Поля payload

ПолеТипОписание
user.idintegerID участника, чья роль изменилась
user.namestringПолное имя (имя + фамилия)
user.emailstringEmail пользователя
user.availabilitystring|nullТекущий статус доступности: `online`, `away`, `offline` или `busy`
new_rolestringРоль, назначенная участнику: `admin`, `manager`, `agent` или ключ своей роли `custom:<ulid>`
previous_rolestring|nullРоль участника до изменения; `null`, если роли не было
new_role_namestringНазвание назначенной роли: `Admin`, `Manager`, `Agent` для системных или заданное название своей роли
previous_role_namestring|nullНазвание прежней роли; `null`, если роли не было
sourcestringКто изменил роль: `company` — администратор компании в кабинете AISAR; `partner` — партнёр, который обслуживает компанию; `role_deleted` — администратор удалил свою роль, участник переведён на заменяющую