Сотрудники

Получить список всех сотрудников аккаунта

GET /v1.3/managers

После успешного выполнения возвращается массив объектов, описывающих сотрудников.

id integer Идентификатор сотрудника
name string Название организации или имя пользователя
login string Email сотрудника
role string Роль сотрудника в системе: owner (владелец) или manager (менеджер)
confirmed bool Флаг, отображающий подтвержден ли аккаунт
allowAllDeals bool Флаг, отображающий есть ли доступ к обращениям всех операторов в рамках доступных интеграций
sources массив объектов Массив доступов к подключенным интеграциям (Если пустой, значит доступны все)
  • id
integer Идентификатор записи о доступе к интеграции
  • saId
integer Идентификатор интеграции (Если null, значит все не доступны)

Пример:

GET https://api.umnico.com/v1.3/managers

Response:

[
    {
      "id": 15,
      "login": "first-manager@company.com",
      "name": "Первый менеджер",
      "role": "owner",
      "confirmed": true,
      "allowAllDeals": false,
      "allowedUsers": null,
      "sources": []
    },
    {
        "id": 18,
        "login": "second-manager@company.com",
        "name": "Второй менеджер",
        "role": "manager",
        "confirmed": true,
        "allowAllDeals": false,
        "allowedUsers": null,
        "sources": [
            {
                "id": 27,
                "saId": 13
            }
        ]
    },
]

Добавить сотрудника

POST /v1.3/managers

Тело запроса:

  • login - email, на который придет приглашение для регистрации в Umnico
  • sources - массив объектов - массив доступов к подключенным интеграциям (если пустой, значит доступны все)

Если передать одну единственную запись в массиве доступов, где saId = null, то таким образом менеджеру становятся недоступны все аккаунты. После успешного выполнения возвращается массив объектов, описывающих сотрудников (см. выше).


Пример:

POST https://api.umnico.com/v1.3/managers

Body:

{
    "login": "ggg@aaa.com",
    "sources": [
      {
        "saId": null
      }
    ]
}

Response:

[
    {
      "id": 15,
      "login": "first-manager@company.com",
      "name": "Первый менеджер",
      "role": "owner",
      "confirmed": true,
      "allowAllDeals": false,
      "allowedUsers": null
    },
    {
        "id": 18,
        "login": "second-manager@company.com",
        "name": "Второй менеджер",
        "role": "manager",
        "confirmed": true,
        "allowAllDeals": false,
        "allowedUsers": null
    },
    {
        "id": 20,
        "login": "third-manager@company.com",
        "name": null,
        "role": "manager",
        "confirmed": false,
        "allowAllDeals": false,
        "allowedUsers": null
    },
]

Изменить доступы к подключенным интеграциям

PUT /v1.3/managers/<id>

  • id - идентификатор сотрудника

Тело запроса:

  • sources - массив объектов - массив доступов к подключенным интеграциям (если пустой, значит доступны все)

Пример:

PUT https://api.umnico.com/v1.3/managers/18

Body:

{
   "sources":
      [
         {
            "id": 27,
            "saId": 13
         },
         {
            "saId": 75
         }
      ]
}

Response: status 200


Изменить доступ менеджера к сделкам других менеджеров аккаунта

PUT /v1.3/managers/users-access/<id>

  • id - идентификатор сотрудника

Тело запроса:

  • allowedUsers - массив идентификаторов - массив идентификаторов сотрудников, к которым текущий сотрудник имеет доступ (если массив пустой, значит нет доступа к сделкам других менеджеров)
    • id - идентификатор сотрудника к сделкам которого предоставляется доступ (например: [1, 2, 3])

Примечание

Массив переписывается каждый раз при вызове метода, например, если вы вызвали метод, передав [1, 2, 3], а следом - [1], то конечным результатом будет [1].


Пример:

PUT https://api.umnico.com/v1.3/managers/users-access/18

Body:

{
   "allowedUsers": [15]
}

Response: status 200


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

DELETE /v1.3/managers/<id>

  • id - идентификатор сотрудника

Пример:

DELETE https://api.umnico.com/v1.3/managers/20

Response: status 200