Мы обновили документацию, актуальная версия страницы доступна по ссылке: Группы управления вызовами (/call_control_group/)

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

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

CallControlPermissions

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

Пример

метод

ресурс

данные

ответ

PUT

/client/@me/call_control_group/

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

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

Перехваты:

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

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

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

Ресурсы

Раздел "клиент"

`PUT /client/{client_id}/call_control_group/`

Параметры URL

Имя	Тип
`client_id`	`string`

`GET /client/{client_id}/call_control_group/`

Параметры URL

Имя	Тип
`client_id`	`string`