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

user.role_changed

Срабатывает, когда участнику компании назначают другую роль — администратором компании в кабинете или партнёром, который обслуживает компанию. Событие приходит только при фактической смене роли: повторное назначение той же роли события не создаёт (так с 29.09.2026; раньше событие отправлялось на каждое сохранение, в том числе без изменений, и без полей `previous_role` и `source`). Поле `new_role` не изменилось.

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@company.kz",
      "availability": "online"
    },
    "new_role": "admin",
    "previous_role": "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@company.kz",
      "availability": "online"
    },
    "new_role": "admin",
    "previous_role": "agent",
    "source": "company"
  }
}

Поля payload

Поле	Тип	Описание
`user.id`	`integer`	ID участника, чья роль изменилась
`user.name`	`string`	Полное имя (имя + фамилия)
`user.email`	`string`	Email пользователя
`user.availability`	`string\|null`	Текущий статус доступности: `online`, `away`, `offline` или `busy`
`new_role`	`string`	Роль, назначенная участнику, например `admin`, `manager` или `agent`
`previous_role`	`string\|null`	Роль участника до изменения; `null`, если роли не было
`source`	`string`	Кто изменил роль: `company` — администратор компании в кабинете AISAR; `partner` — партнёр, который обслуживает компанию