SMPP-сервер, подключение по протоколу SMPP. Отправка смс по протоколу smpp, api для разработчиков

26.04.2019

Отправка СМС через smpp, smpp-шлюз

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

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

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

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

ТРЕБУЕТСЯ КАЧЕСТВЕННЫЙ SMPP-ШЛЮЗ? Свяжитесь с нами и мы предоставим тестовый доступ!

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

Для работы с протоколом SMPP необходимо иметь соответствующее ПО (SMPP-клиент, версии 3.4). При этом оборудование должно быть постоянно подсоединено к шлюзу компании "СМС-Агент". Для того чтобы отправка SMS через SMPP осуществлялась быстро и без задержек, все клиенты нашей фирмы проходят тест на совместимость оборудования. Это позволяет избавиться от многих технических сложностей еще на начальном этапе.

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

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

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

System_id - зарегистрированное в системе имя пользователя
password - пароль пользователя
Адрес - smpp.сайт
Порт - 2775
Для шифрованного SSL-подключения используется порт 3443

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

Параметры отправки сообщения (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) Ошибка транспорта. При возникновении этой ошибки обратитесь в службу поддержки
0x0433 (1075) Недостаточно средств на счете

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)

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

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

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

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

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

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

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

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

Поддержки.

Недостаточно средств на счете.

Ключевые особенности:

4752 руб


Microsoft Office Для дома и учебы 2016 для Windows

Microsoft Office Для дома и учебы 2016 - это основные приложения для дома и учебы с возможностью установки на 1 ПК. Включает в себя приложения Word, Excel, PowerPoint и OneNote.

Ключевые особенности:
Все пользователи OneDrive бесплатно

5990 руб


ABBYY FotoTranslate (многоязычная версия)

ABBYY FotoTranslate - это инновационное приложение для мобильных устройств, которое позволяет сфотографировать слово или фразу с помощью камеры мобильного устройства и получить мгновенный перевод. Теперь для перевода достаточно всего одного действия:

699 руб


Я познаю окружающий мир: Морские обитатели

Оказывается, русалки и гоблины действительно существуют, рыбы хрюкают, а акулы могут утонуть! Ребят ждут фантастические открытия и невероятные приключения в царстве Посейдона, незабываемые морские погружения и знакомство с загадочными обитателями

195 руб


История игрушек на Диком Западе

Любимые игрушки снова в седле! Вас ждут сразу три замечательные аркады по мотивам шедевров анимации от студии Disney/Pixar. Совершите увлекательное путешествие на Дикий Запад в компании озорной Джесси и отважного ковбоя Вуди. Сможете ли вы управиться с

149 руб


Лунтик. Русский язык для малышей

Проект серии «Лунтик. Подготовка к школе», в которую вошли пять обучающих игр для детей в возрасте 5-7 лет - дошкольников и первоклассников.

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

Особенности игры:
Десять обучающих мини-игр для дошколят и первоклассников в помощь родителям и учителям.
Веселые истории о Лунтике и его друзьях - задания, которые можно решать и без помощи взрослых.
Игровая серия создана в тесном сотрудничестве с авторами мультипликационного сериала о приключениях Лунтика и его друзей - кинокомпанией СТВ и студией «Мельница».

108 руб


Я учусь решать задачи

218 руб


1С: Образовательная коллекция. Умные игры. Развитие логики и воображения

Серия "Умные игры" включает комплекты развивающих и обучающих игр с простым, интуитивно понятным ребенку интерфейсом. Сборники рассчитаны на детей 4-8 лет и содержат доступные им игры всех направлений, направленные на расширение кругозора, тренировку памяти, логики, внимания, а также на освоение основ работы с компьютером. Наборы из этой серии можно использовать как для занятий с малышами, проявляющими ярко выраженные способности к обучению, так и для подготовки тех детей более старших возрастов, у которых задерживается формирование некоторых характерных для их лет навыков. В числе авторов и разработчиков игр - опытные педагоги по дошкольному обучению и практикующие детские психологи.

218 руб


1С: Познавательная коллекция. Юный мультипликатор

Программа "Юный мультипликатор" познакомит ребят с технологией Flash и научит их выпускать анимационные ролики собственного производства. Хотите верьте, хотите проверьте, но многие современные детские мультфильмы созданы при помощи именно этой программы. Для ее освоения не нужно знакомиться с вычислительной математикой, разбираться в устройстве компьютера и постигать языки программирования: ваш ребенок, не зная даже азов информатики, с легкостью создаст настоящий мультфильм - на радость себе и своим родителям.

196 руб


Microsoft Office 365 Бизнес Премиум

Создайте работу мечты с Office 365 Бизнес Премиум!
Office 365 Бизнес Премиум – решение для малого бизнеса. Продукт подходит для компаний, которым нужны приложения Office, корпоративная электронная почта и другие бизнес-службы. Office 365 Бизнес Премиум cоздан для того, чтобы сделать работу в команде идеальной. Это подписка на 12 месяцев, в состав которой входит расширенный набор приложений Microsoft Office для всех устройств, а также бизнес-службы: Exchange, Skype для бизнеса, Teams. Помимо этого вам будут доступны новые приложения для малого бизнеса: Bookings и Outlook Customer Manager, которые сделают вашу работу еще удобнее и проще, а бизнес успешнее. Вместе с подпиской вы получаете бесплатный домен на 1 год. Раскройте потенциал команды и вдохновите коллег с помощью новых возможностей Office 365 Бизнес Премиум.

Подписка на 12 месяцев
Один пользователь
Одна лицензия предоставляет пользователю возможность установить полнофункциональные приложения Office на 5 компьютеров Windows или Mac, пять телефонов и пять планшетов
Полные и самые актуальные версии Word, Excel, PowerPoint, Outlook, OneNote, Publisher(только ПК), Access (только ПК)
Бизнес-службы: Exchange Online с почтовым ящиком размером 50 ГБ и пользовательским адресом домена электронной почты, Skype для бизнеса, Microsoft Teams, SharePoint Online
Новые бизнес-приложения: Outlook Customer Manager, Microsoft Bookings
Эксклюзивные обновления каждый месяц
1 ТБ в облачном сервисе OneDrive
Бесплатный домен на 1 год
Техническая поддержка Майкрософт
Лицензия для коммерческого использования

13790 руб

(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 версии 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.