Teleconference — конференция с последовательным сбором участников с функционалом селекторной связи и управлением только с ТА.

Определения:

Телеконференция/Селекторное совещание — совещание в форме телефонной конференции с возможностью управления голосом участников.
Участник — номер, участвующий в телеконференции.
Группа — цифровое имя списка номеров с типом teleconference.
Задекларированные участники — номера, указанные в шаблоне телеконференции, а также номера из групп, которые используются шаблоном.
Шаблон телеконференции — описание свойств и списка участников телеконференции.
Инициатор/Мастер/Диспетчер — номер, который имеет права для создания и управления телеконференцией.

Основные возможности:

Управление микрофоном участников конференции;
Подключение участников через трансфер или вызов на feature-код;
Нотификации о текущем состоянии конференции и её участников;
Запрос голоса у мастера конференции;
Автоматический сбор конференции;
Возможность создания публичных и приватных конференций.

Настройка телеконференции

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

Настройка услуги Teleconference описана в разделе Селекторное совещание (Teleconference).

Шаблон телеконференции

Шаблон телеконференции — это набор предопределенных параметров, которые используются при создании телеконференции.
В шаблоне разрешается определять следующие свойства конференции:

Номер комнаты телеконференции — цифровой номер, который используется в feature-кодах для создания, управления и удаления конференций.
Описание — текстовое описание шаблона конференции.
Параметры телеконференции — различные параметры шаблона конференции, которые описаны более подробно в разделе Команды управления шаблонами телеконференций.

В случае если параметр private установлен в true, то самостоятельное подключение незадекларированных номеров через feature-код входа в конференцию не допускается. При этом мастер конференции имеет право добавлять любых участников вне зависимости от данной настройки.

Список номеров — список номеров, которые могут участвовать в конференции.
Список групп — список групп с определенными участниками и номера, которые могут участвовать в конференции.

Использование групп удобно, когда нужно подключить один и тот же перечень номеров к разным шаблонам. Также использование групп позволяет подключать/отключать сразу несколько номеров к/от конференции, используя лишь цифровой номер группы.

Команды управления группами представлены в разделе Команды управления группами телеконференций.

Команды создания/редактирования/удаления шаблонов телеконференции описаны в разделе Команды управления шаблонами телеконференций.

Сбор телеконференции

Собирать телеконференцию могут абоненты, которые имеют роль manager в шаблоне совещания.
Для создания телеконференции нужно сделать вызов на Feature-код с указанием цифрового номера совещания (параметр --number в шаблоне совещания).
После создания телеконференции можно добавлять/удалять участников/группы, изменять состояние голоса участника через вызов на соответствующие Feature-коды.
Так же поддержана возможность трансфера абонента в телеконференцию. Для этого нужно сделать трансфер абонента на Feature-код создания телеконференции или Feature-код входа в телеконференцию.

Feature коды управления телеконференций представлены на соответствующей странице.

Просьба дать голос

По умолчанию голос у участника активирован. Если у участника деактивирован голос (свойство участника --voice выставлено в false), он может попросить активировать ему голос нажав цифру 1 на ТА (отправить dtmf1). Это приведет к тому, что сформируется нотификация с просьбой дать ему голос (ask-voice). По данной нотификации мастер увидит, что участник телеконференции просит голос.

Сценарии использования

Использование конференции без шаблона

Абонент с активированной услугой teleconference делает вызов на feature-код создания конференции, указывая цифровой номер шаблона совещания.
Пример: *470*222#

Далее любые пользователи могут подключаться к данной конференции, набирая feature-код входа в конференцию, с указанием цифрового номера шаблона совещания.
Пример: *472*222#, в данном случае абонент подключится к конференции с номером 222.

Мастер конференции также может подключать участников, используя соответствующий feature-код добавления участника.
Пример: *473*222*101#, в данном случае абонента 101 добавляют в конференцию с номером 222

