Перейти к содержимому
Интеграция SMPP v3.4

Один шлюз для Windows, две роли SMPP: клиент и сервер

SMPP v3.4 работает в обе стороны. Подключитесь к SMSC или агрегатору как клиент либо запустите встроенный сервер, чтобы CRM, ERP и системы мониторинга отправляли сообщения через ваши SIM. Обе роли входят в редакцию Ultimate.

SMPP v3.4Редакция UltimateКлиент и серверЛокальный слушатель

Две роли, одна служба

Обе роли говорят на SMPP v3.4. Разница в том, кто открывает сеанс и что дальше несёт сообщение.

Сравнение SMPP-клиента и сервера
SMPP-клиентSMPP-сервер
Кто подключаетсяSMS Deliverer подключается к SMSC, агрегатору или другому SMPP-серверуCRM, ERP, мониторинг или любой SMPP-клиент подключается к SMS Deliverer
Путь сообщенияВаша исходящая очередь, через сеанс, к SMSC и маршрутам провайдераСеанс клиента, в исходящую очередь, наружу через пул модемов или телефоны Android
Оборудование на местеНе требуется; радиочасть принадлежит провайдеруКак минимум один модем GSM/LTE или телефон Android с активной SIM
Типичная причинаУ вас уже есть SMPP-аккаунт и нужны одна очередь и один отчётВаши системы уже говорят по SMPP, а SIM должны оставаться под вашим контролем

SMPP — это интерфейс, а не маршрут. В режиме клиента сообщения идут по сети провайдера; в режиме сервера — через ваши SIM. Обе роли требуют редакции Ultimate.

Режим SMPP-клиента: отправка через чужой SMSC

Используйте его, когда у вас уже есть учётные данные SMPP от оператора, агрегатора или SMS-провайдера. Ни модем, ни телефон Android на ПК не нужны.

1

Откройте настройки SMPP-подключения

Создайте подключение SMPP в SMS Deliverer. В форме указываются адрес сервера, порт, имя пользователя и пароль, выданные провайдером. Сохраните кнопкой OK.

2

Дождитесь установления сеанса

После сохранения подключения программа держит сеанс SMPP v3.4 с этим сервером. Если провайдер фильтрует по IP, сначала сообщите ему публичный адрес ПК.

3

Поставьте сообщение в исходящую очередь

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

4

Прочитайте отчёт о доставке

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

Переключение канала

Пока существует SMPP-подключение клиента, программа по умолчанию отправляет через SMPP и перестаёт использовать подключённый модем или телефон. Параметр в настройках отключает это переключение, и оба канала остаются активными. Выбирайте осознанно; не позволяйте тестовому сеансу молча перехватить рабочую очередь модема.

Нет локального резерва

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

Детали настройки

Пошаговые скриншоты есть в онлайн-справке: настройка SMPP-клиента.

Режим SMPP-сервера: пусть ваши системы подключаются

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

1

Запустите сервер

Откройте раздел SMPP-сервера и нажмите Start server. Слушатель использует заданный вами порт; по умолчанию — 2775.

2

Откройте порт в брандмауэре

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

3

Создайте отдельную учётную запись для каждого клиента

Встроенная учётная запись — admin / admin. В User Management добавьте отдельные имя пользователя и пароль для каждого приложения, чтобы одного клиента можно было отключить, не трогая остальных.

4

Привяжите клиента к слушателю

В CRM, ERP или шлюзе укажите IP-адрес ПК, порт и учётные данные. Несколько клиентов и одновременных подключений могут быть привязаны сразу.

5

Отправьте и подтвердите

Каждое сообщение, отправленное клиентом, попадает в исходящую очередь и распределяется по подключённым портам GSM. Входящие SMS с этих модемов или телефонов передаются обратно подключённым SMPP-клиентам.

Отчёты о доставке возвращаются

После отправки сообщения программа возвращает отчёт о доставке SMPP-клиенту. Пример в справке содержит id сообщения, метки времени отправки и завершения, stat, err и IMSI SIM-карты в текстовом поле.

Нагрузка распределяется по портам

Трафик SMPP распределяется по нескольким портам GSM, а не закрепляется за одним модемом. Добавляйте модемы или телефоны, чтобы повысить ёмкость; слушатель при этом не меняется.

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

Пошаговая настройка по экранам и пример отчёта о доставке — в онлайн-справке: настройка SMPP-сервера.

