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

Содержание

Описание
Ограничения
Поля
- Режим вызова группы
- Элемент списка dialplan
См. также
- API
- Логические роли

Описание

Определяет телефонный номер, состоящий из нескольких учетных записей 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	Идентификатор. Может быть задан при создании, иначе генерируется системой.
Поле: `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 секунд.

См. также

API

/rest/v1/uc/sipgroups

Логические роли

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