...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
| Warning |
|---|
Мы обновили документацию, актуальная версия страницы доступна по ссылке: Текущие вызовы (/current_calls/) |
Данный ресурс позволяет получать информацию о текущих вызовах добавочного номера, а также управлять этими вызовами.
Описание полей
| Имя | Тип | Описание | |||
|---|---|---|---|---|---|
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 | Информация о вызываемом добавочном номере | |||
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 | Парковка вызова | unpark | Снятие вызова с парковки |
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
Имя | Тип |
|---|---|
|
|
Поля ответа
Имя | Тип |
|---|---|
|
|
...
PUT /extension/{extension_id}/current_calls/{call_api_id}
Обновить вызов
Параметры URL
Имя | Тип |
|---|---|
|
|
|
|
Параметры JSON
Имя | Тип | Обязательный |
|---|---|---|
|
|
|
|
|
|
DELETE /extension/{extension_id}/current_calls/{call_api_id}
Прервать вызов
Параметры URL
Имя | Тип |
|---|---|
|
|
|
|
...