Перейти к содержимому

Приложение Calling Card

Этот перевод выполнен автоматически и ещё не вычитан. Читать английскую версию

Приложение Calling Card превращает любой телефон в предоплаченный сервис звонков: абонент набирает номер доступа, выбирает язык, указывает карту, слышит баланс и набирает направления, звонки на которые списываются с карты. Каждая карта - это аккаунт; приложение только определяет его и совершает звонки. Пошаговую настройку продукта см. в разделе Настройка продукта «телефонная карта».

  1. Абонент попадает в приложение через назначенный ему DID или через подключение с ключевым словом callingcard.
  2. Проигрывается собственное приветствие или раннее приветствие, затем меню выбора языка предлагает языки из списка Language List (список языков) по порядку.
  3. Карту определяют: по номеру абонента, если это доверенный номер карты, иначе по номеру карты и, если это не отключено, PIN-коду.
  4. Проигрывается позднее приветствие, затем баланс, а после набора направления - время, в течение которого абонент может говорить.
  5. Приложение звонит на направление от имени аккаунта карты, через его сервисный план и группу маршрутизации. После звонка абонент может набрать другое направление или воспользоваться меню: быстрый набор, регистрация CLI, смена пароля, пополнение.

Номер карты - это Account Name (имя аккаунта) аккаунта или его VoIP Login (VoIP-логин), если включён Use VoIP Login As Card Number (VoIP-логин как номер карты). PIN-код - это VoIP Password (VoIP-пароль) аккаунта.

  1. Откройте DIDs & IVR Apps → IVR Applications и нажмите Add New (добавить).
  2. Введите Name (название), выберите Type (тип) Calling Card и языки по порядку.
  3. Нажмите Save (сохранить), откройте Advanced Parameters (дополнительные параметры) и добавьте параметры из таблиц ниже, отличающиеся от стандартных.
  4. Назначьте DID номера доступа приложению в DIDs & IVR Apps → DID Pool.
Параметр Стандартное значение Описание
Card Number Length 20 Максимальное количество цифр номера карты; на этой длине ввод завершается
Minimum Card Number Length Минимальное количество цифр номера карты
Use Word PIN true Говорить «PIN-код» вместо «номер карты» во всех меню; отключает проверку пароля
Allow Empty PIN true Принимать карты, у аккаунта которых нет PIN-кода
Use VoIP Login As Card Number false Искать карты по VoIP Login, а не по Account Name
Number Of Attempts To Enter A Card 3 Количество попыток ввести правильный номер карты
Number Of Timeouts 3 Количество тайм-аутов ввода подряд, после которых звонок завершается
Allow Own Accounts Only false Принимать только карты клиента, которому принадлежит приложение

Доверенный номер связывает телефонный номер абонента с картой, поэтому абонента узнают без ввода карты. Доверенные номера перечислены на экране Trusted Numbers (доверенные номера) аккаунта.

