Page History

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

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

Возможности

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

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

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

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

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

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

• TurboSms

• ePochtasms
  

• Littlesms

• Smsc

• Настройка
  • Настройка Sms-сервисов
  • Turbosms
  • Epochtasms
  • Littlesms
  • Smsc
  • Txtlocal
  • Smseagle
  • Sms Broker
  • Playmobile
  • IDM.KG
  • Bulksms

• • CMD

Установка

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

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

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

@MODULES = (
          'Sms'
          );

Настройка

Turbosms

Image Removed

Страна: Украина/Россия

Скопировать модуль в рабочую папку

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

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

Параметры конфигурации модуля: abills/libexec/config.pl

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

Image Removed

Image Removed

Проверка работы с шлюзом MySQL

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

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

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

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

Отправка на Viber

Для того, чтобы сделать отправку на Viber через шлюз TurboSms нужно прописать в config.pl такой параметр:

$conf{SMS_TURBOSMS_VIBER} = 1;

Так же надо будет прописать параметры для того чтобы система понимала куда отправлять

Возможные ошибки

При отправки смс через шлюз TurboSMS допускаются такие внутренние ошибки

Image Removed

Код ошибки доступен к просмотру в Отчет → Sms

Epochtasms

Image Removed

Сайт: ePochta sms

Страна: Украина/Росия

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

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

Image Removed

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

Littlesms

Страна: Украина/Россия

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

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

Smsc

Image Removed

Страна: Любая страна

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

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

Txtlocal

Image Removed

Jasmin SMS

Страна: Любая страна

Jasmin - локальный смс-шлюз предназначенный для отправки СМС-сообщений напрямую в центры сообщений телекоммуникационных компаний. Шлюз использует стандартный протокол SMPP, который поддерживает большинство операторов мобильной связи.

Установка собственного сервера Jasmin - http://docs.jasminsms.com/en/latest/installation/index.html .

Smseagle

Страна: Польша

SMSEagle - железный SMS шлюз.

Sms Broker

Страна: Россия

Параметры настройки

Playmobile

Страна: Россия

Параметры настройки

IDM.KG

Страна: Казахстан

Bulksms

Страна: Любая страна

$conf{SMS_BULKSMS_API} = 'http:/ /10.0.15.2/index.php'; 

Адрес по которому доступен API. 

https://api.bulksms.com/v1

Для данной СМС рассылки сделано 2 файла:

Bulksms.pm - з поддержкой xml формата

Bulksms_v2.pm - с поддержкой json формата

mv Bulksms_v2.pm /usr/abills/Abills/modules/Sms/Bulksms.pm

Nikita

Страна: Казахстан

Universal_sms_module

Описание

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

Параметры конфигурации модуля: 
abills/libexec/config.pl 

$conf{SMS_UNIVERSAL_URL} = 'http://URL?number=%NUMBER%&message=%MESSAGE%';

URL - Сервер обрабатывающий запрос 

В запрос прописываем параметры в следующем формате:

НАЗВАНИЕ_ПАРАМЕТРА=%ПАРАМЕТР%

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

  %NUMBER% - номер телефона абонента

  %MESSAGE% - Текст сообщения

  %HEX_MESSAGE% - Текст сообщения в хексе.

Пример: 

login=User&pass=123456

Пример:

http://192.168.1.1/index.cgi?login=User&pass=123456&number=%NUMBER%&message=%MESSAGE%

CMD

Описание

Параметры конфигурации модуля: 
abills/libexec/config.pl 

$conf{SMS_CMD} = '/path/to/file NUMBER=%NUMBER% MESSAGE=%MESSAGE%';

Параметры для программы прописываем в следующем формате:

НАЗВАНИЕ_ПАРАМЕТРА=%ПАРАМЕТР%

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

  %NUMBER% - номер телефона абонента

  %MESSAGE% - Текст сообщения

Пример: 

login=User&pass=123456

Установка Gammu для отправки с usb модема

sudo apt install gammu

для настройки используем команду

gammu-config

прописывает в каком порту находится USB модем

Запускаем утилиту идентификации модема:

sudo gammu identify

Если все хорошо - вывод примерно такой

Устройство     : /dev/ttyUSB0
Производитель  : Huawei
Модель         : E1550 (E1550)
Прошивка       : 11.608.14.11.222
IMEI           : 359124036500000
Номер SIM IMSI : 255061025200000

