h1. Карточная Платформа

!calling_cards.gif!

Это приложение действует как сервер доступа для телефонных карт с системой IVR.

Это приложение:

* выполняет всю логику IVR
* органичивает длительность вызовов;
* контролирует балансы пользователей;
* производит замещения ID звонящего или вызываемого абонента, основанные на сконфигурированных шаблонах;
* проигрывает аудио приглашения и/или музыку в состоянии ожидания;
* обрабатывает DTMF-ввод пользователя;
* производит хантинг по таблице марщрутизации.

h3. _Аргументы_

!calling_cards1.gif!

*звонящий ID* - А-номер для аутентификации по А-номеру. Здесь должен указываться пришедший А-номер для поиска пользователя по А-номеру.
По умолчанию здесь установлено выражение, которое вычленяет оригинальный А-номер, который пришел от протокола телефонии.

*кол-во попыток аутентификации* - сколько раз запрашивать и выполнять поиск пользователя по секретному коду при методе аутентификации +секрет+ прежде чем отбить вызов.
*кол-во попыток авторизации направления* - сколько раз просить набрать вызываемый номер и проверять его корректность (наличие кода направления в прайс-листе) прежде чем отбить вызов.

*метод аутентификации* - метод, по которому система находит лицевой счет пользователя.
Доступные варианты:
* +секрет+ - пользователь должен ввести его секретный код по DTMF (поле _секрет_ в настройках пользователя)
* +звонящий ID+ - система ищет сопоставление *звонящего ID* [[Звонящие ID|Звонящим ID]] в настройках пользователя.
* +любой+ - система сначала пытается аутентифицировать по +звонящему ID+, затем, если неуспешно, по +секрету+.

*таймаут ввода (сек)* - сколько времени ожидать ввода одной DTMF цифры.

*говорить приглашение аутентифицироваться* - если сбросить флажок, то приглашение аутентифицироваться не будет озвучено
*говорить баланс* - если сбросить флажок, то баланс не будет озвучен
*говорить время* - если сбросить флажок, то допустимая длительность разговора согласно баланса не будет вычислена и озвучена
*говорить остальные приглашения* - если сбросить флажок, то все остальные приглашения не будут озвучены

*отбить нажатием* * - разговор с набранным абонентом можно оборвать набором DTMF (*).
При этом происходит возврат обратно в IVR меню, откуда можно, например, совершить еще вызовы или проверить баланс.
Если же обрывать разговор через сброс трубки, то затем нужно повторно дозвониться на номер дозвона и аутентифицироваться после каждого звонка, что не всегда удобно.

*класс музыки на удержании* - в время IVR есть паузы для получения DTMF от пользователя.
Если указать _класс музыки на удержании_, то в эти моменты будет проигрываться аудио файлы из указанного класса.
*прервать музыку на удержании при вводе* - если установлено, то при вводе DTMF музыка на удержании прервется.

*регистрировать ID звонящего* - при выборе _метода аутентификации_ = любой, существует возможность ввода секретного кода только в момент первого дозвона.
При успешной аутентификации система запоминает А-номер звонящего (записывает в [[Звонящие ID]] в настройках пользователя).
При последующих звонках на номер дозвона система аутентифицирует по А-номеру без ввода секретного кода.

*группа пользователей* - переключить группу пользователей найденного лицевого счета пользователя на указанную.
Это может потребоваться для предоставления других условий звонка.
Например, в зависимости от того, на какой номер дозвона позвонил пользователей.

*последовательность для повторного набора* - DTMF последовательность для быстрого повторного набора последнего набранного номера.

!calling_cards2.gif!

*включен* - задействовать режим [[Обратный вызов]].
*итог* - с каким кодом отбоя отбивать исходный звонок перед началом обратного вызова.
*звонящий ID* - с каким А-номером инициировать обратный вызов. По умолчанию это тот номер дозвона, на который позвонил пользователь.
*имя звонящего* - дополнительное имя звонящего, используемое при инициации обратного вызова (используется для протоколов, которые поддерживают такую возможность, например, SIP).
*набранный ID* - на какой Б-номер инициировать обратный вызов. По умолчанию это А-номер, с который ползователь звонил на номер дозвона.

*таймаут ответа (сек)* - сколько времени ждать ответа пользователя на обратный звонок.
По истечении таймаута работа приложения прекращается.

*спать (сек)* - на сколько времени отложить начало обратного вызова после отбоя звонка на номер дозвона.
Это нужно для того, чтоб пользователь успел положить трубку после того как услышит гудки отбоя у себя в трубке и смог принять входящий звонок от системы.

!calling_cards3.gif!

*включен* - добавить возможность пополнить счет через IVR меню, используя секретный код.

*пополнять с* - доступные варианты:
* +ваучер+ - пополнять, используя [[Ваучеры пополнения]].
  При корректном вводе секрета существующего ваучера, ему проставляется время пополнения и вся его сумма переводится на счет пользователя.
  В дальнейшем этот ваучер уже нельзя будет использовать.
* +пользователь+ - пополнять, используя другой пользовательский счет.
  При корректном вводе секрета существующего пользователя, весь положительный баланс этого пользователя переводится на счет текущего пользователя.

*услуга* - название [[Услуги]], которая будет установлена в выполненных транзакциях.
*последовательность для активации* - DTMF комбинация, которая будет использоваться для перехода в IVR меню пополнения.

!calling_cards4.gif!

Здесь вы можете изменить порядок проигрывания аудио приглашений.