SIP устройства

В этом каталоге создаются учетные записи для подключения абонентских SIP-устройств. В качестве абонентов могут выступать

  • аппаратные SIP телефоны

  • программные SIP телефоны

  • WebRTC телефоны

  • SIP-FXO шлюзы

sipuser
Рис. 1. Общий вид раздела

Статус SIP абонентов

В основной таблице раздела можно отобразить текущее состояние SIP-устройств. Изначально столбец Статус скрыт. Для его отображения необходимо поставить галочку слева от записи Статусы (около кнопки Новый объект).

Для обновления статусов в таблице необходимо использовать кнопку обновления, которая находится справа от Статусы или перезагрузить страницу.

Если хоть 1 устройство зарегистрировано под данной учетной записью, статус имеет значение Зарегистрировано. При одном клике на данный статус внутри таблицы открывается окно с информацией о зарегистрированных устройствах.

Пример информации при одном зарегистрированном SIP-устройстве:

{
  "addr": "192.168.88.85",
  "expires": 941,
  "path": [
    {
      "domain": "10.0.1.3",
      "port": 5060,
      "proto": "tcp",
      "user": "r_Q14p9rc"
    }
  ],
  "port": 5063,
  "proto": "udp"
}

Описание полей в ответе:

Название поля Описание

addr

IP-адрес SIP устройства. Если SIP-устройство за NAT, то отображается локальный внутренний адрес устройства

expires

Оставшееся время жизни регистрации, сек.

path.domain

IP-адрес пограничной роли SG (SIP Gate) через которую это SIP-устройство подключено к Oktell Studio

path.port

Порт роли SG для приема пакетов от SIP устройства

path.proto

Внутренний транспортный протокол между SG и B2BUA, всегда = TCP

path.user

Внутренний идентификатор SIP устройства в хранилище Oktell Studio

port

Порт SIP устройства

proto

Транспортный протокол, используемый между SIP-устройством и ролью SG

Описание полей при создании/редактировании записи

sipuserAdd
Рис. 2. Экранная форма SIP устройства

Блок

Название поля

Описание

Основные

Отображаемое имя

Поле отображаемое на дисплее телефона (Display Name). Может содержать буквы, цифры, символы и макросы. Подробнее в Поле Отображаемое имя

Номер

Телефонный номер учетной записи SIP

Пользователь по умолчанию

Пользователь текущего домена, который работает на SIP устройстве. Используется в Ролевых приложениях для связи визуального интерфейса и SIP устройства

Количество устройств

Определяет:

  • количество различных SIP-устройств, которые могут одновременно быть зарегистрированы под текущей учетной записью

  • количество лицензий devices которые будут зарезервированы под текущую учетную запись

Возможные значения:

  • 0 - подключение под этой учетной записью невозможно. Используется для создания номера и использования его для правил маршрутизации, переадресации

  • 1 - только одно устройство единовременно может быть подключено. Значение по умолчанию

  • 2 и более - позволяет подключить несколько SIP-устройств одновременно. При звонке на этот номер будет использоваться SIP Forking на все подключенные устройства

Аутентификационные данные

Логин

Имя пользователя учетной записи SIP

Пароль

Пароль учетной записи SIP

Настройки вызова

Часовой пояс

Выбор часового пояса для данной учетной записи. Используется при временных ограничениях других связанных сущностей, например, Правила переадресации и Маршрутизация Выбор правила, Маршрутизация

Продолжительность вызова

Продолжительность вызова указанного номера в секундах. После достижения происходит переход по обработке “Нет ответа”. Значение по умолчанию = 30 секунд. Максимально допустимое значение 80 секунд, минимальное значение 1 секунда

Продолжительность разговора

Продолжительность телефонного разговора для указанного номера в секундах. Если опция установлена, то система контролирует длительность разговора (коммутации 2-х абонентов). При достижении порогового значения происходит разрыв связи. В качестве максимального времени разговора А и В выбирается минимальное из значений: ограничение по абоненту A, ограничение по абоненту B. Если никаких ограничений нет, то максимальная длительность разговора - 2 часа (системное ограничение) или значение из лицензионного параметра dlglimit для тестовых лицензий. По умолчанию 0 (не ограничено)

Одновременно входящих вызовов

Ограничение количества одновременных текущих разговоров для разрешения входящего звонка. Если достигнут указанный лимит, то при попытке звонка на текущий номер будет переход по ветке “Занято” (при этом количество исходящих одновременных вызывов не лимитируется). Возможные значения:

  • -1 - Неограниченно (по умолчанию)

  • 0 - Входящие вызовы запрещены

  • 1 и более - ограничение количества занятых линий для входящего звонка

MIN время Expires

Минимальное время жизни регистрации учетной записи абонента. Допустимое значение 30 - 3600 секунд. Подставляется в ответ, если expires в запросе меньше данного значения

MAX время Expires

Максимальное время жизни регистрации учетной записи абонента. Допустимое значение 30 - 86400 секунд. Подставляется в ответ, если expires в запросе больше данного значения

Комментарий

Комментарии

Возможность указать полезную информацию по учетной записи

Поле Отображаемое имя

Поле Отображаемое имя может содержать:

  • буквы русского и английского алфавита

  • цифры

  • символы - рекомендуется использовать только _ - sp . , ( )

  • макросы

Доступные макросы:

  • {D} - подставить исходный DisplayName из входящего запроса

  • {d} - подставить исходный DisplayName из входящего запроса в нижнем регистре

  • {U} - подставить исходный UserName из входящего запроса

  • {u} - подставить исходный UserName из входящего запроса в нижнем регистре

  • {E} - подставить пустоту

Пример:

СПб. {D} подставит слово "СПб. " перед именем, полученным от абонента (например, для дополнительной идентификации подразделения)

Изменение поле DisplayName отрабатывает для:

  • INVITE

  • 180 Ringing и 183 Session Progress (поля P-Asserted-Identity, Remote-Party-Id)

  • 200 OK

  • re-INVITE при SessionChange