Текущие вызовы (/current_calls/)
- Asia Khalitova (Unlicensed)
Протестировать методы API можно на странице интерактивного обозревателя API и без написания кода
Некоторые ресурсы, описанные на странице, по умолчанию могут быть не доступны из-за типа приложения (см. Создание и авторизация приложений)
Данный ресурс позволяет получать информацию о текущих вызовах всех внутренних номеров клиента типа "телефонный терминал" либо конкретного внутреннего номера типа "телефонный терминал", а также управлять этими вызовами.
Описание структур данных
Управление вызовом
Для того, чтобы обновить текущий вызов, необходимо выполнить 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}