SMPP-сервер, подключение по протоколу SMPP. Краткое описание протокола SMPP

Одним из смс протоколов является smpp. Он описывает процесс взаимодействия получателя сообщения, то есть smpp клиента с смс сервером, используя при этом особую систему передачи данных.

Взяв за основу отсылки сообщений smpp, вы получите возможность:

  • использовать различные текстовые форматы, а также wap push смс;
  • отсылать не только короткие, но и длинные тексты;
  • получать подробные отчеты о доставленных и отложенных смс;
  • обмениваться сообщениями в двустороннем формате;
  • выбирать скорость отправки.

Таким образом, протокол smpp обладает большими возможностями, которые, однако, сопряжены и с некоторыми особенностями использования и установки, которые мы и рассмотрим.

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

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

Кроме того, перед использованием протокола для проведения рассылок, пользователи могут провести тестовую отсылку smpp sms, чтобы определиться с желаемой скоростью доставки.

Специалисты всегда готовы предоставить консультацию по вопросам использования, подключения и тестирования сервиса, что упростит вашу задачу.

Подключение по SMPP протоколу.

  • system_id - зарегистрированное в системе имя пользователя вида XXXX.X
  • password - пароль пользователя
  • Адрес -
  • Порт - 8056

Поддерживаемые команды по протоколу SMPP

На не поддерживаемые команды сервер будет отвечать GENERIC_NAK сообщением с кодом ошибки ESME_RINVCMDID.

Параметры отправки сообщения (SUBMIT_SM) по протоколу smpp

Правила работы с SMPP подключением

При установке подключения клиенту дается 10 секунд, что бы отправить команду BIND_TRANSMITTER или BIND_TRANSCEIVER. Иначе соединение будет разорвано сервером.

Клиент обязан отвечать на все пакеты отправленные сервером соответствующим resp пакетом в течение 1 минуты. Иначе соединение будет разорвано сервером без отсылки UNBIND.

Получение статуса доставки сообщения

Есть две возможности получения статуса доставки по протоколу smpp (активный и пассивный). Пассивный вариант является предпочтительным.

Пассивный вариант предусматривает установку флага registered_delivery пакета SUBMIT_SM.
После перехода сообщения в финальное состояние сервер отправит DELIVER_SM пакет с Delivery Receipt сообщением. Формат Delivery Receipt сообщения ниже.

Активный вариант предусматривает периодический опрос статуса сообщения отсылкой
QUERY_SM.

Формат Delivery Receipt

"id:IIIIIIIIII sub:SSS dlvrd:DDD submit date:YYMMDDhhmm done date:YYMMDDhhmm
stat:DDDDDDD err:E Text: . . . . . . . . ."

Зарезервированные коды ошибок при smpp соединении

Код Описание
0x0400
(1024)
Кодировка не распознана
0x0401
(1025) 		Слишком большой текст сообщения. Максимальная длина не должна превышать 160
байт.
0x0402
(1026) 		Ошибка регистрации сообщения на отправку. При возникновении этой ошибки
обратитесь в службу поддержки.
0x0403
(1027) 		Не прошла проверка текста сообщения на наличие недопустимых слов и/или фраз
0x0404
(1028) 		Отправитель или получатель в черном списке
0x0453
(1107) 		Сработало ограничение по отправке одинакового текста на один и тот же номер в течение небольшого промежутка времени. Обратитесь в поддержку, если хотите отключить или уменьшить период.
0x043C
(1084) 		Нет доступного тарифа для запрашиваемого направления.
0x043F
(1087) 		Нет подходящего тарифа у вышестоящего контрагента.
0x045A
(1114) 		Политика маршрутизации не найдена.
0x0446
(1094) 		Ошибка транспорта. При возникновении этой ошибки обратитесь в службу
поддержки.
0x433
(1075) 		Недостаточно средств на счете.

(Short Message Peer to Peer - короткое сообщение равноправных узлов) – открытый протокол, который используется для отправки/получения смс-сообщений между равноправными субъектами. Данный протокол используется, как и HTTP, поверх TCP/IP, но является бинарным. Как правило, SMPP протокол обеспечивает режим постоянного подключения, без совершения запросов и ожидания ответов от сервера с дальнейшим разрывом соединения. Использование постоянного подключения увеличивает в разы скорость отправки сообщений.

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

SMPP способен передавать любой тип сообщения, включая такие как UCP/EMI. SMPP поддерживает как длинные текстовые сообщения, так и сообщения, написанные в Unicode. Некоторые SMPP-сервера требуют от отправителя цельное длинное сообщение, а другие - чтобы выполнялось сегментирование сообщения, основанное на типе сообщения.

