Интеграция Персонального 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:
Номер телефона передается в атрибуте 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. Первые два значения возвращает обработчик события "Отправка", вторые два - обработчик сообщения "Доставка".