Page History

Модуль отправки SMS сообщений. Может использовать локальный и удалённые шлюзы отправки смс.

При отправке СМС система передает плагину текст сообщения и номер адресата. Плагин по протоколу шлюза отправляет данные на СМС шлюз и получает статус отправки, также заносит данные по отправке СМС  сообщения в базе.

• Настройка Sms-сервисов
• Список Sms-сервисов
• Импорт Sms-систем с config.pl

Возможности

• Восстановление пароля через SMS

• Отправка пароля администратором

• Отправка отчётов модулем Ureports

• Отправка SMS сообщений модулем Msgs

При воcстановлении пароля и отправки сообщений через техническую поддержку номер телефона берётся с учётной записи абонента, а при отправке отчётов из заполненного поля отчётов. 

Для отправки СМС сообщений используются шлюзы:

Установка

Создать таблицы в базе.

mysql --default-character-set=utf8  -D abills < db/Sms.sql

Подключение модуля. abills/libexec/config.pl

@MODULES = (
          'Sms'
          );

Настройка

Turbosms

Image Removed

Sms Отчёты

Отчёты находятся в меню  Отчёт>Sms.

Система предоставляет полный отчёт по отправленным сообщениям.

Также упрощенная версия отчета по пользователю находится по пути Клиенты>Логины>Информация>Сервисы>SMS.

Возле названия таблицы выведена кнопка для обновления статуса СМС доставки

Image Added

Синхронизация статусов

Плагин синхронизации статусов забирает статусы и вносит в билинг с sms-сервисов.

cp Turbosms.pm /usr/abills/Abills/modules/Sms/

Для отправки сообщений используется режим работы с базой данных.

/libexec/billd sms_status

Посмотреть что выполняет скрипт

/usr/abills/libexec/billd sms_status DEBUG=2

Пример крона.

*/10 * * * * root /usr/abills/libexec/billd sms_status

Дополнительные настройки

Пример обработки номера регулярным выражением:

$conf{SMS_

NUMBER_

EXPR} =

 '^([0-9]{4,6})$/74832;'. 
    '^2([0-9]{6})$/7483;'.
    '(^9[0-9]{9})/7;'. 
    '^810/;'.
    '^8/7;'. 
    '^*8/7;'. 
    '^4832/74832';

Изменения номеров формата 050xxxxxxx на +380xxxxxxx:

$conf{SMS_

NUMBER_

EXPR} =

 '^0/+380;';

В своей учетной записи на сайте turbosms.ua нужно задать шлюз и создать подпись

Image Removed

Image Removed

Шаблоны

Работа с шаблонами

Sms Callback

Sms callback - шлюз для клиентских запросов посредством Sms.

Подключение

mysql -P 3306 -h 94.249.146.189 -u ЛогинШлюза -p users

Далее вводите пароль шлюза. Название таблицы, с которой вы работаете в базе совпадает с логином шлюза. Посмотреть какие сообщения были занесены в таблицу, можно командой

MySQL [users]> SELECT * FROM ЛогинШлюза;

Если смс есть в базе, но не отправляются пользователям - посмотрите на статус записи и код ошибки.

Epochtasms

Image Removed

Для работы с службой нужно установить Perl модуля JSON 

Настройка службы Epochtasms 

Image Removed

После настройки перейдите в меню Регистрация имен отправителей и зарегистрируйте Ваш идентификатор. После регистрации занесите его в переменную $conf{SMS_EPOCHTASMS_SENDER}='sender_name';.

Littlesms

Image Removed 

Для работы с службой нужно установить Perl модуля JSON и программу CURL

cd /usr/abills/cgi-bin/
ln -s ../Abills/modules/Sms/sms_callback.cgi sms_callback.cgi
chmod +x sms_callback.cgi

Настройки

Пример запроса:

https://192.168.1.169:9443/sms_callback.cgi?apikey=1234567890abcdef&sender=0681234567&text=123+03+12345678

Пример SMS сообщения: 123+03+124+12345678, где

Все поддерживаемые типы команды

Отправка СМС после регистрации абонента

Если у вас включен модуль Смс, тогда во время регистрации у вас появится дополнительный шаг с отправкой СМС пользователю о окончании регистрации. По стандарту будет отправлен шаблон %LOGIN%:%PASSWORD% но вы можете отредактировать шаблон 

internet_user_memo_sms под себя, зайдите в Настройка → Другое → шаблоны и найдите данный шаблон что бы отредактировать его

Image Added

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

Image Added

Для отправки СМС берётся "Мобильный номер телефона" если же вы указали контакт пользователя в поле "телефон" тогда в форме отправки поле "Телефон" будет пустым

Шаблонные переменные в теле сообщения

Также в теле сообщения можно использовать такие шаблонные переменные:

Персональная информация - %FIO%, %LOGIN%, %PHONE%, %EMAIL%, %CITY%,% ADDRESS_DISTRICT%, %ADDRESS_STREET%, %ADDRESS_BUILD%, %ADDRESS_FLAT%, %ADDRESS_FULL%, %CONTRACT_ID%.

Интернет информация - %TP_NAME%, %MONTH_ABON%, %DAY_ABON%.

Параметр конфигурации

Смс после регистрации

Если вы не хотите чтобы у вас при регистрации появился дополнительный шаг с отправкой СМС тогда вам надо в конфигурационном файле прописать следующий параметр 

$conf{SMS_REG_GREETING}=1; 

Этот параметр будет отвечать за автоматическую отправку СМС пользователю если был заполнен на первом шаге "Мобильный телефон"

То есть если данная переменная будет прописана, тогда у вас данное окно отправки смс будет только доступно из меню.

Дополнительные параметры

Лимит смс для пользователя

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

$conf{USER_LIMIT_SMS} = 20;

В данном примере пользователю будет доступно только 20 смс в месяц, после того как он превысит этот лимит он не сможет отправить в этом месяце больше смс, но как прийдет следующий месяц ему снова будет доступно 20 смс.

Выбор СМС шлюза в зависимости от группы пользователя

В настройках группы в поле СМС шлюз можно выбрать один з доступных (установленных) СМС шлюзов.

Для всех пользователей в этой группе будет использоваться выбранный шлюз.

Image Added