"Групповое оповещение (zone_page)" ("Zone page call") - услуга группового оповещения абонентов с функцией автоответа. Она позволяет осуществить вещание заранее записанных акустических сообщений группе абонентов.

Zone page назначается на виртуальный номер, который будет являться номером группы вызова, таким образом, свойства этой услуги будет относиться к свойствам данной группы вызова. Сначала участникам группы вещаются вступительные записи (проигрываются один раз), затем анонсы (могут проигрываться несколько раз).

Использование

Использование Zone page вызова представляет собой групповой вызов 3.14.0 Индивидуальное оповещение (Voice page).
Например, для номера 1600 установлена услуга "Групповое оповещение (zone_page)" со списком номеров: 1301, 1302, 1303.
При поступлении вызова на номер 1600 будет совершен одновременный (групповой) Voice page вызов на каждый номер - 1301, 1302 и 1303.

Управление услугой с телефонного аппарата

Работа услуги ZonePage в режиме конференции

Услуга ZonePage позволяет устанавливать связь с ZonePage вызовами в режиме конференции - когда все слышат всех. Для это с ТА необходимо набирать ZonePage со следующим фичи-кодом:

Настройка параметров услуги через интерфейс командной строки

Для активации услуги "Групповое оповещение (zone_page)" через интерфейс командной строки выполните следующую команду:

• для администратора системы:

  • Установите разрешение на использование услуги:
    /cluster/storage/<CLUSTER>/ss/enable <DOMAIN> <ADDRESS> zone_page

• • Активируйте услугу:
    /cluster/storage/<CLUSTER>/ss/activate <DOMAIN> <ADDRESS> zone_page [<PARAMS>]

• для оператора виртуальной АТС:

  • Установите разрешение на использование услуги:
    /domain/<DOMAIN>/ss/enable <ADDRESS> zone_page

• • Активируйте услугу:
    /domain/<DOMAIN>/ss/activate <ADDRESS> zone_page [<PARAMS>]

где

<CLUSTER> - имя кластера хранения долговременных данных (DS);
<DOMAIN> - имя виртуальной АТС, которой принадлежит абонент(ы);
<ADDRESS> - номер(а) абонентов, для которых выполняется настройка услуги, символ "*" используется для указания всех абонентов заданной виртуальной АТС.

Диапазоны номеров указываются в фигурных скобках. Например: 71{1-2,9} соответствует номерам 711, 712, 719.

<PARAMS> - параметры услуги.

Абоненту при активации услуги доступны следующие параметры:

• Приоритет (priority) - приоритетность вызова, по умолчанию 5_routine - обычный. Высокоприоритетный вызов может заместить низкоприоритетный;
  От более приоритетного к менее приоритетному:
  • 0 - flash_override;
  • 1 - flash;
  • 2 - immediate;
  • 3 - priority;
  • 4 - routine.

• Время задержки до начала приветствия (intro_pause) - пауза между ответом одного из участников группы, тем, кто снял трубку первым, и началом проигрывания вступительных файлов, задается в секундах (по умолчанию 3 секунды);
• Список приветствий (intro_files) - список вступительных файлов (по умолчанию файлы не заданы);
• Время задержки до начала объявления (announcement_pause) - пауза между окончанием проигрывания вступительных файлов и началом проигрывания файлов анонсов, задается в секундах (по умолчанию 0 секунд);
• Список объявлений(announcement_files) - список файлов анонса, данные файлы могут проигрываться многократно;
• Количество повторов сообщения объявления (announcement_playback_cnt) - количество циклов проигрывания файлов анонса (по умолчанию анонсы проигрываются 1 раз);
• Время задержки повтора сообщения объявления (announcement_repeat_time) - пауза между циклами проигрывания файлов анонса, в случае если задано более одного цикла, задается в секундах (по умолчанию 10 секунд);
• Клавиша повтора сообщения объявления (announcement_repeat_digit)  - клавиша, дающая  возможность  повторно включить проигрывание анонса. При этом анонс будет играть зациклено, до тех пор, пока announcement_repeat_digit  не будет нажат повторно.
• Завершать работу услуги при отключении инициатора объявления (terminate_when_initiator_disconnects) - параметр, определяющий необходимость завершения вызова при отключении инициатора, значения true/false. Если установлено значение true, то после отбоя инициатора все участники группы будут отбиты;
• Завершать работу услуги при отключении последнего участника объявления (terminate_when_last_listener_leave) - параметр, определяющий необходимость завершения вызова при отключении последнего участника, значения true/false;
• Завершать работу услуги после окончания проигрывания сообщений объявления (terminate_when_playback_ends) - параметр, определяющий необходимость завершения вызова после окончании проигрывания анонсов, значения true/false. Если установлено значение true, то после окончания проигрывания всех циклов анонсов все участники группы будут отбиты, иначе после окончания проигрывания анонсов инициатор может продолжить вещать информацию со своего терминала;
• Широковещательный кодек (multicast_codec) - Параметр, определяющий тип кодека, который будет использован для широковещательных сообщений.
• Широковещательный IP - адрес (multicast_ip) - Параметр, позволяющий настроить широковещательные адреса для объявлений;
• Широковещательный порт (mutlicast_port) - Параметр, позволяющий настроить широковещательные порты для объявлений;
• Время жизни широковещательного пакета (multicast_ttl) - Парамтер, позволяющий настроить TTL для широковещательных пакетов.
• Проиграть сигнал отбоя (play_release_tone) - параметр, определяющий необходимость проиграть сигнал отбоя;