Существуют три различных типа соединений, которые могут быть поддержаны SMPP сервером.

  • «Отправитель» или «отправить только» - работает только передача сообщения и сервер не может получать никаких сообщений.
  • «Получатель», или «только прием» - подключение через соединение для передачи сообщений не допускается, сервер может только принимать сообщения. Любая попытка получать сообщения через это соединение, как правило, приводит к ошибке.
  • «Трансивер» - разрешено отправлять и передавать сообщения через одно соединение.

Тип подключения, который вы используете, будет зависеть от предпочтений и политики ваших SMPP услуг.

Протокол SMPP является расширяемым, что позволяет провайдерам добавлять свои собственные дополнительные параметры, которые известны как TLV параметры, названные так из-за формата этих параметров: тег (метка), длина, стоимость. Некоторые TLV параметры, определены в спецификации, но не являются обязательными в использовании. Другие параметры предоставляются провайдером.

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

Передача сообщений между SMS-сервером и SMS Центром провайдера GSM службы по IP связи может быть через выделенную линию (шлюз) через Интернет. При этом IP-соединение между ПК и SMS Центром может быть защищено.

Преимущество SMPP протокола состоит в том, что процесс происходит намного быстрее и с меньшим интервалом (от одной до десяти секунд), чем при использовании мобильного телефона. SMPP рекомендуется применять, если максимальное количество отправляемых сообщений более чем 100 смс/час. Также, SMPP-сервис позволяет вписывать любую информацию (11 знаков) в строку номера отправителя. Поддерживаются цифры, символы латинского алфавита, знаки препинания пробел. Введенная информация будет фигурировать у получателя в строке «Сообщение от:» и может быть самостоятельно сменена отправителем. Таким образом, у вас есть возможность использовать свой SMS-центр, работающий по протоколу SMPP.

Аббревиатура SMPP расшифровывается как Short message peer-to-peer protocol (протокол соединения равноправных узлов для передачи коротких сообщений), протокол используется для передачи SMS, USSD и других типов сообщений, как правило, в системах VAS. В конце статьи приведен список терминов используемых в тексте.

SMPP был разработан компанией Aldiscon из Ирландии , перекупленной потом компанией Logica . В 1999 SMPP перешёл под управление SMPP Developers Forum, переименованный позднее в SMSForum . Протокол базируется на обмене PDU (protocol data units) передаваемой на уровне сетевой модели 4 OSI . Обмен пакетами может происходить как синхронно (после отправки запроса дальнейший обмен пакетами приостанавливается до получения ответа), так и асинхронно (запросы отправляются без задержек, обработка ответов происходит по мере их поступления). До недавнего времени последней опубликованной спецификацией была SMPP 3.4, а спецификация SMPP 5.0 долгое время являлась собственностью Logica , но в настоящее время также доступна. Обычно этот протокол используется в режиме постоянного подключения, что позволяет значительно повысить скорость передачи, т.к. не требуется каждый раз устанавливать соединение. Инициировать соединение может как пользователь, называемый в описании протокола External Short Message Entity (ESME), так и SMS-центр (SMSC).

Есть несколько режимов подключения:

Режим «Transmitter» (передатчик) – режим только для отправки сообщений на SMSC и получения соответствующих ответов, без приема входящих сообщений (DELIVER_SM пакетов);

Режим «Receiver » (приемник) – в это режиме все наоборот, только прием входящих сообщений и возвращение соответствующих ответов от SMPP клиентана SMSC , отправка коротких сообщений через этот режим не происходит (SUBMIT _SM пакетов);

Режим «Transceiver» - режим для передачи и приема сообщений, процесс может реализовываться синхронно и асинхронно.

Все данные в протоколе SMPP как говорилось ранее, вложены в блоках, называемых Protocol Data Units, который состоит из заголовка и тела.

Заголовок PDU пакета содержит в себе следующие поля:

command_length - указывает общее число октетов, содержащихся в этом пакете, включая поле длины.

command _ id – идентификатор команды (например submit _ sm , query _ sm и т.д.). И дентификатор команды ответа идентичен соответствующему идентификатору команды запроса, но с установленным 31 битом.

command _ status - указывает успех или неудачу запроса. Данное поле является значимым только в сообщении ответа и должно быть установлено в NULL в сообщениях запроса.

