• 228 направлений
  • Без KYC — всегда
  • Bitcoin, Monero, USDT и ещё 4 валюты

РазработчикамСредний2 минуты чтенияОбновлено 18 октября 2026

SMPP или HTTP API: что выбрать?

SMPP или HTTP API для SMS? Различия протоколов, расчёт пропускной способности, отчёты о доставке, повторы и редкие случаи, когда SMPP-сессия оправдана.

Что представляет собой каждый протокол

SMPP (Short Message Peer-to-Peer) — двоичный протокол поверх постоянного TCP-соединения. Клиент, в терминах спецификации ESME, устанавливает с сервером сессию (bind) в роли передатчика, приёмника или приёмопередатчика (transmitter, receiver или transceiver), отправляет сообщения в виде блоков данных протокола (submit_sm) и получает в сессии отчёты о доставке и входящие сообщения (deliver_sm). Сообщения поддержания связи (enquire_link) держат сессию открытой. Большинство внедрений использует версию 3.4. Протокол создавался для операторов и агрегаторов, обменивающихся тысячами сообщений в секунду, и по-прежнему остаётся оптовым протоколом между ними.

HTTP API переносит те же операции на веб-запросы: POST создаёт сообщение, GET возвращает его статус, вебхук передаёт отчёт о доставке. Каждый запрос самостоятелен, содержит собственный ключ и передаётся по HTTPS, поэтому его может использовать любой язык, любой сервер и любая бессерверная функция. Терминология собрана в статье глоссария о SMPP.

Сравнение

АспектSMPPHTTP API
СоединениеДолгоживущие сессии, поддержание связи, управление окном, логика переподключенияHTTPS-запросы без состояния; подойдёт любой клиент
АутентификацияSystem id и пароль при установке сессии, часто со списками разрешённых IP-адресов с обеих сторонBearer-ключ в каждом запросе, при необходимости ограниченный списком разрешённых IP-адресов
КодировкаВы сами задаёте кодировку данных, делите длинные тексты и формируете заголовки склейкиПлатформа определяет кодировку, делит текст и возвращает число сегментов и цену
Отчёты о доставкеСообщения в сессии receiver или transceiver в текстовом формате, который различается у разных провайдеровПодписанные события вебхука с вашим собственным идентификатором (reference)
ПовторыИдемпотентности нет: при потерянном ответе остаётся только гадатьКлюч идемпотентности возвращает исходный результат
Управление потокомРазмер окна плюс ошибки ограничения скорости от провайдераЗаголовки ограничения частоты и Retry-After при ответе 429
ЭксплуатацияСессии, которые вы сами поддерживаете, отслеживаете, переключаете при сбоях и вносите в списки разрешённыхВызовы откуда угодно, включая бессерверные функции

Арифметика сегментов одинакова в обоих случаях: 153 символа GSM-7 или 67 символов Unicode на часть, если сообщение разбито на части. Разница лишь в том, кто её выполняет; размеры объяснены в руководстве по кодировкам.

Расчёт пропускной способности

В SMPP потолок одной сессии примерно равен размеру окна, делённому на время приёма-передачи, и ограничен скоростью, которую разрешил провайдер. Допустим, окно равно 10, а время приёма-передачи — 50 мс: 10 ÷ 0,05 = не более 200 PDU в секунду. Сообщение из трёх частей, отправленное с заголовками склейки, — это три PDU submit_sm, поэтому та же сессия передаёт около 67 трёхчастных сообщений в секунду. Больше пропускной способности — значит больше сессий, и каждая сессия — это соединение, которое нужно поддерживать в рабочем состоянии.

По HTTP арифметика проще. Ограничение — 50 запросов в секунду на ключ, а пакет до 1000 сообщений считается одним запросом:

  • одиночные запросы: 50 сообщений в секунду, или 50 × 3600 = 180 000 в час;
  • пакеты: предел передачи — 50 × 1000 = 50 000 сообщений в секунду на ключ;
  • 300 000 напоминаний: 300 пакетных запросов, которые занимают 6 секунд на полной скорости (300 ÷ 50) или минуту при спокойных 5 запросах в секунду.

Задержка определяет необходимый уровень параллелизма, а не потолок. При времени приёма-передачи 200 мс клиент, который ждёт каждого ответа, выполняет 5 запросов в секунду; чтобы достичь 50, нужно около 10 одновременных запросов (50 × 0,2). Оба протокола управляют только передачей сообщений провайдеру: то, как быстро сообщения доходят до телефонов, зависит от сетей назначения, каким бы протоколом они ни были переданы провайдеру.

Отчёты о доставке

В SMPP отчёт запрашивается в поле registered_delivery каждой отправки и возвращается как deliver_sm в сессии receiver или transceiver. Его текст обычно следует формату-примеру из приложения к спецификации 3.4:

SMPP
id:IIIIIIIIII sub:001 dlvrd:001 submit date:YYMMDDhhmm done date:YYMMDDhhmm stat:DELIVRD err:000

Этот формат — пример, а не правило, и провайдеры реализуют его по-разному: идентификатор сообщения может быть шестнадцатеричным в ответе на отправку и десятичным в отчёте, значения err различаются от сети к сети, а отчёты, пришедшие, пока ваша сессия receiver не работает, ставятся в очередь, повторяются или отбрасываются по собственной политике провайдера. Сопоставление отчётов с сообщениями — это код, который пишете и поддерживаете вы.

