Інтеграція Персонального 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).
Джерело SMS - це XML-файл, що містить опис SMS-повідомлень, які потрібно надіслати. Ось приклад джерела SMS:
Текст повідомлення - це вміст тега в кодуванні UTF-8.
Після того, як веб-сторінка із джерелом SMS реалізована на сайті, необхідно підключити її до Персонального SMS Сервера. Для цього потрібно налаштувати джерело SMS типу "URL" у вкладці "Джерела". Конфігурація джерела SMS містить URL, інтервал виклику в секундах та прапор активності. Не слід ставити інтервал виклику занадточасто, оскільки це призводить до високого навантаження на веб-сервер; оптимальне значення інтервалу – 10-60 секунд.
Обробка звітів
Персональний SMS Сервер може надсилати на сайт звіти про відправлення та доставку. Необхідність звіту про відправлення пов'язана з тим, що при великій кількості повідомлень, що відправляються, вони ставляться в чергу на відправку, і фактично можуть відправитися через деякий час після виклику джерела SMS.
Як правило, в обробнику звіту достатньо двох параметрів: _CUSTOM_ та _STATUS_.
Параметр _STATUS_ може приймати такі значення: sent, failed, delivered, undelivered. Перші два значення повертає обробник події "Надсилання", другі два - обробник повідомлення "Доставка".