В данном разделе описываются команды управления услугой "Найди меня" ("Find me") для абонентов в рамках определенной виртуальной АТС.
Услуга "Найди меня" ("Find me") является расширенной версией стандартной безусловной переадресации и позволяет перенаправлять вызов на список номеров осуществляя поиск абонента.
activate
Команда для активации услуги "Найди меня" ("Find me") у заданных абонентов.
Путь команды:
domain/<DOMAIN>/ss/find-me/activate
Синтаксис:
activate <ADDRESS_RANGE> <PROPERTY> <VALUE>
Параметры:
<ADDRESS_RANGE> - номер(а) абонентов, для которых выполняется настройка услуги, символ "*" используется для указания всех абонентов заданного домена.
<PROPERTY> - общие свойства услуг. У услуги Find me есть свойство send_call_diversion. Показывает, необходимо или нет посылать нотификацию о том, что была осуществлена переадресация вызова.
<VALUE> - значение свойства send_call_diversion (может принимать значения true/false).
Пример:
domain/test.domain/ss/find-me/activate 77770 send_call_diversion = false Success: Supplementary service find_me is activated for domain "test.domain" address "77770"
add-group
Команда для добавления новой группы поиска на указанные номера.
Путь команды:
domain/<DOMAIN>/ss/find-me/add-group
Синтаксис:
add-group <ADDRESS_RANGE> <NUMBERS> <WAIT_TIMEOUT> <ENABLED>((predefined <TIMETABLE_NAME>) | (custom <DAYS> <FROM_HH>:<FROM_MM>-<TO_HH>:<TO_MM>[, <FROM_HH>:<FROM_MM>-<TO_HH>:<TO_MM>,...]))
Параметры:
<ADDRESS_RANGE> - номер(а) абонентов, для которых выполняется настройка услуги, символ "*" используется для указания всех абонентов заданного домена.
<NUMBERS> - телефонные номера, входящие в группу, на которые будет осуществляться переадресация ([Number1, Number2,...]);
<WAIT_TIMEOUT> - ожидания ответа для группового вызова, может принимать значения от 5 до 90 с;
<ENABLED> - включить или отключить текущую группу. Принимает значения true | false.
<TIMETABLE_NAME> - имя уровня «расписания» для определенного домена/пользователя;
<DAYS> - дни недели, в которые включена переадресация на указанную группу. Может быть более одного: 12345.
Пример:
domain/test.domain/ss/find-me/add-group 77770 [354420,354422] 10 true custom 123 18:00-08:00 Success: Group added for find_me service on domain "test.domain" address "77770"
info
Команда предназначена для просмотра настроек услуги "Найди меня" ("Find me") в рамках виртуальной АТС.
Путь команды:
domain/<DOMAIN>/ss/find-me/info
Синтаксис:
info [-extended] [<Address>]
Параметры:
-extended - флаг, при указании которого будет показана подробная информация;
<ADDRESS> - номер или диапазон номеров абонента(ов), опциональный параметр. Диапазоны номеров указываются в фигурных скобках, например, 71{1-2,9}, что соответствует номерам 711, 712, 719.
Пример:
domain/test.domain/ss/find-me/info 77770 Domain: test.domain Supplementary services' settings: ┌─────────────┬──────────────────────┬─┬─┬────────────────────────────────────┐ │ Address │ Name │V│E│ CSD │ ├─────────────┼──────────────────────┼─┼─┼────────────────────────────────────┤ │77770 │find_me │4│T│groups[1] = │ │ │ │ │ │ enabled = true │ │ │ │ │ │ numbers = 354410, 354412 │ │ │ │ │ │ wait timeout = 10 sec │ │ │ │ │ │ custom work interval = {days: 56│ │ │ │ │ │; times: 20:00-06:00} │ │ │ │ │ │groups[2] = │ │ │ │ │ │ enabled = true │ │ │ │ │ │ numbers = 354420, 354422 │ │ │ │ │ │ wait timeout = 10 sec │ │ │ │ │ │ custom work interval = {days: 12│ │ │ │ │ │3; times: 18:00-08:00} │ │ │ │ │ │send_call_diversion = false │ └─────────────┴──────────────────────┴─┴─┴────────────────────────────────────┘ Legend: V - version of the supplementary service; E - enable state of selected supplementary service to current domain, address
remove-group
Команда предназначена для удаления заданной группы поиска c указанного номера (номеров).
Путь команды:
domain/<DOMAIN>/ss/find-me/remove-group
Синтаксис:
remove-group <ADDRESS_RANGE> <GROUP_INDEX>
Параметры:
<ADDRESS> - номер или диапазон номеров абонента(ов), опциональный параметр. Диапазоны номеров указываются в фигурных скобках, например, 71{1-2,9}, что соответствует номерам 711, 712, 719.
<GROUP_INDEX> - серийный номер группы в списке для услуги "Найди меня" ("Find me"). Он отображается в команде info.
Пример:
domain/test.domain/ss/find-me/remove-group 77770 2 Success: Group removed from find_me service on domain "test.domain" address "77770"
set
Команда предназначена для изменения настроек услуги "Найди меня" ("Find me").
Путь команды:
domain/<DOMAIN>/ss/find-me/set
Синтаксис:
set <ADDRESS_RANGE> <PROPERTY> <VALUE>
set <ADDRESS_RANGE> group <GROUP_INDEX> <GROUP_PROPERTY> <GROUP_VALUE>
Параметры:
<ADDRESS> - номер или диапазон номеров абонента(ов), опциональный параметр. Диапазоны номеров указываются в фигурных скобках, например, 71{1-2,9}, что соответствует номерам 711, 712, 719.
<PROPERTY> - общие свойства услуг. У услуги Find me есть свойство send_call_diversion. Показывает, необходимо или нет посылать нотификацию о том, что была осуществлена переадресация вызова.
<VALUE> - значение свойства send_call_diversion (может принимать значения true/false).
<GROUP_INDEX> - серийный номер группы в списке групп для услуги "Найди меня" ("Find me"). Он отображается в команде info.
<GROUP_PROPERTY> - изменяемое свойство, может принимать значения numbers | wait_timeout | enabled | interval;
<GROUP_VALUE> for numbers - номера для переадресации [Number1, Number2,...];
<GROUP_VALUE> for wait_timeout - ожидания ответа для группового вызова, может принимать значения от 5 до 90 с;
<GROUP_VALUE> for enabled - включение или отключение выбранной группы, принимает значения true | false;
<GROUP_VALUE> for interval - ((predefined <TIMETABLE_NAME>) | (custom <DAYS> <FROM_HH>:<FROM_MM>-<TO_HH>:<TO_MM>[, <FROM_HH>:<FROM_MM>-<TO_HH>:<TO_MM>,...]))
<TIMETABLE_NAME> - имя уровня «расписания» для определенного домена/пользователя;
<DAYS> - дни недели, в которые включена переадресация на указанную группу. Может быть более одного: 12345.
Пример:
domain/test.domain/ss/find-me/set 77770 group 1 enabled false Success: Property changed for find_me service on domain "test.domain" address "77770"