PromoSMS - сервис рассылки смс, e-mail, прием входящих смс

SNPP-протокол

Инструкции по подключению

к SMS- шлюзу PromoSMS

SNPP - протокол

При использовании SNPP-протокола (Simple Network Paging Protocol) следует обратить внимание на следующие моменты:

  • Формат команд текстовый, каждая команда должна оканчиваться кодом перевода каретки и новой строки (\r\n - 13h10h)

  • На каждую команду сервисом возвращается ответ, например:
    на этапе подключения:
    220 hello
    220 you passed!

  • На каждую последующую команду:
    250 текст - положительный ответ системы
    550 текст - произошла ошибка

Команды для соединения с сервисом отправки SMS

Команда

Запрос

Ответ

1

Подключение

login имя_пользователя пароль

220 you passed

2

Отправка SMS

Sendsms number_from|numder_to text

250 код_сообщения_по_которому_можно_узнать_его_статус

(см. статусы SMS-сообщений)

3

Разрыв подключения

exit

250 good buy

Параметры подключения к sms – сервису

Пример отправки SMS-сообщения

С нашей стороны открывается соединение по адресу и порту, который будет указан в настройках.

Сервис отвечает: 220 hello

Вы: login <имя_пользователя> <пароль>
Сервис отвечает: 220 you passed!
либо рвет соединение в случае неверных имени_пользователя и/или пароля

Вы: sendsms number_from|number_to text
Сервис отвечает: 250 <Уникальный референс отправленного сообщения>
Вы: exit
Сервис: 250 good bye!

Статусы SMS-сообщений

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

Для проверки статуса отправленного сообщения вызывается команда:

gsmstat <Уникальный референс отправленного сообщения>

В ответ сервис выдает строку вида:

250 <код статуса> <дата доставки и краткая расшифровка статуса>\r\n

При запросе статуса командой gsmstat

Значение кода статуса

2

Доставлено до абонента.

7

Доставлено до абонента после его недоступности.

3

Не доставлено за установленное оператором время.

5

Не может быть доставлено, номер не существует.

8

Не может быть доставлено, номер в черных списках оператора.

-1

Не доставлено до абонента.

Любое SMS-сообщение достигает окончательного статуса не более чем, через 24 часа после отправки.

Формат номера телефона

Номер телефона абонента должен соответствовать рекомендации E.164 от ITU-T, определяющей общий международный телекоммуникационный план нумерации. Номера по E.164 могут иметь максимум 15 цифр и обычно записываются с префиксом «+». При отправке SMS-сообщений префикс можно «+» можно не указывать, сразу указывая код страны.

7

916

1112233

Код страны

Код оператора

Номер телефона

Например, 79161112233 (здесь 7 – код России и Казахстана, 916 – код оператора, 1112233 – номер телефона). В том случае, если у абонента прямой городской номер, телефон абонента пишется также в международном формате, с указанием кода города. Например, для прямых Московских номеров: 70951112233. Исключение составляют абоненты Билайн Москва (и только они). Все телефоны абонентов Билайн передаются как 7903xxxxxxx (даже, если телефон прямой московский).

Пример сотового номера Армении:

374

9

1112233

Код страны

Код оператора

Номер телефона

Пример сотового номера Израиля:

972

54

1112233

Код страны

Код оператора

Номер телефона