Групповой номер (group)

Описание

Определяет телефонный номер, состоящий из нескольких учетных записей SIP-пользователей, внешних номеров или других групп, а также порядок их вызова.

Вызов абонентов группы осуществляется через механизм переадресации и построения двухуровневого списка. Сначала вызываются абоненты первой группы, в случае неудачи по всем вызываются абоненты второй группы и т.д.

Каждый из абонентов может иметь собственные настроенные правила переадресации. Они применяются в соответствии с правилами применения.

Ограничений к количеству и типу одновременно или последовательно вызываемых абонентов нет. Изначально двухуровневый список фильтруется по совпадениям во избежании кратных вызовов. При этом учитываются переадресации абсолютные и по отсутствию регистрации. Прочие типы условных переадресаций применяются уже после получения ответов на отправленные запросы INVITE.

Ограничения

  • Сущность недоступна в мастер-домене.

Поля

Структура сущности
{
  "id": uuid,
  "phonenumber": str,
  "type": str,
  "dialplan": array<object>,
  "pickup": intbool,
  "opts": {
    "title": str,
    "comment": str
  },
  "ext": {
    "ct": date,
    "lwt": date
  }
}
Table 1. Поля
Спецификация Описание

Поле: id
Режим: inout
Тип: uuid
По умолчанию: generated

Идентификатор. Может быть задан при создании, иначе генерируется системой «R».

Поле: phonenumber
Режим: in
Тип: str
По умолчанию: required

Номер группы

Поле: type
Режим: in
Тип: str
По умолчанию: "cascade"

Поле: dialplan
Режим: in
Тип: array<object>
По умолчанию: empty

Состав группового номера и порядок вызова подгрупп.
Каждый объект в списке представляет собой подгруппу одновременно вызываемых внутренних номеров.
Элемент списка dialplan.

Поле: pickup
Режим: in
Тип: intbool
По умолчанию: true

Признак доступности для featurecode типа pickupgroup

Поле: opts
Режим: in
Тип: object

Составное поле

Поле: opts.title
Режим: in
Тип: str
По умолчанию: empty

Произвольный заголовок

Поле: opts.comment
Режим: in
Тип: str
По умолчанию: empty

Произвольный комментарий

Поле: opts.filter_mode
Режим: in
Тип: str
По умолчанию: "all

Режим фильтрации дубликатов URI при создании форков. all, inner, outer, none - фильтровать все, фильтровать только внутренние, фильтровать только внешние, не фильтровать

Поле: ext
Режим: inout
Тип: object

Составное поле, позволяющее расширять состав произвольными ключами и значениями

Поле: ext.ct
Режим: out
Тип: date
По умолчанию: generated

Время создания объекта

Поле: ext.lwt
Режим: out
Тип: date
По умолчанию: generated

Время последней модификации объекта

Режим вызова группы

Table 2. Режим вызова группы
Значение Описание

"cascade"

Последовательный вызов входящих в состав учетных записей строго в порядке перечисления в поле dialplan. Следующая учетная запись вызывается только после неудачи вызова предыдущей или ее отказа.

"parallel"

Все элементы группы вызываются одновременно

"random"

Последовательно случайный порядок. Рандомизация производится независимо при каждом звонке.

Элемент списка dialplan

Table 3. Элемент списка dialplan
Поле Тип значения Описание

dial

array<str>

Список номеров, подлежащих одновременному вызову в рамках подгруппы. Список не может быть пустым. Номера должны быть доступны для маршрутизации. Это могут быть внешние номера, номера учетных записей пользователей, номера других групп.

timeout

int

Время вызова подгруппы в миллисекундах. Если поле отсутствует, то применяется стандартный таймаут для форков – 30 секунд.

См. также

Функциональные роли

  • b2b проводит маршрутизацию и применение группового номера для организации форков.

  • mdc и sdc производят поиск группового номера.