Что представляет собой каждый протокол
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.
Сравнение
| Аспект | SMPP | HTTP 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:
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, построенный на основе вашей собственной записи, и используйте его при каждом повторе. Повтор с тем же ключом возвращает исходный результат вместо повторной отправки, поэтому тайм-аут обходится вам во второй запрос, но никогда — во второе сообщение.
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_coding0 на их стороне: 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-сессии, и лучше узнать это до интеграции.
Что-то непонятно или устарело? Сообщите нам на странице поддержки. Мы внесём исправления в руководство и обновим дату.
