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

Данный ресурс позволяет получать информацию о текущих вызовах добавочного номера, а также управлять этими вызовами.

Описание полей

Имя	Тип	Описание
`call_api_id`	`string`	Идентификатор вызова для последующего управления
`record_uuid`	`string`	Идентификатор записи разговора
`call_flow`	`string`	Направление вызова. Принимает значение "in" или "out"
`called_number`	`string`	Набранный номер
`called_did`	`string`	Внешний номер, на который был осуществлён вызов
`init_time_gmt`	`string`	Дата и время инициализации вызова
`answer_time_gmt`	`string`	Дата и время ответа вызова
`caller_id_number`	`string`	Номер звонящего
`caller_id_name`	`string`	Имя звонящего
`caller_extension`	extension	Информация о вызывающий добавочном номере
`called_extension`	`extension`	Информация о вызываемом добавочном номере
`real_call`	`boolean`	При значении "false", хоть вызов и закреплен за добавочным, но диалога не ведет (например, была переадресация на мобильный номер)

Управление вызовом

Для того, чтобы обновить текущий необходимо выполнить API-запрос PUT на следующий URL, указав extension_id и call_api_id:

PUT /extension/{extension_id}/current_calls/{call_api_id}

В теле запроса должны быть переданы параметры action и send_dst.

Действия по управлению вызовом

Действие	Описание
`transfer`	"Слепой" перевод вызова на указанный в send_dst номер.
attended_transfer	Перевод вызова "с сопровождением" на указанный в send_dst номер.
`eavesdrop`	Прослушивание вызова. При API-запросе вызывается указанный в send_dst номер, при снятии трубки абонент слышит телефонный разговор.
`whisper`	Обращение к участнику вызова (суфлирование). При API-запросе вызывается указанный в send_dst номер, при снятии трубки абонент может обращаться к участнику вызова.
conference	Обращение к обоим участникам вызова (конференция). При API-запросе вызывается указанный в send_dst номер, при снятии трубки абонент может обращаться к участникам вызова.
`hold`	Постановка вызова на удержание
`offhold`	Снятие вызова с удержания
`park`	Парковка вызова
`pickup`	Перехват вызова. При API-запросе вызывается указанный в send_dst номер, при снятии трубки абонент соединяется с участником вызова.

Прерывание вызова

Для того, чтобы прервать текущий вызов, необходимо выполнить API-запрос DELETE на следующий URL, указав extension_id и call_api_id:

DELETE /extension/{extension_id}/current_calls/{call_api_id}

Ресурсы раздела "Добавочный"

`GET /extension/{extension_id}/current_calls/`

Получить список вызовов для добавочного типа "телефонный терминал"

Параметры URL

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

Поля ответа

Имя	Тип
`call_list`	`array [call_mdl]`

`PUT /extension/{extension_id}/current_calls/{call_api_id`}

Обновить вызов

Параметры URL

Имя	Тип
`call_api_id`	`string`
`extension_id`	`string`

Параметры JSON

Имя	Тип	Обязательный
`action`	`string`	`да`
`send_dst`	`string`	`нет`

`DELETE /extension/{extension_id}/current_calls/{call_api_id`}

Прервать вызов

Параметры URL

Имя	Тип
`call_api_id`	`string`
`extension_id`	`string`

Текущие вызовы (/current_calls/)

Описание полей

Управление вызовом

Действия по управлению вызовом

Прерывание вызова

Ресурсы раздела "Добавочный"

GET /extension/{extension_id}/current_calls/

Параметры URL

Поля ответа

PUT /extension/{extension_id}/current_calls/{call_api_id}

Параметры URL

Параметры JSON

DELETE /extension/{extension_id}/current_calls/{call_api_id}

Параметры URL

`GET /extension/{extension_id}/current_calls/`

`PUT /extension/{extension_id}/current_calls/{call_api_id`}

`DELETE /extension/{extension_id}/current_calls/{call_api_id`}