AISARAISAR
REST API

Команды и пользователи

Управление командами (группировка операторов + доступ к каналам), участниками компании и приглашениями новых пользователей по email. Роль назначается на уровне компании (admin/manager/agent) через Spatie permissions с teams-режимом — один пользователь может состоять в нескольких компаниях с разными ролями. Публичные шаги разрешения приглашения (resolve/context/intent, без auth) в этот справочник не включены — см. руководство по приглашениям.

Эндпоинты

МетодПуть
GET/v1/teams

Список команд

POST/v1/teams

Создание команды

GET/v1/teams/{team}

Получение команды

PATCH/v1/teams/{team}

Обновление команды

DELETE/v1/teams/{team}

Удаление команды

GET/v1/companies/current/members

Список участников текущей компании

POST/v1/companies/current/members/{memberId}/role

Смена роли участника

POST/v1/companies/current/members/{memberId}/revoke

Отзыв членства участника

GET/v1/users

Список пользователей текущей компании (без сервисных аккаунтов)

POST/v1/invitations

Отправка приглашения (email + роль)

POST/v1/invitations/{guid}/accept

Принятие приглашения

POST/v1/invitations/{guid}/decline

Отклонение приглашения

POST/v1/invitations/{invitationId}/role

Смена роли в приглашении

POST/v1/invitations/{invitationId}/revoke

Отзыв приглашения

DELETE/v1/invitations/{invitationId}

Удаление приглашения

Примеры

Приглашение нового пользователя

Запрос

bash
curl -X POST https://api.aisar.app/v1/invitations \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "new.agent@example.com",
    "role": "agent"
  }'

Ответ

json
{
  "data": {
    "message": "Invitation sent.",
    "invitation": {
      "id": 77,
      "guid": "b6e2a4d0-1234-4a90-9e21-5d3f0c8a9b11",
      "invite_url": "https://my.aisar.app/invitation/b6e2a4d0-1234-4a90-9e21-5d3f0c8a9b11",
      "email": "new.agent@example.com",
      "role": "agent",
      "expires_at": "2026-03-22T10:00:00.000000Z"
    }
  }
}

Создание команды

Запрос

bash
curl -X POST https://api.aisar.app/v1/teams \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Support",
    "description": "Customer success team",
    "channel_access_mode": "custom",
    "channel_ids": [7, 9],
    "member_ids": [5, 6]
  }'

Ответ

json
{
  "data": {
    "message": "Team created.",
    "team": {
      "id": 3,
      "company_id": 1,
      "name": "Support",
      "description": "Customer success team",
      "channel_access": { "mode": "custom", "channel_ids": [7, 9] },
      "member_ids": [5, 6],
      "created_at": "2026-03-15T10:00:00.000000Z",
      "updated_at": "2026-03-15T10:00:00.000000Z"
    }
  }
}