СМС транспорт

Смс-транспорт подходит для организации таких сервисов, как голосования, оплата игровых денег, оплата объявлений на досках объявлений и так далее.

Возможны 2 варианта работы услуги:

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

Данный режим может использоваться тогда, когда генерация ответа не требуется и не зависит от поступающих SMS-сообщений. Например, когда продается какой-либо архив с информацией, закрытый всегда одним и тем же паролем.



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

При активном режиме данные передаются по протоколам HTTP или HTTPS в виде POST-запроса.
Скрипт, работающий на сервере Партнера и принимающий данные с нашей платформы их обрабатывает и возвращает ответ, который отправляется Абоненту.

Передаваемые POST-запросом параметры:

• transaction_id – уникальный идентификатор сообщения
• time – время в формате UNIX (кол-во секунд с начала "эпохи UNIX")
• strtime – время в формате ГГГГ-ММ-ДД чч:мм:сс
• keyword – ключевое слово (префикс)
• provider – наименование оператора сотовой связи
• country_id – идентификатор страны Абонента
• short_number – короткий номер, на который был отправлен запрос Абонента
• phone – телефон Абонента. В целях соблюдения правил безопасности последние 4 цифры номера не передаются.
• text – текст SMS-сообщения БЕЗ префикса
• fulltext – полный текст SMS-сообщения
• cost_rur – сумма, перечисляемая Партнеру, в рублях
• cost_usd – сумма, перечисляемая Партнеру, в долларах по текущему курсу
• secret_key – секретный ключ, используется для проверки достоверности информации

После получения вышеуказанных данных скрипт Партнера должен их обработать и выдать ответ в течение 5-ти секунд с момента получения данных. Если ответ не поступил в отведенное время, либо поступил, но не соответствует формату, система отправляет Абоненту ответ по умолчанию, т.е. работает в пассивном режиме.

Формат ответа от скрипта-обработчика Партнера:
<text>ТЕКСТ ОТВЕТА</text>

Формат ответа может быть как обычный текст так и в виде HTML. При этом не требуется соблюдение каких-либо строгих правил, поэтому если в скрипте-обработчике возникнут какие-либо ошибки (NOTICE'ы, ошибки связи с базой данных и т.п.), но будет присутствовать строка ответа в вышеуказанном формате, ответ Абоненту будет корректно отправлен.

Пример скрипта для языка PHP:

<?php // Определение заголовка ответа, задание кодировки ответа. Допускается кодировка windows-1251, либо utf-8.
header('Content-Type: text/plain; charset=windows-1251');
// Загрузка данных в переменные
$transaction_id = $_POST["transaction_id"];
$time = $_POST["time"];
$strtime = $_POST["strtime"];
$keyword = $_POST["keyword"];
$provider = $_POST["provider"];
$country_id = $_POST["country_id"];
$short_number = $_POST["short_number"];
$phone = $_POST["phone"];
$text = $_POST["text"];
$fulltext = $_POST["fulltext"];
$cost_rur = $_POST["cost_rur"];
$cost_usd = $_POST["cost_usd"];
$secret_key = $_POST["secret_key"];

/* блок обработки данных */

// Отправка ответа echo "<text>ОТВЕТ</text>";
?>

Подключение услуги SMS-Транспорт

• После регистрации и входа в личный кабинет, перейти по ссылке в меню "SMS-транспорт"
• Нажать "Добавить сервис"
• Заполнить поле "Название" и выбрать первичный префикс из выпадающего списка (с него будет начинаться ваш префикс). Нажать кнопку "Сохранить"
В системе имеется ограничение на количество создаваемых префиксов для услуги, установленное Администрацией системы. Если количество не превысило допустимое значение, то автоматически будет сформирован префикс, состоящий из первичного и вторичного префиксов. Первичный префикс возможно выбрать самостоятельно из предоставленного списка, вторичный - создается генератором системы автоматически.

• После создания префикса, он появится в списке. Нажмите ссылку "Настроить" для выбора режима работы (пассивный или активный) и настройки прочих параметров
• Нажмите ссылку "Протестировать" для проверки работоспособности скрипта-обработчика. Ссылка доступна только для активного режима!

После получения правильного ответа от скрипта-обработчика услуга считается настроенной и полностью работоспособной.