Либо мастер делает вызов на желаемого абонента и делает несопровождаемый трансфер на feature-код создания или входа в конференцию (*470#, *472#).

Для управления голосом участников мастер использует следующие feature-коды: *476, *477, *475.

Пример:

*476*222*101# — в телеконференции с номером 100 абоненту 101 включают голос;
*477*222*101# — в телеконференции с номером 100 абоненту 101 выключают голос;
*475*222*101# — в телеконференции с номером 100 абоненту 101 изменяют состояние голоса на противоположное.

Использование конференции с шаблоном

Шаблоны телеконференций создаются администратором домена.
Пример:

admin@[mycelium1@ecss1]:/$ /domain/pv.ssw2/teleconference/template/declare first_conf               
Success: Template has been declared with id 0634b6aa48045a60.

Далее администратор настраивает параметры шаблона. Предположим, что требуется создать шаблон закрытой (приватной) конференции с автосбором, c цифровым номером 909, в которой помимо мастера с номером 101 будет участвовать абонент 102. Для этого настроим шаблон следующим образом:

admin@[mycelium1@ecss1]:/$ /domain/pv.ssw2/teleconference/template/set first_conf --private true 
Success: Property has been set.

admin@[mycelium1@ecss1]:/$ /domain/pv.ssw2/teleconference/property-set first_conf --auto_collect true 
Success: Property has been set.

admin@[mycelium1@ecss1]:/$ /domain/pv.ssw2/teleconference/template/set first_conf --number 909 
Success: Property has been set.

admin@[mycelium1@ecss1]:/$ /domain/pv.ssw2/teleconference/template/member/add first_conf contact 101 --role manager
┌─┬──────────┬────────────┬──────────┬───────────┬─────────┬───────┬────────┬────────────┬─────┬──────────────────────────┐
│#│Is member?│Contact name│First name│Middle name│Last name│Company│Position│Phone number│Email│       Description        │
├─┼──────────┼────────────┼──────────┼───────────┼─────────┼───────┼────────┼────────────┼─────┼──────────────────────────┤
│1│          │101         │FN1       │MN1        │LN1      │Eltex  │        │101         │     │Auto-created by CoCon user│
└─┴──────────┴────────────┴──────────┴───────────┴─────────┴───────┴────────┴────────────┴─────┴──────────────────────────┘
Success: Member(s) added successfully.
admin@[mycelium1@ecss1]:/$ /domain/pv.ssw2/teleconference/template/member/add first_conf contact 102 --role member
┌─┬──────────┬────────────┬──────────┬───────────┬─────────┬───────┬────────┬────────────┬─────┬──────────────────────────┐
│#│Is member?│Contact name│First name│Middle name│Last name│Company│Position│Phone number│Email│       Description        │
├─┼──────────┼────────────┼──────────┼───────────┼─────────┼───────┼────────┼────────────┼─────┼──────────────────────────┤
│1│          │102         │FN1       │MN1        │LN1      │Eltex  │        │102         │     │Auto-created by CoCon user│
└─┴──────────┴────────────┴──────────┴───────────┴─────────┴───────┴────────┴────────────┴─────┴──────────────────────────┘
Success: Member(s) added successfully.

Подробное описание всех параметров шаблона представлено в пункте Команды управления шаблонами телеконференций.

Менеджер шаблона (номер 101) может создать конференцию, используя данный шаблон. Для этого нужно сделать вызов на следующий feature-код.
Пример: *470*909#
Управление данной конференцией производится таким же образом, как и конференцией без шаблона. Мастер может добавлять/удалять любые номера вышеописанными способами. Также отметим, что в случае закрытой конференции только указанные в шаблоне абоненты могут подключиться к конференции самостоятельно. Для этого им нужно позвонить на feature-код входа в конференцию, при этом в качестве параметра ROOM указывается цифровой номер шаблона.
Пример: *472*909#

Использование teleconference групп в шаблонах телеконференции

Для возможности использования одной и того же группы номеров в различных шаблонах, а также управления группами номеров в конференции используются группы. Данные группы создаются администратором домена.
```
admin@[mycelium1@ecss1]:/$ /domain/pv.ssw2/teleconerence/group/declare gr_1              
Success: Group has been declared with id 0634b757562cd47d

admin@[mycelium1@ecss1]:/$ /domain/pv.ssw2/teleconerence/group/set gr_1 --number 202              
Success: Property has been set.
```

Далее администратор добавляет созданные списки к нужным шаблонам.

admin@[mycelium1@ecss1]:/$ /domain/pv.ssw2/teleconference/template/group/add first_conf gr_1           
Success: Group has been added

После этого мастеру конференции становятся доступны feature-коды по управлению группами.
Например, чтобы добавить группу в конференцию, мастер делает вызов на feature-код:
*478*909*202#
А для удаления группы:
*479*909*202#

Использование конференции на отдельном медиасервере

На SSW имеется возможность провести настройки конфигураций таким образом, чтобы телеконференции селекторной связи собирались на отдельном MSR .

Лицензионные ограничения

На уровне домена, teleconference ограничивается параметром teleconference\enabled.

Пример:

admin@[mycelium1@ecss1]:/$ /domain/pv.ssw2/properties/restrictions/info
┌────────────────────────────────┬────────┬────────────────────────────────────────────────────────────────┐
│          Restriction           │ Value  │                          Description                           │
├────────────────────────────────┼────────┼────────────────────────────────────────────────────────────────┤
│           ....                 │  ...   │                         ...                                    │
│teleconference\enabled          │True    │Enable Teleconference service for current domain                │
│           ....                 │  ...   │                         ...                                    │
└────────────────────────────────┴────────┴────────────────────────────────────────────────────────────────┘