СМС-рассылка

06.05.2022 - в Model.php скорректировано переключение между koi8r и utf8
04.05.2022 - в ConfigClass.php добавлена переменная $_use_sms_leftday_table
10.08.2021 - в ConfigClass.php изменен путь к XML конфигу согласно изменениям версии 3.11.01
28.07.2021 - в MikBillClass.php поправлен конфликт столбцов в SQL запросах.
26.07.2021 - в SmsUkraineClass.php убрано использование base64_decode (функция больше не доступна в обновлении 3.09.01)

Доступные переменные:

%left_day% - осталось дней
%pay_amount% - сумма платежа (при пополнении)
%uid% - UID абонента
%fio% - ФИО абонента
%deposit% - Баланс абонента
%credit% - Кредит абонента
%login% - Логин абонента
%dogovor% - Договор абонента
%company% - Название компании
%currency% - Валюта

Примеры ID шаблонов:

1.  'Счет пополнен успешно. Ваш баланс %deposit% %currency%'
2.  'Уважаемый абонент (login %login%) счет пополнен. Ваш баланс %deposit% %currency%'
3.  'Ваш счет пополнен на сумму %pay_amount% %currency% Теперь ваш баланс составляет %deposit% %currency%'
4.  'Счет пополнен на %pay_amount% %currency% Ваш баланс составляет %deposit% %currency%'
5.  'Ув. абонент ( лиц счет №: %dogovor%). Ваш счет пополнен на %pay_amount% %currency% На вашем счете %deposit% %currency%'
6.  'Ваш счет пополнен на сумму %deposit% %currency%'
7.  'Уважаемый абонент. Услуга Интернет будет отключена через %left_day%-дня. Пополните свой счет.'
8.  'Уважаемый абонент. Услуга Интернет будет отключена через 1 день. Пополните свой счет.'
9.  'Ув. абонент (лиц счет №: %dogovor%). Услуга интернет будет отключена через %left_day%-дня. Пополните свой счет'
10. 'Срок Вашего тарифа кончается через сутки. На Вашем счету: %deposit% %currency%'
11. 'Уважаемый абонент. Услуга Кредит активирована.'

Пример отправки:
1. Настраиваем необходимые параметры в ./lib/ConfigClass.php
2. Вызов отправки смс при пополнении, где 2-ой параметр это uid, а 3-ий - id шаблона
php send_sms.php deposit 321 1
3.1 Вызов отправки смс при взятии кредита, где 2-ой параметр это uid, а 3-ий - id шаблона
php send_sms.php credit 321 11
3.2 Вызов отправки смс при отключении кредита, где 2-ой параметр это uid, а 3-ий - id шаблона
php send_sms.php credit_off 321 12
4. Вызов отправки смс оповещения за n-дней, где 2-ой параметр это кол-во дней за которое сделать рассылку, а 3-ий - id шаблона
php send_sms.php left_day 3 7
5. Вызов отправки смс оповещения при cмене тарифного плана, где 2-ой параметр это uid, а 3-ий - id шаблона
php send_sms.php tariff 321 13
6.1 Вызов отправки смс оповещения при включении интернета , где 2-ой параметр это uid, а 3-ий - id шаблона
php send_sms.php internet 321 16
6.2 Вызов отправки смс оповещения при отключении интернета , где 2-ой параметр это uid, а 3-ий - id шаблона
php send_sms.php internet_off 321 17

P.S. Изменить/добавить свои шаблоны можно в ./lib/TemplateSMS.php

sms.tar

Скачать и распаковать файлы в директорию /var/mikbill/custom_scripts/sms

mkdir -p /var/mikbill/custom_scripts/sms
cd /var/mikbill/custom_scripts/sms
wget https://wiki.mikbill.pro/_media/billing/preferences/apps/sms.tar
tar xvf sms.tar
rm -f sms.tar

Далее дать права запуска скриптам

chmod +x send_sms_left_day.sh
chmod +x mikbill_payment_event.sh

Для начала отправки смс о балансе настройте рассылку, файл lib/ConfigClass.php

Далее нужно заменить скрипт /var/mikbill/prod/scripts/mikbill_payment_event.sh
На скрипт из архива

/bin/cp -f mikbill_payment_event.sh /var/mikbill/prod/scripts/mikbill_payment_event.sh

Для начала отправки настройте рассылку, файл lib/ConfigClass.php

Далее нужно изменить скрипт из архива send_sms_left_day.sh
После чего добавьте этот скрипт в cron на запуск в нужное время