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

<DOMAIN> - имя виртуальной АТС.

declare

Команда декларирования шаблона телеконференции.

Путь команды:

/domain/<DOMAIN>/teleconference/template/declare

Синтаксис:

declare <NAME>

Параметры:

<NAME> - имя шаблона (строка до 64 символов). Имя, содержащее пробелы, заключаются в двойные кавычки.

Примеры:

Создание нового шаблона:

admin@mycelium1@ecss1:/$ domain/biysk.local/teleconference/template/declare "IT service template"
Success: Template has been declared with id 064ea0fa57899a7e.

[exec at: 02.03.2021 11:29:25, exec time: 33ms, nodes: core1@ecss1 v.3.14.7.620]

Вывод ошибки:

admin@mycelium1@ecss1:/$ domain/biysk.local/teleconference/template/declare "IT service template"
Warning: Template with such name already exists.

[exec at: 02.03.2021 11:32:22, exec time: 28ms, nodes: core1@ecss1 v.3.14.7.620]

admin@mycelium1@ecss1:/$ 
admin@mycelium1@ecss1:/$ domain/biysk.local/teleconference/template/declare 0123456789_0123456789_0123456789_0123456789_0123456789_0123456789_0123456789_0123456789 
Error: Invalid command's arguments: "0123456789_0123456789_0123456789_0123456789_0123456789_0123456789_0123456789_0123456789".

[exec at: 06.11.2019 21:28:06, exec time: 66ms, nodes: core1@ecss1]

list

Команда просмотра списка шаблонов телеконференции.

Путь команды:

/domain/<DOMAIN>/teleconference/template/list

Синтаксис:

list

Параметры:

Команда без параметров

admin@mycelium1@ecss1:/$ domain/biysk.local/teleconference/template/list                       
┌──┬────────────────┬────────────────────────┬──────┐
│# │       id       │          Name          │Number│
├──┼────────────────┼────────────────────────┼──────┤
│1 │064ea11337afd03d│Утренняя планерка       │      │
│2 │064ea1032e0090c2│weekly meeting          │      │
│3 │064ea0fa57899a7e│IT service template     │      │
└──┴────────────────┴────────────────────────┴──────┘

[exec at: 02.03.2021 11:36:14, exec time: 27ms, nodes: core1@ecss1 v.3.14.7.620]

clean

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

Путь команды:

/domain/<DOMAIN>/teleconference/template/clean

Синтаксис:

clean <TEMPLATE> <OPTIONS>

Параметры:

<TEMPLATE> - группа телеконференции, должна выглядеть в одном из форматов:

  • --id <template id> - идентификатор шаблона телеконференции;
  • <template name> - имя шаблона телеконференции.

