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

<note important>Номера в поле "смс телефон" в карточке абонента должно вноситься в международном формате, во избежание дальнейших проблем с отправкой SMS </note>

===== Changelog =====
\\ **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)
===== Настройки =====

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

Примеры ID шаблонов:
<code>
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. 'Уважаемый абонент. Услуга Кредит активирована.'
</code>


Пример отправки:\\
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

===== Файлы =====
{{ :billing:preferences:apps:sms.tar |}}

===== Установка =====
<alert type="info">Для работы с биллингом, используется [[billing:configuration:events|система событий]]</alert>

\\ Скачать и распаковать файлы в директорию /var/mikbill/custom_scripts/sms
<code>
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
</code>
\\
\\ Далее дать права запуска скриптам
<code>
chmod +x send_sms_left_day.sh
chmod +x mikbill_payment_event.sh
</code>

===== Подключение рассылки о пополнении =====
\\ Для начала отправки смс о балансе настройте рассылку, файл lib/ConfigClass.php
\\ 
\\ Далее нужно заменить скрипт /var/mikbill/prod/scripts/mikbill_payment_event.sh
\\ На скрипт из архива
<code>
/bin/cp -f mikbill_payment_event.sh /var/mikbill/prod/scripts/mikbill_payment_event.sh
</code>

===== Подключение рассылки о оставшемся количестве дней =====
\\ Для начала отправки настройте рассылку, файл lib/ConfigClass.php
\\ 
\\ Далее нужно изменить скрипт из архива send_sms_left_day.sh
\\ После чего добавьте этот скрипт в cron на запуск в нужное время