В случае когда параметры terminate_when_initiator_disconnects, terminate_when_playback_ends и terminate_when_last_listener_leave установлены в значение false (по умолчанию), завершение вызова происходит при отключении инициатора, во всех других случаях завершение вызова происходит при наступлении первого события, для которого параметр включен (параметр установлен в значение true).

• Права для начала группового вызова (initiation_policy) - ограничение, установленное на инициацию вещания по данной группе. Значения: managers - инициировать zone page вызов могут только абоненты-менеджеры из списка managers; members - инициировать zone page вызов могут только абоненты-участники обзвона из списка members; any - инициировать zone page вызов могут все абоненты (по умолчанию настроено значение any);
• Список участников услуги (members) - список участников группы вызова (внутренние и внешние номера);
• Список менеджеров услуги (managers) - список абонентов - менеджеров группы;
• Отображаемое имя услуги (display_name) - имя которое будет передаваться в качестве идентификации номера вызывающего (CallerID) всем участникам группы вызова во время совершения Zone Page вызове (по умолчанию "ZonePage").

Описание команд для управления услугами через интерфейс командной строки CLI приведено в Справочнике команд CLI, разделы /cluster/storage/<STORAGE>/ss и /domain/<DOMAIN>/ss.

Для более удобной настройки услуги также сделаны отдельные команды CLI:

admin@ds1@ecss1:/$ domain/biysk.local/ss/zone-page/activate 240101 managers = [240464,240465,240470]
Success: Supplementary service zone_page activated for domain "biysk.local" address "240101"

[exec at: 03.04.2019 11:21:36, exec time: 121ms, nodes: ds1@ecss1]

admin@ds1@ecss1:/$ domain/biysk.local/ss/zone-page/deactivate 240101 
Success: Supplementary service zone_page deactivated for domain "biysk.local", address "240101".

[exec at: 03.04.2019 11:59:02, exec time: 83ms, nodes: ds1@ecss1]

admin@mycelium1@ecss1:/$ domain/biysk.local/ss/zone-page/info -extended 240101                                                  
Domain: biysk.local

Supplementary services' settings:
┌──────────────┬───────────────────────┬─┬─┬─────────────────────────────────┬─────────────────────────────────┬──────────────────────────────────────┐
│   Address    │         Name          │V│E│               MSD               │               SSD               │                 CSD                  │
├──────────────┼───────────────────────┼─┼─┼─────────────────────────────────┼─────────────────────────────────┼──────────────────────────────────────┤
│240101        │zone_page              │7│T│enumInitiation_policy = "managers│                                 │announcement_files = [{file,{system,"s│
│              │                       │ │ │|members|any"                    │                                 │ounds/ai_wait_connection.wav"}}]      │
│              │                       │ │ │enumPriority = "0_flash_override|│                                 │announcement_pause = 0                │
│              │                       │ │ │1_flash|2_immediate|3_priority|4_│                                 │announcement_playback_cnt = 1         │
│              │                       │ │ │routine"                         │                                 │announcement_repeat_time = 10         │
│              │                       │ │ │                                 │                                 │display_name = "ZonePage"             │
│              │                       │ │ │                                 │                                 │initiation_policy = any               │
│              │                       │ │ │                                 │                                 │intro_files = []                      │
│              │                       │ │ │                                 │                                 │intro_pause = 3                       │
│              │                       │ │ │                                 │                                 │managers = 240101, 240470             │
│              │                       │ │ │                                 │                                 │members = 240244, 240466, 24050{1-5}, │
│              │                       │ │ │                                 │                                 │416977, 89913699011                   │
│              │                       │ │ │                                 │                                 │play_release_tone = true              │
│              │                       │ │ │                                 │                                 │priority = '2_immediate'              │
│              │                       │ │ │                                 │                                 │terminate_when_initiator_disconnects =│
│              │                       │ │ │                                 │                                 │ false                                │
│              │                       │ │ │                                 │                                 │terminate_when_last_listener_leave = f│
│              │                       │ │ │                                 │                                 │alse                                  │
│              │                       │ │ │                                 │                                 │terminate_when_playback_ends = false  │
└──────────────┴───────────────────────┴─┴─┴─────────────────────────────────┴─────────────────────────────────┴──────────────────────────────────────┘
Legend:
  V - version of the supplementary service;
  E - enable state of selected supplementary service to current domain, address