По HTTP отчёт — это подписанное событие вебхука (message.sent, message.delivered или message.failed) со значением reference, которое вы указали в сообщении, а ошибка сопровождается понятной причиной и исходным кодом оператора. События, которые пропустила ваша конечная точка, доставляются повторно — 6 попыток в течение 24 часов, — а из панели их можно отправить повторно в течение 30 дней; обработчик описан в руководстве по вебхукам в рабочей среде. Ни один протокол не улучшает то, что возвращает сеть: большинство направлений дают подтверждения с телефона, некоторые — только подтверждение оператора связи, и там Отправлено — окончательный положительный статус.

Повторы и дубликаты

В SMPP нет идемпотентности. Если submit_sm завершается по тайм-ауту или сессия обрывается, когда в окне остаются PDU, невозможно понять, было ли сообщение принято: повторная отправка грозит дубликатом, отказ от неё — потерей. Запрос статуса не помогает, потому что query_sm требует идентификатор сообщения, который пришёл бы в потерянном ответе. Ошибки ограничения скорости, такие как ESME_RTHROTTLED, — простой случай: сообщение было отклонено, поэтому сделайте паузу и отправьте его снова.

По HTTP передавайте Idempotency-Key, построенный на основе вашей собственной записи, и используйте его при каждом повторе. Повтор с тем же ключом возвращает исходный результат вместо повторной отправки, поэтому тайм-аут обходится вам во второй запрос, но никогда — во второе сообщение.

Python
import time, requests

def send(base_url, api_key, message, idem_key):
    headers = {"Authorization": "Bearer " + api_key, "Idempotency-Key": idem_key}
    for attempt in range(5):
        try:
            r = requests.post(base_url + "/v1/messages", json=message,
                              headers=headers, timeout=10)
        except requests.RequestException:
            time.sleep(2 ** attempt)          # сетевая ошибка: тот же ключ, пробуем снова
            continue
        if r.status_code == 429:
            time.sleep(float(r.headers.get("Retry-After", "1")))
            continue
        if r.status_code >= 500:
            time.sleep(2 ** attempt)
            continue
        return r                              # 2xx или 4xx, который нужно исправить, а не повторять
    raise RuntimeError("unconfirmed: retry later with the same idem_key")

Для пакетов действует ещё одно правило. Некорректный пакет отклоняется целиком, но пакет с несколькими неверными элементами ставит корректные в очередь и возвращает остальные как отклонённые с указанием ошибки: исправьте и отправьте повторно только отклонённые элементы — новым запросом с новым ключом.

Когда оправдан SMPP

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

  • «SMPP доставляет лучше». Доставка зависит от маршрута от провайдера до оператора; протокол между вами и провайдером на неё не влияет.
  • «SMPP быстрее». Любой из протоколов добавляет миллисекунды; время, которое сообщение проводит в сетях операторов, обычно гораздо больше.
  • «SMPP дешевле». Если провайдер предлагает оба варианта, цена за сообщение обычно зависит от направления, а не от протокола. SMPP добавляет расходы на поддержку сессий, и они ложатся на вас.

Как добиться высокой нагрузки через HTTP

Объём по HTTP обеспечивают пакеты, а не параллельные одиночные запросы. Один пакетный запрос содержит до 1000 сообщений с результатом по каждому; при 50 запросах в секунду это гораздо больше, чем когда-либо понадобится большинству отправителей. Несколько привычек помогают работать без сбоев:

  • Читайте X-RateLimit-Remaining и снижайте темп до того, как получите 429; при 429 ждите столько, сколько указано в Retry-After.
  • Пусть сообщения удерживает платформа: send_at для заданного момента и местное окно window для доставки по местному времени заменяют таймеры на вашей стороне.
  • Получайте результаты через вебхуки, а не опросом: опрос 300 000 сообщений по одному — это 300 000 запросов, которые вам не были нужны.
  • Выделяйте каждой отправляющей системе собственный ключ, поскольку ограничение действует для каждого ключа отдельно.

Если SMPP действительно нужен

Перед подписанием договора спросите провайдера:

  • Какая версия протокола и защищена ли сессия TLS или VPN? Обычный SMPP передаёт пароль открытым текстом.
  • Сколько сессий, каких типов, с какой пропускной способностью каждая и с каким размером окна?
  • Что означает data_coding 0 на их стороне: GSM-7, Latin-1 или что-то другое?
  • Как должны передаваться длинные сообщения: с заголовками склейки, параметрами SAR или через message_payload?
  • Какой формат отчётов, шестнадцатеричный или десятичный идентификатор сообщения и как сопоставляются коды ошибок?
  • Что происходит с отчётами, пока ваша сессия receiver не работает, и как долго?
  • Какой интервал enquire_link и тайм-аут бездействия они ожидают?

Что предлагает SMSMeteor

REST API с bearer-ключами (sk_live_ и sk_test_), правами отправки и чтения и необязательным списком разрешённых IP-адресов для каждого ключа; одиночные сообщения и пакеты до 1000; ключи идемпотентности; планирование с send_at, окнами по местному времени и темпом для пакетов; подписанные вебхуки с повторными попытками и повторной отправкой; описание OpenAPI; примеры SDK на cURL, Python, Node, PHP и Go. Тестовые ключи проверяют запросы, рассчитывают цену и отвечают как рабочие, но ничего не отправляют и не списывают. SMPP аккаунтам не предоставляется. Если ваша система умеет работать только по SMPP, вам нужен провайдер, предлагающий SMPP-сессии, и лучше узнать это до интеграции.

Примените знания на практике.Для регистрации достаточно адреса электронной почты. Тарифы опубликованы, оплата принимается в криптовалюте, тестовый ключ бесплатный.
Начать отправку

Что-то непонятно или устарело? Сообщите нам на странице поддержки. Мы внесём исправления в руководство и обновим дату.