Все модуль готов к отправке.

смс можно отправить с помощью команды 

gammu sendsms TEXT 082111978168 -text "Halooo .."

Eskiz sms

Eskiz.uz

Страна: Узбекистан

Скопировать модуль в:

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

Параметры конфигурации модуля: 
abills/libexec/config.pl 

Omnicell

Страна: Украина

Скопировать модуль в:

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

Параметры конфигурации модуля: 
abills/libexec/config.pl 

$conf{SMS_OMNICELL_URL}

https://api.omnicell.com.ua/ip2sms/

$conf{SMS_OMNICELL_LOGIN}

$conf{SMS_OMNICELL_PASSWD}

$conf{SMS_OMNICELL_EXT}

 Регулярное выражения для проверки мобильного номера, система Omnicell требует международный форма с '+' и кодом странны, в суме 12 цифр должно быть.

Регулярное выражения:

(\+)([0-9]{0,12})

Также доступна отправка на Viber, для такой отправки вам надо в конфигурационном файле прописать $conf{SMS_OMNICELL_VIBER} = 1; после чего при создание сообщения вы сможете выбрать пункт Viber 

Image Removed

Протокол:

https://docs.omnicell.com.ua/pages/viewpage.action?pageId=4358324

Likon Sms

Страна: Узбекистан

Параметры шлюза выглядят следующим образом

$conf{SMS_LIKON_URL}

Отправлять надо на шлюз - http://89.108.99.126/sendsmsapi/

MsgAm

Страна: Азербайджан

Скопировать модуль в:

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

Параметры конфигурации модуля: 

abills/libexec/config.pl 

$conf{SMS_MSGAM_URL}

Cablenet

Страна: Узбекистан

Скопировать модуль в:

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

Параметры конфигурации модуля: 

abills/libexec/config.pl 

$conf{SMS_CABLENET_URL}

WebSms

Страна: Беларусь 

Скопировать модуль в:

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

Параметры конфигурации модуля: 

abills/libexec/config.pl 

$conf{SMS_WEBSMS_URL}

Важное замечание!

У websms изменилось API.

Старый вариант АПИ, актуален до версии модуля 8.03

URL  шлюза: cp.websms.by/api/?r=api

Документация по шлюзу

http://cp.websms.by/apidocs/#/СМС-сообщения/get_msg_send

Fenix

Страна: Украина

Скопировать модуль в:

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

Параметры конфигурации модуля: 

abills/libexec/config.pl 

$conf{SMS_FENIX_URL}

URL  шлюза: http://10.128.1.50:7890

AMD

Страна: Универсальный

Скопировать модуль

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

Параметры конфигурации модуля: 

abills/libexec/config.pl 

$conf{SMS_AMD_URL}

URL шлюза: https://connect.routee.net/sms

LSIM

(lsim.az)

Страна: Азербайджан

Установка:

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

Параметры конфигурации модуля: 

abills/libexec/config.pl 

$conf{SMS_LSIM_URL}

URL шлюза: http://sendsms.az/smxml/api

SmsClub

Image Removed

Страна: Любая страна

Скопировать модуль в:

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

Параметры конфигурации модуля: 

abills/libexec/config.pl 

$conf{SMS_SMSCLUB_URL}

URL  шлюза: https://im.smsclub.mobi

AlphaSms

Image Removed

Страна: Украина

Скопировать модуль в:

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

Параметры конфигурации модуля: 

abills/libexec/config.pl 

$conf{SMS_ALPHASMS_URL}

URL  шлюза: https://alphasms.ua

• • Eskiz sms
  • Omnicell
  • Likon Sms
  • MsgAm
  • Cablenet
  • WebSms
  • Fenix
  • AMD
  • LSIM
  • SmsClub
  • AlphaSms
  • SMPP
• Импорт Sms-систем с config.pl

Возможности

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

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

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

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

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

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

Установка

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

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

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

@MODULES = (
          'Sms'
          );

Sms Отчёты

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

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

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

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

Image Added

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

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

/usr/abills/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;'; 

Шаблоны

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

Sms Callback

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

Подключение

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 под себя, зайдите в Настройка → Другое → шаблоны и найдите данный шаблон что бы отредактировать его

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

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

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

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

Персональная информация - %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 смс.

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

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

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