Адресация: номер, TON и NPI

SMPP передаёт адрес и два флага типа. Именно ошибки в них обычно приводят к тому, что провайдер отклоняет submit, хотя сеанс установлен.

Типичные примеры адресов SMPP
АдресTONNPIПрименение
+791712345671 — International1 — ISDN (E.163/E.164)Мобильный номер в формате с кодом страны
555553 — Network specific0 — UnknownКороткий код
MyService5 — Alphanumeric0 — UnknownИмя отправителя, если оператор разрешает

TON принимает 0 unknown, 1 international, 2 national, 3 network specific, 4 subscriber number, 5 alphanumeric и 6 abbreviated. NPI охватывает ISDN, data, telex, land mobile, private и другие планы. Полные списки значений и исходные примеры — в SMPP Address.

Куда подходит каждая роль

Четыре ситуации из реальных интеграций. В каждой названа роль и часть продукта, которая выполняет работу.

Взаимодействие с агрегатором

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

CRM или ERP, которые уже говорят по SMPP

Режим сервера. Направьте приложение на ПК вместо переделки интеграции под HTTP. CRM сохраняет свой SMPP-клиент, а сообщения уходят через ваши SIM без платы за сообщение в облаке.

Внутренние оповещения с ответами

Режим сервера. Системы мониторинга отправляют оповещения по SMPP; ответы сотрудников приходят как входящие SMS и передаются обратно подключённому клиенту. Отчёты о доставке замыкают цикл по каждому сообщению.

Данные сообщений остаются на месте

Режим сервера. Слушатель, исходящая очередь и данные о доставке остаются в локальной сети. Модем или телефон — единственный путь к оператору, поэтому номера и текст сообщений не проходят через сторонний шлюз.

Сравниваете две модели доставки? Страница «локально против облака» охватывает стоимость, расположение данных и контроль. Для пути HTTP вместо SMPP см. раздел интеграции в инструкции по настройке.

Что SMPP не отменяет

Протокол меняет то, как сообщения попадают в шлюз. Он не меняет того, что примет оператор или SIM.

Границы возможностей SMPP
ГраницаЧто это значит на практике
РедакцияКлиент и сервер доступны только в Ultimate. В Standard и Enterprise обе роли отсутствуют.
Пропускная способностьЁмкость режима сервера — сумма подключённых модемов и их тарифов SIM. SMPP не добавляет маршруты и не повышает лимит скорости оператора.
Отчёты о доставкеСостояния и коды ошибок приходят от оператора. Отчёт с UNDELIV или REJECTD — ответ сети, а не сбой шлюза.
Идентичность отправителяБуквенные имена отправителя и короткие коды зависят от оператора и аккаунта. Шлюз может поместить их в PDU; сеть решает, принимать ли их.
Тип сообщенияSMPP передаёт SMS. Для MMS нужен канал телефона Android; см. настройку шлюза на Android.
Длинные сообщенияДлинный текст разбивается на сегменты и тарифицируется по частям, как на модеме. В таблице сегментации указано число символов.
Сетевая экспозицияСервер слушает TCP-порт. Привяжите его к локальной сети или VPN и ограничьте правило брандмауэра; не публикуйте его в интернете.

Вопросы покупателей

Входит ли SMPP во все редакции?

Нет. И клиент, и сервер входят в редакцию Ultimate. Standard и Enterprise работают с каналом модема и Android без ролей SMPP.

Можно ли использовать режим клиента без модема?

Да. В режиме клиента провайдер владеет SMSC и радиочастью, поэтому ПК не нужен ни модем, ни телефон. Плата за это — маршруты и тарифы провайдера.

Могут ли клиент и сервер работать на одном компьютере?

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

На каком порту слушает сервер?

По умолчанию 2775. Измените его в настройках сервера и разрешите тот же порт на вход в брандмауэре Windows для нужных клиентов.

Передаются ли отчёты о доставке обратно SMPP-клиенту?

Да. После отправки сообщения сервер возвращает отчёт о доставке с id сообщения, состоянием, метками времени и кодом ошибки. Текстовое поле содержит IMSI SIM-карты, с которой отправлено сообщение.

Обходит ли SMPP лимиты оператора?

Нет. Режим клиента ограничен аккаунтом провайдера; режим сервера — вашими тарифами SIM, числом модемов и лимитами скорости оператора. SMPP меняет только интерфейс.