[exec at: 04.04.2019 08:04:47, exec time: 200ms, nodes: ds1@ecss1]

admin@mycelium1@ecss1:/$ domain/biysk.local/ss/zone-page/set 240101 priority = 2_immediate, members = [416977, 240464, 240466, 240244]
Success: Supplementary service zone_page activated for domain "biysk.local" address "240101"

[exec at: 04.04.2019 07:58:44, exec time: 83ms, nodes: ds1@ecss1]

admin@mycelium1@ecss1:/$ domain/biysk.local/ss/zone-page/add-number 240101 members 24050{1-5}, 89913699011
Successful

[exec at: 04.04.2019 08:02:56, exec time: 83ms, nodes: ds1@ecss1]

admin@mycelium1@ecss1:/$ domain/biysk.local/ss/zone-page/remove-number 240101 members 24046{1-5}, 240464
Numbers successfully added to zone_page:240101:biysk.local

[exec at: 04.04.2019 08:01:04, exec time: 89ms, nodes: ds1@ecss1]

Настройка параметров услуги через WEB-конфигуратор

Настройки выполняются в разделе "Supplementary services" ("Дополнительные услуги") приложения "Subscriber card" ("Карточка абонента").

Настройка услуги для всех абонентов определенной виртуальной АТС, а так же для определенного абонента в отдельности выполняется в приложении "Subscriber card" ("Карточка абонента").

Индивидуальные настройки услуги абонента переопределяют глобальные настройки услуги (настройки услуги на уровне домена).

• Для активации услуги установите флаг напротив значения "Групповое оповещение (zone_page)".
• В таблице "Список объявлений" ("List of Announcement media_files") выберите список файлов/тонов, которые будут проигрываться заданное количество раз после проигрывания вступительных файлов. Файлы/тоны доступны в приложении MSR медиа менеджер.
• Установите значения параметров "Время задержки до начала объявления" ("announcement_pause"), "Количество повторов сообщения объявления" ("announcement_playback_cnt"), "Время задержки повтора сообщения объявления" ("announcement_repeat_time"), "Права для начала группового вызова" ("display_name"), "Права для начала группового вызова" ("initiation_policy").
• В таблице "Список приветствий" ("List of Welcome media_files") выберите список файлов/тонов, которые будут проигрываться первыми после ответа одного из участников группы. Файлы/тона доступны в приложении MSR медиа менеджер.
  • Установите значения параметров "Время задержки до начала приветствия" ("intro_pause"), "Приоритет" ("priority"), "Завершать работу сервиса при отключении инициатора объявления" ("terminate_when_initiator_disconnects"), "Завершать работу сервиса при отключении последнего участника объявления" ("terminate_when_last_listener leave"), "Завершать работу сервиса после окончания проигрывания сообщений объявления" ("terminate_when_playback_ends").
• Настройте участников группы вызова - members и если есть необходимость - менеджеров группы managers.
• Для деактивации услуги - снимите флаг.

Для сохранения настроек нажмите кнопку "Save" ("Сохранить").

Zone Page каскадирование

Если в списке members находится номер с включенной услугой "Групповое оповещение (zone_page)", то в этом случае вызов пойдет на него и его "предков". Существует две особенности каскадирования Zone Page:

1. Внутри домена
   При каскадировании внутри домена по схеме

   {domain1, ZP1} -> {domain1, ZP2} -> {domain1, ZP3}

   В ZP4 будет проигран медиа-файл или тон от ZP1.

2. Между доменами
   При каскадировании между разными домена по схеме:

   {domain1, ZP1} -> {domain2, ZP2} -> {domain1, ZP3}

   Zone Page 4 воспроизведет собственный медиа-файл или тон, т.к у него нет "родителя" в рамках его домена.

Пример настройки

Активировать услугу "Групповое оповещение (zone_page)" для виртуального абонента с номером 100 виртуальной АТС "arko".

Активация услуги через интерфейс командной строки:

/cluster/storage/ds3/ss/enable arko 100 zone_page
/cluster/storage/ds3/ss/activate arko 100 zone_page [<PARAMS>] 

/domain/arko/ss/enable arko 100 zone_page
/domain/arko/ss/activate arko 100 zone_page zone_page announcement_files = [system sounds/ai_you.wav, system sounds/ai_untill.wav], priority = 2_flash, intro_files = [domain sounds/ai_activated_d1.wav], members = [1320], terminate_when_initiator_disconnects = true, terminate_when_playback_ends = false

Активация услуги через WEB-конфигуратор:

1. Выберите виртуальный номер - 100;
2. Разрешите использовать услугу абоненту - установите . Установите флаг напротив услуги "Групповое оповещение (zone_page)";
3. Выполните настройки, описание параметров приведено выше;
4. Для сохранения настроек нажмите кнопку "Save" ("Сохранить").