Группы управления вызовами (/call_control_group/)

_{Протестировать методы API можно на странице}_{интерактивного обозревателя API}_{и без написания кода}
_{Некоторые ресурсы, описанные на странице, по умолчанию могут быть не доступны из-за типа приложения (см.}_{Создание и авторизация приложений}₎

Данный ресурс предназначен для разграничения возможностей управления текущими вызовами с телефонного терминала: перехвата (pickup), подмены добавочных (phone_replace), подсказки (whisper), прослушки (eavesdrop). Отсутствие правил подразумевает возможность перехвата вызова в пределах всей АТС и запрет на любые другие действия.

Описание структур данных

CallControlPermissions

Имя	Тип	Описание
allow_all	boolean	Позволяет разрешить глобально любые действия при значении true (все могут всех перехватывать, подменять и прослушивать)
pickup_all	boolean	Возможность перехвата вызова в пределах всей АТС (при значении false перехват возможен только в пределах pickup_share_groups). Значение по умолчанию – true
groups	Object	Содержит простое перечисление групп с именами внутренних номеров, внутренние номера могут быть в разных группах. Может быть не более 100 групп, в каждой из которых не более 200 внутренних номеров (проверка на их существование не производится)
pickup_share_groups	array	Группы, внутри которых возможен перехват без указания внутреннего номера, а при "pickup_all": false перехват возможен лишь в пределах групп. Если внутренний номер принадлежит нескольким группам перехвата и от его имени происходит перехват, то группы объединяются в одну
phone_replace_groups	array	Группы, внутри которых есть возможность подмены добавочных с помощью секретного кода.
eavesdrop_{ext}	array	Где суффикс "ext" – имя внутреннего номера: группы, которые может прослушивать внутренний номер ext. Если такой группы не найдено, то действие запрещено
whisper_{ext}	array	Где суффикс "ext" – имя внутреннего номера: группы, в которых внутренний номер ext может подсказывать. Если такой группы не найдено, то действие запрещено

Пример

Создать перехваты:

"100": возможен перехват без указания номера внутренних номеров "102", "101" и с указанием номера всех остальных ("pickup_all": true);
"101": возможен перехват без указания номера внутренних номеров "102", "100" и с указанием номера всех остальных ("pickup_all": true);
"102": возможен перехват без указания номера внутренних номеров "101", "100" и с указанием номера всех остальных ("pickup_all": true).

Создать группу подмены добавочных: "100" может подменять себя на "101" и наоборот

Прослушивание: "101" может прослушивать группы "sales", "hr" (внутренние номера "102", "100" ). Никакие другие внутренние номера АТС не обладают правом прослушивания.

Подсказка: "100" может подключаться к диалогу в режиме подсказки к внутренним номерам группы "support" ("101").

Ответ системы:

Развернуть

{
  "allow_all": false,
  "pickup_all": true,
  "groups": {
    "support": [
      "100",
      "101"
    ],
    "sales": [
      "102",
      "101"
    ],
    "hr": [
      "100",
      "101",
      "103"
    ]
  },
  "pickup_share_groups": [
    "support",
    "sales"
  ],
  "phone_replace_groups": [
    "support"
  ],
  "eavesdrop_100": [
    "support"
  ],
  "whisper_101": [
    "sales",
    "hr"
  ]
}

Ресурсы раздела "Клиент"

PUT /client/{client_id}/call_control_group/

PUT /client/{client_id}/call_control_group/

Параметры URL

Имя	Тип
client_id	string

Параметры JSON

Имя	Тип
call_control_groups	string

GET /client/{client_id}/call_control_group/

GET /client/{client_id}/call_control_group/

Параметры URL

Имя	Тип
client_id	string