sequence _ number – в данном поле содержится номер последовательности, который позволяет запросам и ответам ассоциироваться в целях корреляции. Использование номеровпоследовательности позволяет, чтобы пакеты SMPP обменивались асинхронно.

Тело PDU является опционным и может быть не включенным в каждый PDU пакет. Структура тела описана в спецификации протокола отдельно, в зависимости от типа PDU.

Так же в PDU пакете могут присутствовать опциональные параметры имеющие общий формат TLV (Tag , Length ,Value).Данные параметры обеспечивают механизм для будущего ввода новых параметров, как и когда определяется в будущих версиях протокола SMPP. Опционные параметры являются полями, которые могут быть включены в сообщение SMPP произвольно, они могут быть включены в любом удобном порядке в пределах раздела «Optional Parameters» передаваемого PDU и их не обязательно надо кодировать в порядке, представленном в спецификации протокола.

Tag – идентификатор данного конкретного опционного параметра;

Length - указывает длину поля Value в октетах (эта длина не включает длину полей Tag и Lengt) . Поле опционного параметра Length всегда будет длиной в 2 октета;

Value – это поле содержит фактические данные для данного опционного параметра.

Области применения коротких сообщений в современном мире велики, протокол SMPP идеально подходит для быстрой передачи большого количества сообщений, например для компаний, у которых большая база клиентов или для проведения SMS голосований в реальном времени, где идет большой поток входящих и исходящих данных.

Более подробное описание протокола вы сможете найти в спецификации на русском языке тут: SMPP_v3.4_rus.pdf

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

SM (Short Message ) – короткое сообщение;

SMS (Short Message Service) - Служба коротких сообщений, осуществляет передачу SM между клиентами мобильных сетей, а также внешними клиентскими приложениями;

USSD (Unstructured Supplementary Service Data)- стандартный сервис в сетях GSM, позволяющий организовать интерактивное взаимодействие между абонентом сети и сервисным приложением в режиме передачи коротких сообщений;

MMS (Multimedia Messaging Service ) — это система передачи мультимедийных сообщений (изображений, мелодий, видео) в сетях сотовой связи .

SMSC (Short Message Service Center ) - Центр обслуживания коротких сообщений - основа функционирования SMS;

VAS (Value Added Services ) — услуги, приносящие дополнительный доход;

ESME (External Short Message Entity ) - Внешнее клиентское приложение, реализующее SMPP-протокол, принимающее или посылающее короткие сообщения;

HLR (Home location register) - Постоянная база данных абонентов, подключенных к мобильной сети. HLR предоставляет SMS маршрут передачи SM адресату;

Октет - 8 бит . В русском языке октет обычно называют байтом .

Протокол обмена определяется спецификацией SMPP версии 3.4.

Версия 1.0 предназначена только для отправки сообщений и получения статуса доставки.

Прием сообщений в данный момент не поддерживается.

Расшифровку ошибок можно найти в спецификации SMPP версии 3.4.

Для повышения уровня безопасности при работе с системой, вы можете предоставить список IP адресов с которых будет осуществляться подключение.

Параметры подключения

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

  • system_id - зарегистрированное в системе имя имя пользователя.
  • password - пароль SMS-пользователя
  • Адрес - sms.сайт
  • Порт - 9001

На неподдерживаемые команды сервер будет отвечать GENERIC_NAK сообщением с кодом ошибки ESME_RINVCMDID.

Параметры отправки сообщения (SUBMIT_SM)

Правила работы с SMPP подключением

При установке подключения клиенту дается 10 секунд, что бы отправить команду BIND_TRANSMITTER или BIND_TRANSCEIVER. Иначе соединение будет разорвано сервером.

Клиент обязан отвечать на все пакеты отправленные сервером соответствующим resp пакетом в течение 1 минуты. Иначе соединение будет разорвано сервером без отсылки UNBIND.

Получение статуса доставки сообщения

Есть две возможности получения статуса доставки (активный и пассивный). Пассивный вариант является предпочтительным.

Пассивный вариант предусматривает установки флага registered_delivery пакета SUBMIT_SM. После перехода сообщения в финальное состояние сервер отправит DELIVER_SM пакет с Delivery Receipt сообщением. Формат Delivery Receipt сообщения ниже.

Активный вариант предусматривает периодический опрос статуса сообщения отсылкой QUERY_SM.

SMPP - распространенный вид протокола, используемого для приема и передачи sms-сообщений и USSD-запросов. Особенность его является постоянность подключения, что дает одно очень важное преимущество - соединение не разрывается, а рассылка SMS производится с высокой скоростью (до нескольких раз выше, чем при других способах).

