В данном разделе описываются команды управления услугой "Голосовая почта (Voicemail)" для абонентов.

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

activate

Команда предназначена для активации услуги "Голосовая почта (Voicemail)" для заданных абонентов.

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

domain/<DOMAIN>/ss/voicemail/activate

Синтаксис:

activate <ADDRESS_RANGE> [<PROPERTY> = <VALUE> [, ...]]

Параметры:

<ADDRESS_RANGE> - диапазон номеров, на котором необходимо активировать услугу "Голосовая почта";
<PROPERTY> - свойство, значение которого необходимо установить отличающееся от значения по умолчанию.

Абоненту при активации доступны следующие свойства "Голосовая почта":

busy - переадресовывать входящий вызов на голосовую почту в случае, если абонент занят (по умолчанию: false);
email_body - тело письма с голосовой почтой на e-mail(по умолчанию пустое). Поддерживаются макро-определения (DATE, TIME, CALLING, DISPLAYNAME).;
email_from - имя, с которого будет отправлена голосовая почта на email (по умолчанию: DISPLAYNAME). Поддерживаются макро-определения (DATE, TIME, CALLING, DISPLAYNAME);
email_subject - тема письма с голосовой почтой на e-mail (по умолчанию: Voicemail from CALLING at DATE TIME). Поддерживаются макро-определения (DATE, TIME, CALLING, DISPLAYNAME);
mailbox_volume - размер почтового ящика, в секундах (по умолчанию: 1800). В случае, если размер равен 0, то голосовой ящик неограничен;
max_message_duration - максимальная длительность голосового сообщения (по умолчанию: 300 сек);
max_silence - время (в секундах), которое сервис ждет, прежде чем завершать запись разговора, в случае определения непрерывного интервала тишины со стороны ТА. Если значение равно 0, то детектор выключен (по умолчанию 0);
min_message_duration - минимальная длительность голосового сообщения (по умолчанию: 0). В случае, если сообщение будет меньшей длительностью, то оно не будет сохранено;
no_reply - при установленном флаге происходит переадресация входящего вызова на голосовую почту по неответу абонента (по умолчанию: true);
out_of_service - переадресация входящего вызова на голосовую почту в случае недоступности абонента (по умолчанию: true);
override_messages - перезапись сообщения в случае, если почтовый ящик переполнен (по умолчанию true). Если почтовый ящик заполнен, но есть попытка записать новое сообщение, то сперва будут удаляться самые старые прочитанные сообщения, а если их не осталось - то будут удаляться самые старые непрочитанные сообщения;
password - пароль для доступа к голосовой почте(по умолчанию пустой). Если параметр не заполнен, то доступ к голосовой почте осуществляется без пароля;
play_message_details - проигрывание деталей оставленного сообщения перед тем, как играть само сообщение (по умолчанию: false);
send_by_email - отправка записанного сообщения по e-mail (работает, если на абоненте настроен параметр e-mail) (по умолчанию: false);
timeout - время ожидания ответа абонента, после которого сработает переадресация на голосовую почту(по умолчанию 30);
unconditional - безусловно переадресовывать входящий вызов на голосовую почту абонента (по умолчанию: false);

Пример:

admin@[mycelium1@ecss1]:/$ domain/biysk.local/ss/voicemail/activate 240464 busy = true, send_by_email = true, timeout = 40, play_message_details = true, password = 258963
Success: Supplementary service voicemail activated for domain "biysk.local" address "240464"

deactivate

Команда деактивации услуги "Голосовая почта (Voicemail)" для заданных абонентов.

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

domain/<DOMAIN>/ss/voicemail/deactivate

Синтаксис:

deactivate <ADDRESS_RANGE>

Параметры:

<ADDRESS_RANGE> - диапазон номеров, на котором необходимо деактивировать услугу "Голосовая почта".

Пример:

admin@[mycelium1@ecss1]:/$ domain/biysk.local/ss/voicemail/deactivate {240464,240101}
Success: Supplementary service voicemail deactivated for domain "biysk.local", address "240464".
Success: Supplementary service voicemail deactivated for domain "biysk.local", address "240101".

info

Команда предназначена для просмотра настроек услуги "Голосовая почта (Voicemail)" у заданных абонентов.

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

domain/<DOMAIN>/ss/voicemail/info

Синтаксис:

info [-extended] [<Address>]

Параметры:

-extended - флаг, при указании которого будет показана подробная информация;
<ADDRESS> - номер или диапазон номеров абонента(ов), опциональный параметр. Диапазоны номеров указываются в фигурных скобках, например, 71{1-2,9}, что соответствует номерам 711, 712, 719.

Пример:

admin@[mycelium1@ecss1]:/$ domain/biysk.local/ss/voicemail/info -extended 240464                                                                                          
Domain: biysk.local

