Получение сведений о балансе и пополнение счета

Возможности

  • Получение сведений о балансе
    • авторизация по любому параметру аккаунта абонента (PHONE,CONTRACT_ID,UID,BILL_ID).
  • пополнение счета используя карточки пополнения
  • открытие кредита
  • пополнение с карточки оплат (если есть модуль cards)
  • прием заявок на тех.поддержку
  • получение информации о предоставляемых акциях и услугах
  • мультиязычный интерфейс

Алгоритм работы программы

Настройка

Установить Perl AGI интерфейс.

скопировать программу оповещения

# cp balance_recharge.agi /usr/abills/Abills/modules/Voip/
# chmod +x /usr/abills/Abills/modules/Voip/balance_recharge.agi

прописать в extensions.conf

[default]
exten => 100,1,AGI(/usr/abills/Abills/modules/Voip/balance_recharge.agi,${CALLERID(num)})
; call operator
exten => _X.,n,Goto(app-announcement-6,s,1)

При звонке система автоматически старается распознать абонента по его номеру в карточке персональной информации (не путать с номером сервиса Voip), если это не удаётся абоненту предлагается ввести другой параметр авторизации. По умолчанию второстепенный параметр авторизации это поле пароля. Также можно определить любой другой параметр для авторизации указав его в опции $conf{VOIP_PIN_VERIFY_PARAM} (PHONE / PASSWORD / CONTRACT_ID, или любое информационное поле). Если при определении по номеру система находит больше одного абонента то предлагает ввести пароль для автентификации абонента.

Мультиязычность

При подключении абонента система предлагает ему выбрать удобный для него язык. По умолчанию используется дефалтный язык системы. Для определения языков нужно определить переменную.

$conf{'VOIP_IVR_LANG'} = 'ru:russian:русский;ua:ukraine:українська;en:english:english';


Формат

короткое название:название файла локализации:название языка

По умолчанию

$conf{'VOIP_IVR_LANG'}='ru:russian:русский';

Пополнение счета.
Если включён модуль Cards после прохождения авторизации абоненту предлагается ввести пинкод карточки пополнения.

Для озвучивания предложений система использует программу googletts

googletts.agi нужно установить в каталог /usr/abills/Abills/modules/Voip/

если googletts.agi находится в другой папке можно задать путь в переменной $conf{VOIP_GOOGLETTS}='/usr/abills/Abills/modules/Voip/googletts.agi';

также нужно установить перл модуль LWP/UserAgent.pm

Информация о бонусных программах

Включить информацию о бонусных программах и рекламу услуг

$conf{VOIP_IVR_MARKETING}='путь к воспроизводимому файлу';

Другие опции

$conf{'VOIP_IVR_MSGS_CHAPTER'}=1; Раздел сообщений для голосовых сообщений
$conf{'VOIP_IVR_WELCOME'}='_WELCOME'; Приветствие. (По умолчанию _WELCOME %FIO%)
$conf{VOIP_IVR_UNAUTH_REDIRECT}=1; Перенаправлять не авторизованных абонентов на службу поддержки. Екстеншин службы поддержки должен идти сразу за екстеншином balance_recharge
$conf{VOIP_IVR_MULTI_AUTH}='_PHONE2'; список дополнительных полей для идентификации абонента, поля нужно указывать заглавными буквами через запятую
$conf{VOIP_IVR_OPERATOR_CALL}='ext-group,700,1'; Вызов оператора. Если нет этой опции система просто завершает работу ivr и переходит к следующему правилу extensions.conf
$conf{VOIP_IVR_RECORD_PATH}='/usr/abills/Abills/templates/ivr_record/'; Если включена эта опция, то вызовы операторов будут записываться в файл в данную папку. Файл будет иметь вид ДАТА-ВРЕМЯ-НОМЕР_ЗВОНЯЩЕГО.wav
$conf{VOIP_IVR_SKIP_AUTONUM}=1; Убрать авто нумерацию меню
$conf{VOIP_IVR_MONEY_FILE}=1; Читка денежных счетов из файла (по умолчанию читается из google)

