...
| Ресурс | Метод | Параметры Пути | Тело запроса | Описание |
|---|---|---|---|---|
| extension/{extension_id}/phone/ | PUT | extension_id (integer) уникальный идентификатор добавочного, может принимать значение @me в случае пользователя типа "экстеншен" | обновленные поля PhoneProperties61877096 | Изменить свойства телефонного терминала |
| extension/{extension_id}/phone/ | GET | extension_id (integer) уникальный идентификатор добавочного, может принимать значение @me в случае пользователя типа "экстеншен" | Получить свойства телефонного терминала |
...
Описание структур данных
Свойства телефонного терминала (PhoneProperties)
| Anchor | ||||
|---|---|---|---|---|
|
Имя | Тип | Обязательное | Значение По Умолчанию | Описание |
|---|---|---|---|---|
|
| нет | false | активирует голосовую почту |
hold_music | integer | нет | null | идентификатор звукового файла, звучащий у другой стороны диалога, когда терминал переводит вызов в режим удержания. Если не указан, то будет звучать предустановленный системный файл |
| integer | нет | null | идентификатор звукового файла, который проиграется при исходящем вызове в качестве обьявления информации. |
record_enabled | boolean | нет | false | включить запись звонков в файл. Сохраненные файлы доступны через ресурс записей, дисковая квота через свойства клиента. Занятое место на диске через дисковое пространство |
vm_greeting | integer | нет | null | актуально для vm_enabled. Идентификатор звукового файла, звучащего в качестве приветствия голосовой почты |
vm_mailto | string | нет | "" | актуально для vm_enabled. Адрес e-mail для получения оповещений о новом голосовом сообщение (возможны несколько адресов через запятую) |
vm_attach_file | boolean | нет | true | актуально для vm_enabled. Прикреплять ли файл с голосовым сообщение при отправке уведомления о получении |
hangup_timeout | integer | нет | 60 | максимально ожидание ответа добавочного при входящем вызове, указывается в секундах. По истечении этого времени звонок считается не отвеченным и могут включится правила входящего вызова ( если есть), либо произойти отбой. |
auth_type | string | нет | "digest" | Тип аутентификации запросов добавочного на sip-сервере. Принимает одно из значений:
|
password | string | нет | задает пароль для авторизации на sip-сервере при 'auth_type':'digest' или 'auth_type':'both' | |
network_permission_group_id | integer | нет | null | задает идентификатор доверенных сетей клиента для авторизации на sip-сервере при 'auth_type':'network' или 'auth_type':'both' |
external_number | string | нет | null | если параметр определен, то sip-сервер отправляет туда вызов. Этим номером может быть, например, мобильный. Вызов обрабатывается так же, как если бы он пришел непосредственно на терминал ( работаю все правила переадресаций, записей разговоров, разрешение переводом и т.п.) |
static_reg_address | string | нет | null | если терминал по какой-либо причине не может регистрироваться на сервере, то регистрацию можно указать в явном виде. Все вызовы будут направлены на этот адрес. При этом терминал может продолжать регистрироваться на сервере, но вызовы все равно будут уходить согласно static_reg_address. Указывается в виде адрес:порт (например 8.8.8.8:5068) |
call_screening_enabled | boolean | нет | false | управление механизмом подтверждения входящего вызова. Если параметр установлен в true, то во время вызова на добавочный при снятии трубки абонент услышит информацию о номере звонящего и о внешнем номере, на который был осуществлён вызов. Для ответа на вызов в данном случае следует нажать цифру 1, для отмены вызова следует повесить трубку. |
ignore_early_media | boolean | нет | false | если данный параметр установлен в true, то при вызове добавочного будет игнорироваться раннее медиа, например, автоответчики. Может быть полезно в случае регистрации внешнего номера или применения FMC. |
incoming_limit | integer | нет | 0 | устанавлиевает, сколько добавочный может принимать вызовов одновременно. "0" - без ограничений, "1" - не более одного (аналог выключения "call waiting"), "2" - не более двух и т.д. |
allow_webrtc | boolean | нет | false | Если установлено значение "true", то позволяет добавочному работать через WebRTC |
geo_list | string | нет | null | Задает список стран, с айпи адресов которых разрешено использование SIP аккаунта. Страны перечисляются в формате ISO 3166 Codes A2, например "RU US BY". Если список не задан, то используется одноименный параметр ресурса клиент. Если список имеет значение "*", то все страны разрешены и клиентский параметр игнорируется . |
Примеры использования
Для добавочного с идентификатором 54 установим привязку внешнего мобильного номера +79876543210
метод | ресурс | данные | ответ |
|---|---|---|---|
| PUT | /extension/54/phone/ |
|
} |
...