PromoSMS - сервис рассылки смс, e-mail, прием входящих смс
Инструкции по подключению
к SMS- шлюзу PromoSMS
При использовании 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-сообщения иногда может быть некорретным.
Для проверки статуса отправленного сообщения вызывается команда:
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 |
|
Код страны |
Код оператора |
Номер телефона |