Итак, при использовании smpp протокола, вы получаете следующие возможности:

1. доступны различные форматы, в том числе wap push sms;

2. сообщения, отправленные по smpp могут быть не только короткого формата;

4. двухсторонний канал SMS;

5. регулировка скорости.

Как видите, протокол smpp дает большую свободу использования, но, как и у любого средства, здесь есть собственные уникальные особенности, связанные с с настройкой и непосредственно работой. Об этом и поговорим ниже.

Особенности работы с протоколом

Для функционирования smpp требуется сервер, который приспособлен для работы по данному протоколу, и специальное программное обеспечение (клиент). Кроме того, необходимо постоянное стабильное соединение со шлюзом провайдера. Поэтому, мы в обязательном порядке проводим тестирование оборудования, которым располагают наши клиенты - сервер должен быть совместим со скоростной рассылкой SMS. Таким образом, мы изначально упрощаем оказание качественных услуг.

Api подходят для сайтов, написанных на любом языка, в том числе, php.

Протестировать работу настроенного smpp канала могут и сами клиенты, для этого предоставляются все возможности еще до начала пользования услугами. Это позволяет понять, как быстро ваши сообщения, отправленные через протокол smpp, будут доставлены получателям.

Сотрудники сервиса с радостью помогут вам разобраться вам во всех тонкостях работы через протокол smpp, интеграцию при момощи php на ваш сайт, посодействуют в подключении и тестировании всех служб, ответят на любые вопросы.

Параметры для подключения

  • system_id - зарегистрированное в системе имя пользователя вида XXXX.X
  • password - пароль пользователя
  • Адрес -
  • Порт - 8056

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

Описание

BIND_TRANSMITTER

Подключиться как TRANSMITTER

BIND_TRANSCEIVER

Подключиться как TRANSCEIVER

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

Запросить статус сообщения

Отправка Delivery Receipt сервером

Проверка связи

Ошибочная команда

Отключение

В случае ввода некорректной команды, придет ответ вида GENERIC_NAK, в тексте которого будет код ошибки ESME_RINVCMDID.

Параметры отправки SMS сообщения (SUBMIT_SM)

Правила соединения

У клиента есть 10 секунд для установки соединения через шлюз smpp, в течение которых должна быть послана одна из команд: BIND_TRANSCEIVER, BIND_TRANSMITTER. В противном случае произойдет разрыв соединения.

Также, разрыв произойдет если клиент не ответит на любой пакет, который отправил сервер не позже чем за одну минуту установленным правилами пакетом resp. При подобном разрыве UNBIND не отправляется.

Единовременно допускается smpp соединение лишь от единственного имени пользователя. Все остальные соединения получат ошибку 0x00000005 ESME Already in Bound State. Однако если вам нужно осуществить не одно соединение в рамках вашего кабинета, то для каждого из этих соединений можно создать собственного пользователя.

В случае отсылки Submit_sm, отмеченного при этом флажком registered_delivery, отправка статуса СМС возможна лишь тому пользователю, который отправлял сообщение.

Статус доставки смс

При работе по данному протоколу статус доставки может быть пассивным (желательно) или активным.

Для получения пассивного отчета необходимо пакет SUBMIT_SM отправлять с предварительно включенным флажком registered_delivery.

Текст Delivery Receipt в пакете DELIVER_SM приходит от сервера когда смс переходит на финальный этап рассылки.

При активном отчете статус смс регулярно проверяется при помощи отправки QUERY_SM.

Формат Delivery Receipt

"id:IIIIIIIIII sub:SSS dlvrd:DDD submit date:YYMMDDhhmm done date:YYMMDDhhmm
stat:DDDDDDD err:E Text: . . . . . . . . ."

Зарезервированные коды ошибок

Описание

Кодировка не распознана

Слишком большой текст сообщения. Максимальная длина не должна превышать 160

0x0402 (1026)

Ошибка регистрации сообщения на отправку. При возникновении этой ошибки
обратитесь в службу поддержки.

Не прошла проверка текста сообщения на наличие недопустимых слов и/или фраз

Отправитель или получатель в черном списке

Сработало ограничение по отправке одинакового текста на один и тот же номер в течение небольшого промежутка времени. Обратитесь в поддержку, если хотите отключить или уменьшить период.

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

Нет подходящего тарифа у вышестоящего контрагента.

Политика маршрутизации не найдена.

Ошибка транспорта. При возникновении этой ошибки обратитесь в службу

Поддержки.

Недостаточно средств на счете.
Похожие статьи