Supplementary services' settings:
┌────────────────┬───────────────────────────┬─┬─┬──────────────────────────────────────┬──────────────────────────────────────┬───────────────────────────────────────────┐
│    Address     │           Name            │V│E│                 MSD                  │                 SSD                  │                    CSD                    │
├────────────────┼───────────────────────────┼─┼─┼──────────────────────────────────────┼──────────────────────────────────────┼───────────────────────────────────────────┤
│240464          │voicemail                  │1│T│conflict_list = [cfu,assistant,follow_│dtmf_detector = true                  │busy = true                                │
│                │                           │1│ │me,find_me,cfu_type2]                 │                                      │email_body = []                            │
│                │                           │ │ │                                      │                                      │email_from = "%DISPLAYNAME%"               │
│                │                           │ │ │                                      │                                      │email_subject = "Voicemail from %CALLING% a│
│                │                           │ │ │                                      │                                      │t %DATE% %TIME%"                           │
│                │                           │ │ │                                      │                                      │mailbox_volume = 1800                      │
│                │                           │ │ │                                      │                                      │max_message_duration = 300                 │
│                │                           │ │ │                                      │                                      │max_silence = 0                            │
│                │                           │ │ │                                      │                                      │min_message_duration = 0                   │
│                │                           │ │ │                                      │                                      │no_reply = true                            │
│                │                           │ │ │                                      │                                      │out_of_service = true                      │
│                │                           │ │ │                                      │                                      │override_messages = true                   │
│                │                           │ │ │                                      │                                      │password = "258963"                        │
│                │                           │ │ │                                      │                                      │play_message_details = true                │
│                │                           │ │ │                                      │                                      │send_by_email = true                       │
│                │                           │ │ │                                      │                                      │timeout = 40                               │
│                │                           │ │ │                                      │                                      │unconditional = false                      │
└────────────────┴───────────────────────────┴─┴─┴──────────────────────────────────────┴──────────────────────────────────────┴───────────────────────────────────────────┘
Legend:
  V - version of the supplementary service;
  E - enable state of selected supplementary service to current domain, address

set

Команда позволяет изменять один или более параметров активации услуги "Голосовая почта (Voicemail)" на указанных номерах (при этом остальные параметры останутся неизменными).

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

domain/<DOMAIN>/ss/voicemail/set

Синтаксис:

set <ADDRESS_RANGE> [<PROPERTY> = <VALUE> [, ...]]

Параметры:

Параметр <PROPERTY>, <VALUE> такие же, как и в команде activate.

Пример:

admin@[mycelium1@ecss1]:/$ domain/biysk.local/ss/voicemail/set 240101 timeout = 15, busy = true, send_by_email = true           
Success: Supplementary service voicemail activated for domain "biysk.local" address "240101"

mailbox/modify

Команда предназначена для изменения почтового ящика абонента.

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

domain/<DOMAIN>/ss/voicemail/mailbox/modify

Синтаксис:

mailbox/modify <ADDRESS> <ACTION> <RECORD_URL_1> [, <RECORD_URL_2> [, ...]]

Параметры:

<ADDRESS> - номер абонента, у которого просматривается ящик голосовой почты;
<ACTION> :: mark-as-read | mark-as-unread | mark-as-save - пометить выбранное сообщение как прочитанное, непрочитанное, сохраненное сообщение;
<RECORD_URL_N> - URL записанного разговора, к которому применяется указанное действие.

Пример:

admin@[mycelium1@ecss1]:/$ domain/biysk.local/ss/voicemail/mailbox/modify 240465 mark-as-read subscribers/240465/voicemail/new/2018-08-06-21-43-16-240475.wav 
Address: 240465
Next files was the marked correctly
    "subscribers/240465/voicemail/old/2018-08-06-21-43-16-240475.wav" 

[exec at: 14.08.2018 13:07:38, exec time: 224ms, nodes: core1@ecss1]
admin@[mycelium1@ecss1]:/$ domain/biysk.local/ss/voicemail/mailbox/modify 240465 mark-as-save subscribers/240465/voicemail/new/2018-08-06-21-52-42-240475.wav 
Address: 240465
Next files was the marked correctly
    "subscribers/240465/voicemail/save/2018-08-06-21-52-42-240475.wav" 

[exec at: 14.08.2018 13:08:06, exec time: 183ms, nodes: core1@ecss2]

mailbox/show

Команда предназначена для просмотра почтового ящика абонента. Команда показывает состояние почтового ящика абонента: список прослушанных, не прослушанных, сохраненных сообщений, свободное место а ящике.

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

domain/<DOMAIN>/ss/voicemail/mailbox/show

Синтаксис:

mailbox/show <ADDRESS>

Параметры:

<ADDRESS> - номер абонента, у которого просматривается ящик голосовой почты.

Пример:

admin@[mycelium1@ecss1]:/$ domain/biysk.local/ss/voicemail/mailbox/show 240465                                                                                             
┌───────┬──────┬────────────────────────────────────────────────────────────────────────────────┬──────────────┬───────────────────┐
│Address│State │                                      URL                                       │Duration (sec)│       Time        │
├───────┼──────┼────────────────────────────────────────────────────────────────────────────────┼──────────────┼───────────────────┤
│240475 │unread│http://system.restfs.ecss:9990/domain/biysk.local/subscribers/240465/voicemail/n│2             │06.08.2018 21:53:17│
│       │      │ew/2018-08-06-21-53-09-240475.wav                                               │              │                   │
│240475 │read  │http://system.restfs.ecss:9990/domain/biysk.local/subscribers/240465/voicemail/o│11            │06.08.2018 21:43:24│
│       │      │ld/2018-08-06-21-43-16-240475.wav                                               │              │                   │
│240475 │save  │http://system.restfs.ecss:9990/domain/biysk.local/subscribers/240465/voicemail/s│3             │06.08.2018 21:52:50│
│       │      │ave/2018-08-06-21-52-42-240475.wav                                              │              │                   │