Вход для клиентов: Логин Пароль Забыли пароль? Зарегистрироваться
Стоимость SMS
0,80 рубРоссия
2,70 рубУкраина
1,00 рубКазахстан
3,60 рубСША
3,60 рубВеликобритания
Подробнее о тарифах и скидках на СМС рассылки
Мы не практикуем спам сообщения!


Здесь находится аттестат нашего WM идентификатора 171491728649

Версия для печати

Описание SMPP API

Через наш SMS-шлюз возможно отправлять сообщения по протоколу SMPP версии 3.4.

Скачать спецификацию протокола SMPP, версия 3.4:

Подключение

Особенности работы

Отправка сообщения

Получение входящих сообщений

Проверка статуса сообщения


Подключение

Идентификатор (System Id): ваш идентификатор в системе - ID, пример: 1234.

Пароль: первые 8 символов ключа, пример: 5D01022D.

Значения этих параметров можно получить в пользовательском Web интерфейсе на странице Аккаунт → Настройки.

Аккаунт → Настройки

IP-адрес сервера: 188.40.17.30

Порт сервера: 3200


Особенности работы

Сервер позволяет установить только одно подключение для одного ID, это ограничение введено для корректной отдачи статусов. При повторном подключении ранее подключенное соединение с таким же идентификатором будет автоматически разорвано.


Отправка сообщения

Для отправки SMS-сообщения используйте команду SUBMIT_SM согласно спецификации протокола SMPP.

Поддерживаемые кодировки:

Команды SUBMIT_MULTI и DATA_SM не поддерживаются.

В качестве телефона отправителя может быть любая подпись или номер телефона, которые вы зарегистрировали через наш Web интерфейс. Обратите внимание, подпись должна пройти модерацию!


Получение входящих сообщений

Входящие сообщения приходят в PDU-команде DELIVER_SM.

Для получения сообщений необходимо подключаться к SMPP-серверу в режиме TRANSCEIVER или RECEIVER.


Проверка статуса сообщения

Получать статус доставки отправленного SMS-сообщения по SMPP-протоколу можно как в автоматическом режиме, получая от сервера ответную PDU-команду DELIVER_SM сразу после изменения статуса, так и по запросу отдельной командой QUERY_SM. Для автоматического получения статуса необходимо подключаться в режиме BIND_TRANSCEIVER или BIND_RECEIVER и при отправке SMS указать флаг запроса статуса (registered_delivery).

При автоматическом возврате статуса в команде DELIVER_SM передаются TLV-параметры receipted_message_id, message_state и network_error_code, а также передается текст статуса в следующем формате:

id:<id> sub:<submitted> dlvrd:<delivered> submit date:<submit_date> done date:<done_date> stat:<status> err:<error>

Описание параметров:

Параметр Описание
id Идентификатор сообщения.
submitted Количество SMS частей в отправленном сообщении.
delivered Количество доставленных SMS.
submit_date Дата отправки.
done_date Дата изменения статуса.
status Статус сообщения в виде строки, возможные значения: "DELIVRD", "EXPIRED", "DELETED", "UNDELIV", "ACCEPTD", "UNKNOWN", "REJECTD".
error Код ошибки, если сообщение не может быть доставлено.

Пример

id:32974923213829439 sub:001 dlvrd:001 submit date:1108204567 done date:1108202568 stat:DELIVRD err:000

Описание кодов ошибок:

Код Описание
-1 Unknown error.
1 The server encountered an unexpected condition.
2 Authorization failed.
3 The server does not support the function required.
4 The request is for something forbidden.
5 Routing is not allowed.
6 Some of parameters are invalid.
7 The timeout period elapsed prior to completion of the operation or the server is not responding.
8 Unable to decode, an unsupported encoding was used.
9 The requested object was not found.
10 Invalid message sender.
11 Invalid message receiver.