/domain/<DOMAIN>/ss/voicemail/ - команды управления услугой "Голосовая почта (Voicemail)"
В данном разделе описываются команды управления услугой "Голосовая почта (Voicemail)" для абонентов.
<DOMAIN> - название виртуальной АТС.
activate
Команда предназначена для активации услуги "Голосовая почта (Voicemail)" для заданных абонентов.
Путь команды:
/domain/<DOMAIN>/ss/voicemail/activate
Синтаксис:
activate <ADDRESS_RANGE> [<PROPERTY> = <VALUE> [, ...]]
Параметры:
<ADDRESS_RANGE> - диапазон номеров, на котором необходимо активировать услугу "Голосовая почта";
<PROPERTY> - свойство, значение которого необходимо установить в значение по умолчанию.
Абоненту при активации доступны следующие свойства "Голосовая почта":
- busy - переадресовывать входящий вызов на голосовую почту в случае, если абонент занят (по умолчанию: false);
- dnd - При включенной у абонента сервиса "Не беспокоить" (dnd) в режиме default, если данный параметр активирован, то услуга "Голосовая почта" срабатывает для вызывающего абонента;
- 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, то голосовой ящик неограничен. Задается цеылм число от 10 до 43200с;
- max_message_duration - максимальная длительность голосового сообщения (по умолчанию: 300 сек). Задается целым числом от 0 до 300;
- max_silence - время (в секундах), которое сервис ждет, прежде чем завершать запись разговора, в случае определения непрерывного интервала тишины со стороны ТА. Если значение равно 0, то детектор выключен (по умолчанию 0). Задается целым числом от 0 до 15с;
- min_message_duration - минимальная длительность голосового сообщения (по умолчанию: 0). В случае, если сообщение будет меньшей длительностью, то оно не будет сохранено. Задается целым числом от 0 до 15с;
- no_reply - при установленном флаге происходит переадресация входящего вызова на голосовую почту по неответу абонента (по умолчанию: true);
- out_of_service - переадресация входящего вызова на голосовую почту в случае недоступности абонента (по умолчанию: false);
- override_messages - перезапись сообщения в случае, если почтовый ящик переполнен (по умолчанию true). Если почтовый ящик заполнен, но есть попытка записать новое сообщение, то сперва будут удаляться самые старые прочитанные сообщения, а если их не осталось - то будут удаляться самые старые непрочитанные сообщения;
- password - пароль для доступа к голосовой почте. Если параметр не заполнен, то доступ к голосовой почте осуществляется без пароля;
- play_message_details - проигрывание деталей оставленного сообщения перед тем, как играть само сообщение (по умолчанию: false);
- send_by_email - отправка записанного сообщения по e-mail (работает, если на абоненте настроен параметр e-mail) (по умолчанию: false);
- timeout - время ожидания ответа абонента, после которого сработает переадресация на голосовую почту. Задается целым числом от 0 до 60с;
- unconditional - безусловно переадресовывать входящий вызов на голосовую почту абонента (по умолчанию: false);
Пример:
admin@mycelium1@ecss1:/$ domain/biysk.local/ss/voicemail/activate 240471 send_by_email = true, timeout = 30, out_of_service = true Success: Supplementary service voicemail activated for domain "biysk.local" address "240471" [exec at: 31.03.2019 10:57:46, exec time: 184ms, nodes: ds1@ecss1]
deactivate
Команда деактивации услуги "Голосовая почта (Voicemail)" для заданных абонентов.
Путь команды:
/domain/<DOMAIN>/ss/voicemail/deactivate
Синтаксис:
deactivate <ADDRESS_RANGE>
Параметры:
<ADDRESS_RANGE> - диапазон номеров, на котором необходимо деактивировать услугу "Голосовая почта".
Пример:
admin@mycelium1@ecss1:/$ domain/biysk.local/ss/voicemail/deactivate 240471 Success: Supplementary service voicemail deactivated for domain "biysk.local", address "240471". [exec at: 31.03.2019 12:37:37, exec time: 78ms, nodes: ds1@ecss2]
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 240471 Domain: biysk.local Supplementary services' settings: ┌─────────────────────────┬──────────────────────────────────────────┬─┬─┬───────────────────────────────────────────────────────────────────┐ │ Address │ Name │V│E│ CSD │ ├─────────────────────────┼──────────────────────────────────────────┼─┼─┼───────────────────────────────────────────────────────────────────┤ │240471 │voicemail │1│T│busy = false │ │ │ │3│ │dnd = true │ │ │ │1│ │email_body = [] │ │ │ │ │ │email_from = "%DISPLAYNAME%" │ │ │ │ │ │email_subject = "Voicemail from %CALLING% at %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 = [] │ │ │ │ │ │play_message_details = false │ │ │ │ │ │send_by_email = true │ │ │ │ │ │timeout = 30 │ │ │ │ │ │unconditional = false │ └─────────────────────────┴──────────────────────────────────────────┴─┴─┴───────────────────────────────────────────────────────────────────┘ Legend: V - version of the supplementary service; E - enable state of selected supplementary service to current domain, address [exec at: 31.03.2019 12:34:57, exec time: 200ms, nodes: ds1@ecss2]
set
Команда позволяет изменять один или более параметров активации услуги "Голосовая почта (Voicemail)" на указанных номерах (при этом остальные параметры останутся неизменными).
Путь команды:
/domain/<DOMAIN>/ss/voicemail/set
Синтаксис:
set <ADDRESS_RANGE> [<PROPERTY> = <VALUE> [, ...]]
Параметры:
Параметр <PROPERTY>, <VALUE> такие же, как и в команде activate.
Пример:
admin@mycelium1@ecss1:/$ domain/biysk.local/ss/voicemail/set 240475 send_by_email = true, out_of_service = true, play_message_details = true Success: Supplementary service voicemail activated for domain "biysk.local" address "240475" [exec at: 31.03.2019 12:39:50, exec time: 119ms, nodes: ds1@ecss2]