Интеграция с SMS и SIP шлюзами ¶
Для отправки SMS, осуществления или приема звонка в DECK.AUTH предусмотренна интеграция со сторонними SMS и SIP шлюзами. В систему встроена интеграция, как с конкретными сервисами отправки SMS, так и универсальные методы интеграции.
Управление интеграциями с SMS и SIP шлюзами доступно в разделе основного меню: Настройки/Сервисы SMS и звонков.
Для добавления новой интеграции предназначена кнопка ДОБАВИТЬ ИНТЕГРАЦИЮ.
При выборе типа сервиса меняется перечень необходимых для конфигурации параметров.
Info: В систему может быть добавлено несколько интеграций с SMS и SIP шлюзами, что позваляет использовать разные сервисы для каждого captive-портала.
Note: При формировании текста сообщения используется шаблон, который настраивается при добавлении интеграции с SMS-сервисом.
Шаблон - это любой текст, с добавлением в нужное метосто тега %CODE%. Данный тег, перед отправкой SMS, будет заменен на случайное число, сгенерированное системой для проходжения процесса подтверждения номера сотового телефона.
Пример шаблона:
Код подтверждения: %CODE%Важно помнить, что чем короче текст перед кодом, тем удобнее клиенту его увидеть при получении SMS.
Билайн.Бизнес ¶
- Имя - имя добавляемого сервиса. Любой текст для удобства дальнейшего использования.
- Сервис - тип сервиса. Для интеграции с Билайн.Бизнес необходимо выбрать значение Билайн бизнес.
- Отправитель - номер телефона или имя отправителя, зарегистрированное в личном кабинете сервиса Билайн.Бизнес. SMS будут приходить от имени указанного отправителя.
- Логин - имя пользователя для доступа к сервису Билайн.Бизнес.
- Пароль - пароль для доступа к сервису Билайн.Бизнес.
- Текст - шаблон текста, который будет использоваться для формирования SMS.
После нажатия кнопки СОХРАНИТЬ, сервис будет добавлен в систему.
SMS.RU ¶
- Имя - имя добавляемого сервиса. Любой текст для удобства дальнейшего использования.
- Сервис - тип сервиса. Для интеграции с SMS.RU необходимо выбрать значение sms.ru.
- API ключ - уникальный ключ полученный при регистрации в SMS.RU.
- Логин - имя пользователя для доступа к сервису SMS.RU.
- Пароль - пароль для доступа к сервису SMS.RU.
- Текст - шаблон текста, который будет использоваться для формирования SMS.
После нажатия кнопки СОХРАНИТЬ, сервис будет добавлен в систему.
Сервис SMS.RU может быть использован и для получения звонка от абонента, для сценария подтверждения номера сотового телефона путем ожидания звонка от абонента.
Протокол SMPP ¶
Info: Подробнее о протоколе можно узнать в Википедии: https://ru.wikipedia.org/wiki/SMPP
- Имя - имя добавляемого сервиса. Любой текст для удобства дальнейшего использования.
- Сервис - тип сервиса. Для интеграции с шлюзом по протоколу SMPP необходимо выбрать значение SMPP.
- Хост - IP-адрес или имя хоста SMPP сервера.
- Порт - порт сервера для приема SMPP запросов.
- system-id - идентификатор клиента SMPP.
- password - пароль клиента SMPP.
- source-addr - источник отправки сообщения.
- addr-ton - тип номера получателя.
- addr-npi - идентификатор плана нумерации получателя.
- interface-version - версия SMPP интерфейса.
- Текст - шаблон текста, который будет использоваться для формирования SMS.
После нажатия кнопки СОХРАНИТЬ, сервис будет добавлен в систему.
Протокол SMPP может быть использован и для получения SMS от абонентов, для сценария подтверждения номера сотового телефона путем ожидания SMS от абонента.
Универсальный метод. GET или POST запросы ¶
Данный способ интеграции позволяет взаимодействовать с большинством SMS-шлюзов, как облачных сервисов, так и с аппаратными решениями.
DECK.AUTH позволяет сформировать GET или POST запрос, с необходимыми параметрами, для обращения к интерфейсу отправки сообщения. Для этого используется шаблон URL запроса.
Для формирования шаблона URL необходимо использовать специальные теги:
- %CODE% - данный тег, перед отправкой SMS, будет заменен на случайное число, сгенерированное системой для проходжения процесса подтверждения номера сотового телефона.
- %PHONE% - данный тег будет заменен на номер сотового телефона, на который необходимо отправить сообщение.
Пример URL: https://sms.ru/sms/send?api_id=xxxx-xxxx-xxxx-xxxx-xxxx&to=%PHONE%&msg=Free%20WiFi%20code:%20%CODE%&json=1
Info: При использовании POST запроса, шаблон формируется в формате GET, но перед отправкой запроса параметры запроса будут преобразованы в формат POST.
- Имя - имя добавляемого сервиса. Любой текст для удобства дальнейшего использования.
- Сервис - тип сервиса. Для интеграции с шлюзом c помошью HTTP необходимо выбрать значение GET запрос или POST запрос.
- URL запроса - шаблон URL.
Протокол SIP ¶
Info: Подробнее о протоколе можно узнать в Википедии: https://ru.wikipedia.org/wiki/Session_Initiation_Protocol
- Имя - имя добавляемого сервиса. Любой текст для удобства дальнейшего использования.
- Сервис - тип сервиса. Для интеграции с шлюзом по протоколу SIP необходимо выбрать значение SIP.
- IP-адрес шлюза - IP-адрес SIP шлюза.
- Порт шлюза - порт SIP шлюза.
- Исходящий IP-адрес - IP-адрес, который будет использоваться в заголовках SIP запросов.
- Исходящий порт - порт, который будет использоваться в заголовках SIP запросов.
- Исходящие номера - номера, перечисленные через запятую, от имени которых будет осуществлятся вызов.
- Префикс - префикс, который будет добавлен перед номеров вызываемого абонента.
- Заменять +7 на 8 - опция включения/выключения режима замены в номерах абонентов +7 на 8.
После нажатия кнопки СОХРАНИТЬ, сервис будет добавлен в систему.
Протокол SIP может быть использован для осуществления звока абоненту или приема звонков от абонентов, для сценария подтверждения номера сотового телефона абонента.
МТС-Коммуникатор ¶
Для интеграции с сервисом отправки SMS, предоставляемым оператором МТС, предлагается использовать GET запрос.
Шаблон GET запроса будет следующим:
http://www.mcommunicator.ru/m2m/m2m_api.asmx/SendMessage?msid=%PHONE%&message=Code:%CODE%&naming=71234567890&login=71234567890&password=password
Подробную информацию о методах API МТС-Коммуникатора, можно узнать в документации, которую можно получить после регистрации в сервисе.
SMS Центр ¶
Для интеграции с сервисом отправки SMS, предоставляемым компанией «СМС-центр», предлагается использовать GET запрос.
Шаблон GET запроса будет следующим:
https://smsc.ru/sys/send.php?login=<login>&psw=<password>&phones=%PHONE%&mes=Code:%CODE%
Подробную информацию о методах API данного сервиса можн узнать по ссылке: https://smsc.ru/api/.
Аппаратный GSM шлюз GoIP ¶
Info: Подробнее об устройстве можно узнать по ссылке: http://cyclowiki.org/wiki/GoIP
Для инеграции с шлюзом GoIP предлагается использование протокола SMPP.
Конфигурация GoIP ¶
На устройстве необходимо включить сервис SMPP. Для этого необходимо пройти по меню: Configurations/Preferences.
SMPP SMSC - установить в Enable.
ID - указать произвольное имя.
Password - указать произвольный пароль.
Port - указать порт, на котором поднимется сервер SMPP.
В меню Configurations/Network необходимо внести параметры подключения к локальной сети.
На этом настройка GoIP окончена.
Конфигурация DECK.AUTH ¶
На следующем изображении представлен пример конфигурации сервиса отправки SMS по протоколу SMPP для взимодействия с GoIP.
- Имя - имя добавляемого сервиса. Любой текст для удобства дальнейшего использования.
- Сервис - тип сервиса. Для интеграции с шлюзом по протоколу SMPP, выбираем значение SMPP.
- Хост - указываем IP-адрес GoIP шлюза.
- Порт - указываем порт, который ранее указали при настройке GoIP.
- system-id - идентификатор клиента SMPP, это значение, которое мы указали в поле ID в конфигурации GoIP.
- password - пароль клиента SMPP, это значение, которое мы указали в поле Password в конфигурации GoIP.
- source-addr - источник отправки сообщения, в данном случае указываем номер телефона который привязан к вставленной в шлюз SIM карте.
- addr-ton - тип номера получателя, отсавляем 1.
- addr-npi - идентификатор плана нумерации получателя, оставляем 1.
- interface-version - версия SMPP интерфейса, указываем 34.
- Текст - шаблон текста, который будет использоваться для формирования SMS.
Info: Шлюзы GoIP могут быть многоканальными. Для этого в них можно вставить несколько SIM карт. В этом случае поле source-addr можно оставить пустым. Тогда SMS будет отправлятся с той SIM карты, которая на данный момент свободна.
Если необходимо отправлять SMS с конкретной SIM карты, то поле system-id можно заполнить по следующему принципу:
system_id + 0 + номер канала. Т.о. для отправки SMS с первого канала, необходимо указать в качестве system-id значениеdeck01.
Редактирование сервиса. Журнал. Отправка тестового сообщения ¶
При клике по записи в списке ранннее созданных сервисов, можно попасть в интерфейс редактирования сервиса.
Для редактирования параметров сервиса предназначена кнопка РЕДАКТИРОВАТЬ.
Для удаления сервиса предназначена кнопка УДАЛИТЬ.
В данном интерфейсе доступна возможность отправки тестового сообщения. Для этого
необходимо указать номер телефона и нажать кнопку ОТПРАВИТЬ ТЕСТОВОЕ СООБЩЕНИЕ.
Система ведет журнал отправки сообщений для каждого сервиса. Журнал доступен по
кнопке ЖУРНАЛ.
В журнале фиксируется: время отправки, адресат сообщения, текст сообщения, код ответа сервиса и содержимое ответа.