При внедрении бизнес-процессов важно получать данные от внешних сервисов при наступлении того или иного события. Мы упростили процесс получения статусов при массовых рассылках по API — теперь нашим клиентам доступны Вебхуки (Webhooks). Расскажем подробнее, что это и как это работает.

Webhook — это HTTP-запрос, который передаёт информацию на указанный вами URL-адрес, если произошло целевое событие или действие. 
Таким образом, Webhooks позволяют приложениям или системам быть «в курсе» событий друг друга без постоянной отправки запросов. Это делает их эффективным помощником в интеграциях и автоматизации различных системам.

Шаги по созданию Вебхука:

1. Владелец сервера или приложения определяет URL-адрес, на который будут направляться данные от app.sms.by методом POST:

channel — канал отправки,

message_id — ID-сообщения

 status — статус доставки.

Этот URL-адрес указывается  в личном кабинете app.sms.by.

2. Когда на сервере происходит событие, Вебхук формирует HTTP-запрос и отправляет его на URL-адрес, определенный на первом шаге.
3. Получатель Вебхука (т.е. ваш скрипт) ожидает HTTP-запрос на указанном URL-адресе и при поступлении запроса обрабатывает полученные данные. Для этого вашим разработчикам необходимо написать код обработки указанных выше данных из POST-запроса.

Пример Вебхука от нашей системы: 

curl —location ‘https://your-domain.test/…’ \

—header ‘Content-Type: application/x-www-form-urlencoded’ \

—data-urlencode ‘channel=VIBER’ \

—data-urlencode ‘message_id=2892295’ \

—data-urlencode ‘status=SENT’

Советы по обеспечению безопасности: 

✅ Подтверждение подлинности запросов и проверка того, что только источники, которым доверяете, могут отправлять Вебхуки.

✅ Использование защищенного соединения для передачи данных между серверами с применением протокола HTTPS.

✅ Ведение журнала событий для мониторинга работы Вебхуков и реагирования на возможные проблемы.

Сегодня мы расскажем как сделать двухфакторную авторизацию (2FA) на Java

Пользователь находится на сайте / мобильном приложении и вы хотите, чтобы он подтвердил свой номер телефона при регистрации/авторизации, подтверждение операции оплаты и прочее. 

После нажатия на “получить смс” пользователь получит сообщение вида CODE20.
Где CODE20 — это строка от 1 до 16 символов, состоящая из букв, цифр или букв и цифр одновременно. 

Итак, пользователь нажал “получить смс”.
Вы отправляете запрос на SMS.BY — sendSmsWithCode()
Данный вызов API вернет вам код сообщения “CODE20” и этот же код будет отправлен пользователю.
Пользователь вводит код и вы проверяете, что код совпадает, и если все ОК — то пропускаете пользователя дальше.

Теперь подробнее с примерами кода

Для начала давайте распишем алгоритм: 

1. Создать объект класса SMS_BY 
2. Указать токен 
3. Настроить PasswordObject 
4. Получить ID PasswordObject
5. Вызвать метод sendSmsWithCode
6. Сравнить вводимый код от пользователя с тем, который вернут метод sendSmsWithCode

Качаем исходники отсюда

Двухфакторная авторизация работает следующим образом.

Вы настраиваете длину и конфигурацию пароля, после этого у вас будет ID.
Далее по этому ID вы отправляете смс и в ответ вам приходит код, который отправляется пользователю.
В нашей системе такая настройка реализуется через PasswordObject.
PasswordObject — это настройки, которые вы можете использовать в двухфактороной верификации.
Например вам надо, чтобы пароль состоял только из только букв или только цифр или и то и другое, с длиной пароля в 5 символов.

Создание таких настроек выглядит следующим образом:

Чтобы отправить смс с кодом нужно сделать вызов:

Из этого сообщения вам надо получить код, который будет вводить пользователь на форме двухфакторной авторизации:

Пример кода:     

SMS.BY делает все, чтобы разработчикам было удобно использовать API для интеграции с нашим сервисом.

Чтобы Вам было быстрее и проще сделать интеграцию, мы написали пример кода на Php, доступный на GitHub.
Кстати, в конце статьи Вас ждет видео с разбором отправки СМС на Php.

В данном репозитории содержится 4 файла

SMS_BY.php — это базовый класс, содержащий все методы по отправке смс, проверку статусов, отправку запроса и так далее.

CountSmsParts.php — класс для подсчета длины строки с учетом кодировок ascii / unicode.

Если вы ранее не сталкивались с отправкой смс, то в целом должны помнить что русский символ требует 2 байта в unicode, поэтому длина смс на русском — 70 символов, а на английском — 140.

Но, в тоже время, если у Вас более 2 смс в одном сообщении, то длина будет уже менее 70 символов (68 если точнее), так как для отправки смс требуется добавление системной информации.

Это стоит учитывать при отправке длинных смс, или стараться делать смс короче.
Transliterate.php — как уже можно догадаться, класс по транслитерации русского текста в латиницу.
examples.php — содержит примеры вызова функций по подсчету длины смс-сообщения, а также транслитерации русского текста в английский.
Функция транслитерации также учитывает регистр, поэтому Вам не придется делать дополнительный ucfirst.

Итак, разберем основные моменты в examples.php

В самом верху идет подключение классов.

После того, как Вы вставите свой токен и номер телефона, Вы сможете отправить себе тестовое сообщение (проверьте, что у вас включен CURL).

Код в example.php состоит из блоков if(false).

Вы можете выбрать какой именно метод вы хотите протестировать и поставить там if (true).

Например, отправка смс:

Меняем в блоке выше if(false) на if(true) вызываем и на указанный вами телефон будет доставлена смс.

Пример запуска из командной строки:

Как вы видите в конце выводится сообщение об ошибке.

Это происходит, потому что у отправителя пока что нет одобренных Альфаимен (имен отправителя). Заявку на Альфаимя вы можете сделать в кабинете по ссылке: https://app.sms.by/alphanames

Смс, полученное на телефон:

Видео, в котором подробно описана отправка СМС на php можно посмотреть здесь.