Данный ресурс позволяет получать информацию о текущих вызовах добавочного номера, а также управлять этими вызовами.
Описание полей
Имя | Тип | Описание |
---|---|---|
call_api_id | string | Идентификатор вызова для последующего управления |
other_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 | Информация о вызываемом добавочном номере |
Управление вызовом
Для того, чтобы обновить текущий необходимо выполнить API-запрос PUT на следующий URL, указав extension_id и call_api_id:
PUT /extension/{extension_id}/current_calls/{call_api_id
}
В теле запроса должны быть переданы параметры action и send_dst.
Действия по управлению вызовом
Действие | Описание |
---|---|
transfer | Перевод вызова на указанный в send_dst номер. |
eavesdrop | Прослушивание вызова. При API-запросе вызывается указанный в send_dst номер, при снятии трубки абонент слышит телефонный разговор. |
whisper | Обращение к участнику вызова (суфлирование). При API-запросе вызывается указанный в send_dst номер, при снятии трубки абонент может обращаться к участнику вызова. |
hold | Постановка вызова на удержание |
offhold | Снятие вызова с удержания |
park | Парковка вызова |
unpark | Снятие вызова с парковки |
pickup | Перехват вызова. При API-запросе вызывается указанный в send_dst номер, при снятии трубки абонент соединяется с участником вызова. |
...