Интеграция Персонального SMS Сервера с веб-сайтом

Персональный SMS Сервер предоставляет HTTP-интерфейс для взаимодействия с веб-сайтом или веб-приложением. Этот интерфейс позволяет как оповестить о получении SMS-сообщения на веб-приложение, так и отправить SMS-сообщение, инициированное веб-приложением.

Библиотеки для интеграции

Инструкция и библиотеки для интеграции с сайтом на PHP

Инструкция и библиотеки для интеграции с сайтом на ASP

Тестовая площадка для интеграции с сайтом

Передача полученных SMS на сайт

Для передачи полученных SMS-сообщений на сайт, нужно настроить обработчик SMS-сообщений типа "URL". Обработчик SMS-сообщений - это действие, которое необходимо выполнить при получении сообщения; в случае URL-обработчика - это отправка запроса (GET) на веб-сайт.

Обработчик входящих SMS-сообщений может включать параметры _FROM_ (номер отправителя) и _BODY_ (текст сообщения).

Пример обработчика:

http://www.headwind.ru/handler?phone=_FROM_&message=_BODY_

Скрипт на сайте, реализующий обработчик SMS-сообщений, должен возвращать HTTP 200 OK. Текст ответа неважен, можно возвращать пустую страницу.

Отправка SMS с сайта

В отличие от существующих SMS-шлюзов, Персональному SMS Серверу не требуется работа в режиме веб-сервера. Персональный SMS Сервер периодически опрашивает веб-сайт, не нужно ли отправить SMS-сообщения, вызывая раз в несколько секунд специальный скрипт (Источник SMS).

Источник SMS - это XML-файл, содержащий описание SMS-сообщений, которые требуется отправить. Вот пример источника SMS:

<messages> <message msisdn="79213498843" report="1" custom="15">Первое текстовое сообщение</message> <message msisdn="79213459134" report="1" custom="16">Второе текстовое сообщение</message> </messages>

Номер телефона передается в атрибуте msisdn, необходимость получения отчета о доставке - в атрибуте report (1 - получать отчет, 0 или отсутствие атрибута - не получать отчет). Атрибут custom может содержать любую информацию со стороны сервера, которая позволит идентифицировать сообщение при получении отчета об отправке и доставке; как правило, это идентификатор сообщения в таблице базы данных на сайте.

Текст сообщения - это содержимое тэга <message>, в кодировке UTF-8.

После того, как веб-страница с источником SMS реализована на сайте, необходимо подключить ее к Персональному SMS Серверу. Для этого требуется настроить источник SMS типа "URL" во вкладке "Источники". Конфигурация источника SMS содержит URL, интервал вызова в секундах, и флаг активности. Не следует ставить интервал вызова слишком частым, поскольку это приводит к высокой нагрузке на веб-сервер; оптимальное значение интервала - 10-60 секунд.

Обработка отчетов

Персональный SMS Сервер может отправлять на сайт отчеты об отправке и доставке. Необходимость отчета об отправке связана с тем, что при большом количестве отправляемых сообщений они ставятся в очередь на отправку, и фактически могут отправиться через некоторое время после вызова источника SMS.

Для отправки на сайт отчета, требуется настроить обработчик SMS на событие "Отправка" или, соответственно, "Доставка". Точно так же, как и обработчик входящих SMS, этот обработчик является по сути запросом веб-скрипта. Однако передаваемые в скрипт параметры - другие: _CUSTOM_ - пользовательский идентификатор, отправленный в источнике SMS, _STATUS_ - новый статус SMS-сообщения, _ID_ - внутренний идентификатор сообщения в Персональном SMS Сервере, _TO_ - адрес (номер телефона) получателя, _BODY_ - само сообщение.

Как правило, в обработчике отчета достаточно двух параметров: _CUSTOM_ и _STATUS_.

Параметр _STATUS_ может принимать следующие значения: sent, failed, delivered, undelivered. Первые два значения возвращает обработчик события "Отправка", вторые два - обработчик сообщения "Доставка".