Работа с сервисом

Режим отладки

включение режима отладки $conf{VOIP_IVR_DEBUG}

1 Режим уведомлений
2 Режим отладкий

Отладочные данные записываются в файлы abills/var/log/ivr.log

Список звуковых файлов

По умолчанию система использует googlet для чтения звуковых маркеров. Но можно записать собственные звуковые файлы в формате wav (44100Khz 16 bit) или gsm в каталог abills/var/ivr/ru. Если нужно использовать несколько языков тогда создайте дополнительные каталоги с файлами (abills/var/ivr/ua - для украинских, abills/var/ivr/en - для английских).

Список маркеров

ADDITIONAL_SERVICES Дополнительные услуги
ADD_ERROR Ошибка пополнения
APPLICATION_ACCEPTED заявка принята
APPLICATION_DECLINED Заявка отклонена. Обратитесь к администратору
ASTERISK Звёздочка
AUTH_ERROR Ошибка авторизации. Попробуйте ещё раз
BRUTE_ATACK Перебор паролей
CHOOSE_LANGUAGE Выберите язык
CREDIT Кредит
CREDIT_CHARGE за открытие кредита с вас будет снято
CREDIT_OPENED Кредит открыт
CREDIT_POSSIBILITY У Вас есть возможность открыть кредит на
CREDIT_POSSIBILITY_OVER Ви исчерпали возможность получения кредита
DAYS Дни
DEPOSIT Депозит
DLYA Для
ENTER_PASSWORD Введите пароль
ERR_WRONG_DATA Неверные данные
GOOD_DAY Добрый день
INTERNET_ACTIVE услуга интернет активна
MAIN_MENU Главное меню
MESSAGE_AFTER_SIGNAL оставьте сообщение после сигнала
NAS_DISABLED коммутатор отключен
NAS_TECH_WORK Ведуться технические работы на коммутаторе
NEGATIVE_BALANCE У вас отрицательный баланс. Пополните счет пожалуйста. Текущий баланс
NOT_EXIST Не существует
PAYMENT_ADDED Указанная сумма добавлена на счет
PIN_SHARP Для пополнения счёта введите пин и нажмите решетку
PRESS Нажмите
PRESS_ONE_TO_OPEN_CREDIT Для открытия кредита нажмите один
PRESS_TWO_FOR_ENTER Для входа нажмите два
REPLAY_MENU Повторить меню
STATIC_IP Статический айпи адрес
STEP Шаг
TARIFF_PLAN Тарифний план
TELEPHONY_ACTIVE Услуга телефонии активна
TRY_AGAIN Попробуйте ещё раз
TV_ACTIVE Услуга телевидение активна
UNKNOWN_USER Неизвестный абонент
WELLCOME Добро пожаловать
YOUR_BALANCE Ваш баланс
YOU_ARE_NOT_AUTHORISED Вы не авторизированы

Установка дополнительного ПО

Ubuntu

apt-get install sox
apt-get install mpg123

Freebsd

pkg install sox
pkg install mpg123

Тест на демо-странице

Протестировать можно у нас на https://demo.abills.net.ua:9443/admin/
login:abills / password:demo
для етого вам нужно :

  1. Установить софтфон (например x-lite) http://www.counterpath.com/x-lite
  2. В биллинге выбрать юзера на котором будем проводить опыты, по правому меню перейти в настройки Voip етого клиента ,дать ему номер телефона.
  3. В Eyebeam создать учетную запись соответствующую етому клиенту ,адрес сервера указать abills.net.ua
    (или взять готового юзера «121212» с телефоном «121212» и паролем «123456» , при авторизации в asterisk- пароль,- 121212)
  4. Звонить на номер 100.

или eyebeam: