Интегриране на персонален SMS сървър с уебсайт
Персоналният SMS сървър предоставя HTTP интерфейс за взаимодействие с уебсайт или уеб приложение. Този интерфейс ви позволява както да уведомите уеб приложението за получаването на SMS съобщение, така и да изпратите SMS съобщение, инициирано от уеб приложението.
Интеграционни библиотеки
Изпращане на получен 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 Source) на всеки няколко секунди.
SMS източникът е XML файл, съдържащ описание на SMS съобщенията, които трябва да бъдат изпратени. Ето пример за източник на SMS:
Текстът на съобщението е съдържанието на тага, кодиран в UTF-8.
След като уеб страницата с източника на SMS е внедрена на сайта, е необходимо тя да се свърже с Персоналния SMS сървър. За да направите това, трябва да конфигурирате източника на SMS тип "URL" в раздела "Източници". Конфигурацията на източника на SMS съдържа URL адреса, интервала на повикване в секунди и флага за активност. Не настройвайте и интервала на повикванечесто, защото води до високо натоварване на уеб сървъра; оптималната стойност на интервала е 10-60 секунди.
Обработка на отчети
Персоналният SMS сървър може да изпраща отчети за изпращане и доставка до сайта. Необходимостта от отчет за изпращане е свързана с факта, че при голям брой изпратени съобщения, те са на опашка за изпращане и всъщност могат да бъдат изпратени известно време след извикване на източника на SMS.
По правило два параметъра са достатъчни в манипулатора на отчета: _CUSTOM_ и _STATUS_.
Параметърът _STATUS_ може да приема следните стойности: изпратено, неуспешно, доставено, недоставено. Първите две стойности се връщат от манипулатора на събитието "Изпращане", вторите две - от манипулатора на съобщения "Доставка".