<OPTIONS> - свойство шаблона:

  • --description - выставить описание шаблона телеконференции. Содержит слово или строку в двойных кавычках. Пример: --description "Sales department";
  • --name - выставить имя шаблона телеконференции. Содержит слово или строку в двойных кавычках. Пример: --name Support;
  • --number - номер телефона шаблона конференции. Формат: --number <number>
  • --destroy_by_no_initiator - инициатором, в данном случае, является абонент позвонивший на номер телеконференции и создавший её. После выхода данного абонента из телеконференции, телеконференция завершается. Но, если телеконференция управляется из АРМ, то телеконференция будет завершена тогда, когда это управление закончится. Формат: --destroy_by_no_initiator true|false;
  • --destroy_when_only_one_member_left - завершить, если остался один участник. Формат: --destroy_when_only_one_member_left true|false;
  • --auto_collect - совершает вызов на участников(номера) после старта шаблона конференции. Формат: --auto_collect true|false;
  • --conversation_record - включить или выключить запись разговора телеконференции. Формат: --conversation_record true|false. Запись разговора телеконференции пишется в call_record_peer по пути domain/<domain>/tc/<template id>/records/<meeting_id>_<year>-<month>-<day>_<hour>-<min>-<sec>.wav;
  • --private - только задекларированные участники могут присоединиться к телеконференции. Формат: --private true|false;
  • --conversation_timeout - максимальное время пребывания участника в конференции. Формат: --conversation_timeout <timeout>. Где <timeout> число от 0 до 86400000, мс. Данный параметр прикрывает таймер conversation_timeout на домене (/domain/<domain>/timers/core/... ;
  • --no_answer_timeout - таймаут ожидания ответа абонента. Формат: --no_answer_timeout <timeout>. Где <timeout> число от 5000 до 300000 мс. Если параметр не задан, то будет использовано значение, выставленное на уровне домена (/domain/<domain>/timers/core/info no_answer_timeout);
  • --greeting_of_incoming_call - голосовое оповещение участников телеконференции для входящего вызова. Формат: --greeting_of_incoming_call [<path>, <path 2>, ..., <path N>]. Где <path> путь до медиа ресурсов;
  • --greeting_of_outgoing_call - голосовое оповещение участников телеконференции для исходящего вызова. Формат: --greeting_of_outgoing_call [<path>, <path 2>, ..., <path N>]. Где <path> путь до медиа ресурсов;
  • --greeting_of_outgoing_call_by_auto_collect - голосовое оповещение участников телеконференции для исходящего вызова с автоматическим сбором участников. Формат: --greeting_of_outgoing_call_by_auto_collect [<path>, <path 2>, ..., <path N>]. Где <path> путь до медиа ресурсов;
  • --farewell - прощальный лист извещений телеконференции. Формат: --farewell [<path>, <path 2>, ..., <path N>]. Где <path> путь до медиа ресурсов;
  • --farewell_of_call - индивидуальное оповещение для участника об окончании селекторного совещания. Формат: --farewell_of_call [<path>, <path 2>, ..., <path N>]
  • --notification_of_join_subscriber - лист извещения о присоединении к телеконференции. Формат: --notification_of_join_subscriber [<path>, <path 2>, ..., <path N>]. Где <path> путь до медиа ресурсов;
  • --notification_of_leave_subscriber - лист извещения о выходе участника из телеконференции. Формат: --notification_of_leave_subscriber [<path>, <path 2>, ..., <path N>]. Где <path> путь до медиа ресурсов;
  • --notification_of_microphone_enabled - извещение о включенном микрофоне. Формат: --notification_of_microphone_enabled [<path>, <path 2>, ..., <path N>]. Где <path> путь до медиа ресурсов;
  • --notification_of_microphone_disabled - извещение о выключенном микрофоне. Формат: --notification_of_microphone_disabled [<path>, <path 2>, ..., <path N>]. Где <path> путь до медиа ресурсов;
  • --notification_of_microphone_enable_request - уведомление о запросе включения микрофона. Формат: --notification_of_microphone_enable_request [<path>, <path 2>, ..., <path N>]. Где <path> путь до медиа ресурсов;
  • --notification_of_microphone_enable_request_rejected - уведомление о том, что запрос на включение микрофона отклонен. Формат: --notification_of_microphone_enable_request_rejected [<path>, <path 2>, ..., <path N>]. Где <path> путь до медиа ресурсов;
  • --display_name_prefix - отображаемый префикс конференции для конференций, созданных по feature-коду. Окончательный display name формируется из prefix + display name. Формат: --display_name_prefix <prefix>. Где <prefix> слово или строка в двойных кавычках. Пример: --display_name_prefix "Mine number 5"
  • --answer_to_initiator_when_success_outgoing_call - ответить инициатору после успешного исходящего вызова(только, если включен автосбор). Формат: --answer_to_initiator_when_success_outgoing_call true|false;
  • --pin - настройка pin-кода для шаблона телеконференции. Формат: --pin <pin>. Где <pin> число из 4 цифр от 0 до 9.
    • --pin-enable - включить использование pin-кода в шаблоне телеконференции. Конфликтует с --pin-disable;
    • --pin-disable - выключить использование pin-кода в шаблоне телеконференции. Конфликтует с --pin-enable;
    • --pin-for-all - использовать pin-код для всех участников и внешних номеров в шаблоне телеконференции. Конфликтует с --pin-for-numbers;
    • --pin-for-numbers - использовать pin-код только для внешних номеров в шаблоне телеконференции. Конфликтует с --pin-for-all.
  • --microphone-updates-display-name - при установленном флаге у всех участников созданной по шаблону телеконференции обновляется состояние микрофона через дисплейнейм путем добавления или удаления фразы "(Microphone disabled)".
  •  --new-member-voice - установить голос участников, которых нет в шаблоне.

Пример:

admin@mycelium1@ecss1:/$ domain/biysk.local/teleconference/template/clean "weekly meeting" --farewell       
Success: Property has been cleaned.

[exec at: 03.03.2021 10:57:17, exec time: 32ms, nodes: core1@ecss1 v.3.14.7.625]
admin@mycelium1@ecss1:/$ domain/biysk.local/teleconference/template/clean "weekly meeting" --destroy_by_no_initiator 
Success: Property has been cleaned.

[exec at: 03.03.2021 10:58:26, exec time: 8ms, nodes: core1@ecss1 v.3.14.7.625]

set

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

Путь команды:

/domain/<DOMAIN>/teleconference/template/set

Синтаксис:

set <TEMPLATE> <OPTIONS>

Параметры:

<TEMPLATE> - группа телеконференции, должна выглядеть в одном из форматов:

  • --id <template id> - идентификатор шаблона телеконференции;
  • <template name> - имя шаблона телеконференции.

<OPTIONS> - свойство шаблона:

  • --description - выставить описание шаблона телеконференции. Содержит слово или строку в двойных кавычках. Пример: --description "Sales department";
  • --name - выставить имя шаблона телеконференции. Содержит слово или строку в двойных кавычках. Пример: --name Support;
  • --number - номер телефона шаблона конференции. Формат: --number <number>
  • --destroy_by_no_initiator - инициатором, в данном случае, является абонент позвонивший на номер телеконференции и создавший её. После выхода данного абонента из телеконференции, телеконференция завершается. Но, если телеконференция управляется из АРМ, то телеконференция будет завершена тогда, когда это управление закончится. Формат: --destroy_by_no_initiator true|false;
  • --destroy_when_only_one_member_left - завершить, если остался один участник. Формат: --destroy_when_only_one_member_left true|false;
  • --auto_collect - совершает вызов на участников(номера) после старта шаблона конференции. Формат: --auto_collect true|false;
  • --conversation_record - включить или выключить запись разговора телеконференции. Формат: --conversation_record true|false. Запись разговора телеконференции пишется в call_record_peer по пути domain/<domain>/tc/<template id>/records/<meeting_id>_<year>-<month>-<day>_<hour>-<min>-<sec>.wav;
  • --private - только задекларированные участники могут присоединиться к телеконференции. Формат: --private true|false;
  • --conversation_timeout - максимальное время пребывания участника в конференции. Формат: --conversation_timeout <timeout>. Где <timeout> число от 0 до 86400000, мс. Данный параметр прикрывает таймер conversation_timeout на домене (/domain/<domain>/timers/core/... ;
  • --no_answer_timeout - таймаут ожидания ответа абонента. Формат: --no_answer_timeout <timeout>. Где <timeout> число от 5000 до 300000 мс. Если параметр не задан, то будет использовано значение, выставленное на уровне домена (/domain/<domain>/timers/core/info no_answer_timeout);
  • --greeting_of_incoming_call - голосовое оповещение участников телеконференции для входящего вызова. Формат: --greeting_of_incoming_call [<path>, <path 2>, ..., <path N>]. Где <path> путь до медиа ресурсов;
  • --greeting_of_outgoing_call - голосовое оповещение участников телеконференции для исходящего вызова. Формат: --greeting_of_outgoing_call [<path>, <path 2>, ..., <path N>]. Где <path> путь до медиа ресурсов;
  • --greeting_of_outgoing_call_by_auto_collect - голосовое оповещение участников телеконференции для исходящего вызова с автоматическим сбором участников. Формат: --greeting_of_outgoing_call_by_auto_collect [<path>, <path 2>, ..., <path N>]. Где <path> путь до медиа ресурсов;
  • --farewell - прощальный лист извещений телеконференции. Формат: --farewell [<path>, <path 2>, ..., <path N>]. Где <path> путь до медиа ресурсов;
  • --farewell_of_call - индивидуальное оповещение для участника об окончании селекторного совещания. Формат: --farewell_of_call [<path>, <path 2>, ..., <path N>]
  • --notification_of_join_subscriber - лист извещения о присоединении к телеконференции. Формат: --notification_of_join_subscriber [<path>, <path 2>, ..., <path N>]. Где <path> путь до медиа ресурсов;
  • --notification_of_leave_subscriber - лист извещения о выходе участника из телеконференции. Формат: --notification_of_leave_subscriber [<path>, <path 2>, ..., <path N>]. Где <path> путь до медиа ресурсов;
  • --notification_of_microphone_enabled - извещение о включенном микрофоне. Формат: --notification_of_microphone_enabled [<path>, <path 2>, ..., <path N>]. Где <path> путь до медиа ресурсов;
  • --notification_of_microphone_disabled - извещение о выключенном микрофоне. Формат: --notification_of_microphone_disabled [<path>, <path 2>, ..., <path N>]. Где <path> путь до медиа ресурсов;
  • --notification_of_microphone_enable_request - уведомление о запросе включения микрофона. Формат: --notification_of_microphone_enable_request [<path>, <path 2>, ..., <path N>]. Где <path> путь до медиа ресурсов;
  • --notification_of_microphone_enable_request_rejected - уведомление о том, что запрос на включение микрофона отклонен. Формат: --notification_of_microphone_enable_request_rejected [<path>, <path 2>, ..., <path N>]. Где <path> путь до медиа ресурсов;
  • --display_name_prefix - отображаемый префикс конференции для конференций, созданных по feature-коду. Окончательный display name формируется из prefix + display name. Формат: --display_name_prefix <prefix>. Где <prefix> слово или строка в двойных кавычках. Пример: --display_name_prefix "Mine number 5"
  • --answer_to_initiator_when_success_outgoing_call - ответить инициатору после успешного исходящего вызова(только, если включен автосбор). Формат: --answer_to_initiator_when_success_outgoing_call true|false;
  • --pin - настройка pin-кода для шаблона телеконференции. Формат: --pin <pin>. Где <pin> число из 4 цифр от 0 до 9.
    • --pin-enable - включить использование pin-кода в шаблоне телеконференции. Конфликтует с --pin-disable;
    • --pin-disable - выключить использование pin-кода в шаблоне телеконференции. Конфликтует с --pin-enable;
    • --pin-for-all - использовать pin-код для всех участников и внешних номеров в шаблоне телеконференции. Конфликтует с --pin-for-numbers;
    • --pin-for-numbers - использовать pin-код только для внешних номеров в шаблоне телеконференции. Конфликтует с --pin-for-all.
  • --microphone-updates-display-name - при установленном флаге у всех участников созданной по шаблону телеконференции обновляется состояние микрофона через дисплейнейм путем добавления или удаления фразы "(Microphone disabled)".
  •  --new-member-voice - установить голос участников, которых нет в шаблоне.

Примеры:

Не завершать конференцию после выхода инициатора:

admin@mycelium1@ecss1:/$ domain/biysk.local/teleconference/template/set "weekly meeting" --destroy_by_no_initiator false 
Success: Property has been set.

[exec at: 03.03.2021 10:52:56, exec time: 18ms, nodes: core1@ecss1 v.3.14.7.625]

Установить звуковой файл оповещения участников о завершении конференции:

admin@mycelium1@ecss1:/$ domain/biysk.local/teleconference/template/set "weekly meeting" --farewell [system sounds/ai_conference_destroyed.wav] 
Success: Property has been set.

[exec at: 03.03.2021 10:53:37, exec time: 53ms, nodes: core1@ecss1 v.3.14.7.625]

Установка тона оповещения о выходе участника:

admin@mycelium1@ecss1:/$ domain/biysk.local/teleconference/template/set "weekly meeting" --notification_of_leave_subscriber [tone 400 200 500 0 100 ]
Success: Property has been set.

[exec at: 03.03.2021 10:54:01, exec time: 10ms, nodes: core1@ecss1 v.3.14.7.625]

Примеры ввода некорректных значений:

admin@mycelium1@ecss1:/$ domain/biysk.local/teleconference/template/set "weekly meeting" --no_answer_timeout 2s                                      
Command error: can't parse flag no_answer_timeout

[exec at: 03.03.2021 10:54:32, exec time: 5ms, nodes: core1@ecss1 v.3.14.7.625]

Установка таймера пребывания в конференции.

admin@mycelium1@ecss1:/$ domain/biysk.local/teleconference/template/set "weekly meeting" --conversation_timeout 2m
Success: Property has been set.

[exec at: 03.03.2021 10:55:50, exec time: 38ms, nodes: core1@ecss1 v.3.14.7.625]

remove

Команда удаления шаблона телеконференции.

Если установлен флаг force у команды, то команда удалит не только шаблон, но и все запланированные совещания. Иначе команда будет отменена и будет выведен список запланированных совещаний.

Путь команды:

/domain/<DOMAIN>/teleconference/template/remove

Синтаксис:

remove <TEMPLATE> [--force]

Параметры:

<TEMPLATE> - группа телеконференции, должна выглядеть в одном из форматов:

  • --id <template id> - идентификатор шаблона телеконференции;
  • <template name> - имя шаблона телеконференции.

Пример:

admin@mycelium1@ecss1:/$ domain/biysk.local/teleconference/template/remove "w                                        
Enter name of the teleconference template or the flag --id:           

admin@mycelium1@ecss1:/$ domain/biysk.local/teleconference/template/remove "weekly meeting" 
[remove] You are going to remove template with name "weekly meeting". It will delete the 
         template folder (The folder may be contains audio files which were uploaded by u
         ser and conversations records which were created by teleconference meetings).
Are you sure?: yes/no ?> yes
Success: Template has been removed.

[exec at: 03.03.2021 10:59:05, exec time: 2s 716ms, nodes: core1@ecss1 v.3.14.7.625]

info

Команда просмотра шаблона телеконференции.

Путь команды:

/domain/<DOMAIN>/teleconference/template/info

Синтаксис:

info <TEMPLATE> [<OPTIONS>]

Параметры:

<TEMPLATE> - группа телеконференции, должна выглядеть в одном из форматов:

  • --id <template id> - идентификатор шаблона телеконференции;
  • <template name> - имя шаблона телеконференции.

<OPTIONS> - параметры шаблона.

  • --show-members - показать информацию об участниках (default: false);
  • --show-groups - показать информацию о группах в шаблоне (default: false);
  • --show-numbers - показать информацию о внешних номерах (default: false).

Пример:

admin@mycelium1@ecss1:/$ domain/biysk.local/teleconference/template/info "weekly meeting" 
===================================================
Template: weekly meeting (064ea1032e0090c2)

Template properties:
┌──────────────────────────────────────────────────┬────────────────────────────────────────────────────────┐
│                       Key                        │                         Value                          │
├──────────────────────────────────────────────────┼────────────────────────────────────────────────────────┤
│description                                       │                                                        │
│number                                            │                                                        │
│answer_to_initiator_when_success_outgoing_call    │false                                                   │
│auto_collect                                      │false                                                   │
│destroy_by_no_initiator                           │true                                                    │
│destroy_when_only_one_member_left                 │false                                                   │
│display_name_prefix                               │"Teleconference "                                       │
│farewell                                          │system://sounds/ai_conference_destroyed.wav             │
│farewell_of_call                                  │system://sounds/ai_conference_call_completed.wav        │
│greeting_of_incoming_call                         │system://sounds/ai_conference_prompt.wav                │
│greeting_of_outgoing_call                         │system://sounds/ai_conference_prompt.wav                │
│greeting_of_outgoing_call_by_auto_collect         │system://sounds/ai_conference_prompt.wav                │
│microphone_updates_display_name                   │false                                                   │
│new_member_voice                                  │true                                                    │
│no_answer_timeout                                 │undefined                                               │
│notification_of_join_subscriber                   │tone://?f1=490&f2=0&on_msec=200&off_msec=100&duration=30│
│                                                  │0                                                       │
│notification_of_leave_subscriber                  │tone://?f1=390&f2=0&on_msec=200&off_msec=100&duration=30│
│                                                  │0                                                       │
│notification_of_microphone_disabled               │system://sounds/ai_microphone_disabled.wav              │
│notification_of_microphone_enable_request         │system://sounds/ai_microphone_enable_request.wav        │
│notification_of_microphone_enable_request_rejected│system://sounds/ai_microphone_enable_request_rejected.wa│
│                                                  │v                                                       │
│notification_of_microphone_enabled                │system://sounds/ai_microphone_enabled.wav               │
│private                                           │false                                                   │
└──────────────────────────────────────────────────┴────────────────────────────────────────────────────────┘

[exec at: 03.03.2021 08:31:44, exec time: 29ms, nodes: core1@ecss1 v.3.14.7.625]