Параметр Стандартное значение Описание
Trusted CLI Authentication false Узнавать абонентов по доверенным номерам
PIN-less CLI Authentication false Не запрашивать PIN-код, если абонент узнан по номеру
CLI As Card Number false Сначала пробовать номер абонента как номер карты, а затем запрашивать карту
Use CLI Authentication Only false Пропускать только абонентов с доверенным номером
Enable CLI Registration true Предлагать меню, в котором абонент регистрирует свой номер для карты
CLI Registration Menu Extension Number Внутренний номер этого меню
Automatic CLI Registration false Регистрировать номер абонента после первого успешного ввода карты
Silent Automatic CLI Registration true Регистрировать, не спрашивая абонента
Minimum Valid CLI Length 6 Более короткие номера никогда не регистрируются
Trusted Numbers Limit Максимальное количество доверенных номеров на карту, зарегистрированных через IVR
Balance Threshold Minimum Balance Если баланс ниже, номер карты запрашивается даже для доверенного номера
Параметр Стандартное значение Описание
Announce Balance true Объявлять баланс в начале сеанса
Say Negative Balance As Zero true Объявлять отрицательный баланс как ноль
Minimum Balance Если доступный баланс ниже, карта заблокирована; 2 USD или просто число
Say ‘No Card’ On Low Balance true Отвечать на карту с балансом ниже минимального как на неверный номер карты
Announce Duration true Объявлять перед соединением время, в течение которого абонент может говорить
No Seconds In Duration false Не озвучивать секунды
No Hours In Duration false Объявлять только минуты: «80 минут» вместо «1 час 20 минут»
Play Service Plan Minutes Only false Объявлять только минуты сервисного плана
Ignore Connect Fee false Не учитывать плату за соединение при расчёте длительности
Minimum Call Duration 10 Если рассчитанная длительность меньше, абонент слышит, что средств недостаточно
Maximum Call Duration 3600 Самый длинный исходящий звонок, в секундах
Disconnect Warning Time За сколько секунд до исчерпания баланса проигрывается предупреждение
Normal Calls Are Allowed true Со значением false работают только меню, внешних звонков нет
Call Several Destinations true Разрешить абоненту набрать номер снова после звонка
Number Of Wrong Destinations 3 Количество неудачных направлений подряд, после которых звонок завершается
Disconnect On Failure false Завершать сеанс после неудачного звонка, а не запрашивать другое направление
Preserve Original CLI false Показывать направлению собственный номер абонента вместо номера карты
Destination Number Completion Regex Регулярное выражение, завершающее ввод номера без #
Suppress Pound Phrase false Не говорить «и нажмите решётку»
Outbound SIP Proxy Хост и порт, на которые приложение отправляет исходящие звонки
The Reason For Diversion unconditional Причина в заголовке Diversion исходящих звонков
Параметр Стандартное значение Описание
Enable Hot Dial true Разрешить абонентам сохранять номера за отдельными клавишами
Hot Dial Menu Extension, Hot Dial Edit Menu Extension Внутренние номера меню быстрого набора и его редактора
Enable Direct Hot Dial false Одна клавиша в главном меню набирает сохранённый номер
Limit Hot Keys false Клавишами быстрого набора работают только 1, 2 и 3
Smart Dial Exclusive Mode false DID smart dial обслуживает только один аккаунт
Enable Password Change true Предлагать меню смены PIN-кода
Change Password Menu Extension Number Внутренний номер этого меню
Enable Top-Up feature true Предлагать меню пополнения
Top-Up Menu Extension Внутренний номер меню пополнения
Top-Up Card Length 10 Максимальное количество цифр карты пополнения
Enable Black List false После повторных неверных карт разрешать номеру абонента только одну попытку ввода карты за звонок
Number Of Attempts To Blacklist 3 Количество неверных номеров карты подряд, после которых номер абонента попадает в чёрный список
Параметр Стандартное значение Описание
Language List en Языки, предлагаемые в начале; обычно задаются селекторами языков в форме
Default Calling Card Language en Язык, если абонент ничего не выбрал
Fallback To Default Calling Card Language false Переходить на него после слишком большого числа неверных выборов языка
Enable Custom Greeting, Custom Greeting File false Проигрывать аудиофайл перед меню выбора языка
Early Greeting Prompt ID Голосовая подсказка перед меню выбора языка, одинаковая для всех языков
Late Greeting Prompt ID Голосовая подсказка после определения карты, своя для каждого языка
Параметр Стандартное значение Описание
Custom Script To Check Destination Python-скрипт на коммутаторе, который разрешает или запрещает каждое направление
Custom Script To Change Announced Duration Скрипт на коммутаторе, который меняет объявляемую длительность, не меняя реального лимита

Для приветствий используются IVR-подсказки: аудиозаписи, хранящиеся на коммутаторе с идентификатором, при необходимости отдельная запись для каждого языка. Подсказки создают на сервере инструментом ivr_prompt_utils из аудио 8 kHz signed linear; их может создать для вас служба поддержки или администратор вашего сервера. Укажите идентификатор подсказки в Early Greeting Prompt ID или Late Greeting Prompt ID либо для отдельного номера доступа с помощью greet<id> и lgreet<id> в набранном номере. Абоненты, для языка которых нет записи позднего приветствия, слышат стандартную запись.

Одно приложение может обслуживать несколько номеров доступа с разным поведением: параметры, добавленные к callingcard в CLD, переопределяют настроенные параметры для этого звонка. Двухбуквенные параметры считаются списком языков.

Параметр Описание
en, es, ru, … Предлагаемые языки по порядку
playbalance, noplaybalance или nobalance Объявлять или не объявлять баланс
noplayduration или noduration Не объявлять длительность
planminutes Объявлять только минуты сервисного плана
trustcli Доверять номерам абонентов; никогда не запрашивать PIN-код
trycliauth или cliauth, nocliauth Пробовать или не пробовать номер абонента как номер карты
nocardenter или climaponly Завершать сеанс, если у абонента нет доверенного номера
keepcli, nokeepcli Показывать направлению собственный номер абонента или номер карты
nodial Только меню, без внешних звонков
noredial Завершать звонок после первой попытки звонка
earlymedia Оставаться в режиме early media, пока направление не ответит
greet<id>, lgreet<id> Голосовые подсказки раннего и позднего приветствия
hotdialext<ext>, hotdialeditext<ext>, directhotdial, nohotdial Меню быстрого набора и прямой быстрый набор
cliregext<ext>, noclireg Меню регистрации CLI
chpassext<ext>, nochpass Меню смены пароля
topupext<ext>, notopup Меню пополнения
topup Запускать только меню пополнения. См. Приложение Top Up

Пример: s/.*/callingcard_en_es_ru_cliregext003_trustcli_noplaybalance/.

Баланс не объявляется, если в сервисном плане аккаунта есть минуты, если план приостановлен или если баланс нулевой.