Как обрабатывать ошибки SMPP и когда повторять SMS

Начните с разделения ошибок SMPP по результату отправки: шлюз отклонил сообщение, принял его или не успел вернуть ответ. Повторяйте только те отправки, для которых понятны причина сбоя и условия новой попытки. При неопределённом результате сначала проверьте журнал и доступные статусы, иначе клиент рискует получить дубль. Ниже разберём, как связать ошибки с очередью SMS, когда остановить повторы и какие сведения запросить у поставщика шлюза. Такой порядок поможет предпринимателю поставить задачу разработчику и проверить результат без погружения в устройство протокола.
Что проверить перед повторной отправкой SMS?
SMPP — протокол, через который приложение передаёт SMS шлюзу. В этой цепочке есть разные события: приложение передало запрос, шлюз ответил на него, затем пришёл отчёт о доставке. Успешный ответ шлюза ещё не подтверждает, что телефон получил сообщение. А отсутствие ответа само по себе не доказывает, что шлюз отверг запрос.
Поэтому начните с журнала одной отправки. Найдите событие, которое запустило SMS, ответ шлюза и идентификатор сообщения, если шлюз его вернул. Затем сопоставьте их с отчётом о доставке — DLR. Названия статусов и правила их обработки уточните в документации поставщика.
В журнале стоит разделить следующие сведения:
- Идентификатор события: какой заказ, запись или запрос запустил уведомление.
- Идентификатор попытки: какой именно запрос приложение передало шлюзу.
- Результат запроса: шлюз принял SMS, отклонил его или ответ не получен.
- Идентификатор сообщения у поставщика и последний известный статус доставки.
- Решение обработчика: ждать, повторить, завершить или передать на проверку.
Это разделение помогает разобраться в спорном случае. Например, уведомление о готовности заказа осталось без ответа из-за обрыва соединения. Если приложение сразу создаст новую отправку, оно потеряет связь с первой попыткой. Сохраните её как отправку с неопределённым результатом и проверьте доступные сведения у шлюза.
Какие ошибки SMPP повторять, а какие остановить?
Согласуйте с поставщиком перечень кодов ошибок и назначьте каждому действие. Сам текст «ошибка отправки» для автоматизации бесполезен: временная перегрузка и отказ из-за параметров запроса требуют разных решений. Неизвестный код направляйте на разбор, без бесконечных автоматических повторов.
- При явном временном отказе назначайте повтор с паузой. Основанием должна быть документация шлюза, которая разрешает новую попытку для этого ответа.
- При ошибке параметров остановите отправку до исправления запроса. Повтор того же содержимого не устранит причину отказа.
- При проблеме подключения или доступа приостановите соответствующий поток. Сначала восстановите соединение или исправьте настройки учётной записи.
- При отсутствии ответа проверьте предыдущую попытку. Возвращать SMS в обычную очередь можно только по заранее согласованному правилу для неопределённого результата.
- После приёма SMS шлюзом обрабатывайте дальнейшие статусы отдельно. Задержка DLR сама по себе не должна запускать новую отправку.
Правила для итоговых статусов доставки тоже запросите у поставщика. Если получатель временно недоступен, шлюз может продолжать доставку в пределах собственных настроек. Повтор со стороны приложения в этот момент создаст ещё одно сообщение. Уточните, какие статусы окончательные и когда поставщик прекращает попытки доставки.
Для смены маршрута действует тот же принцип: сначала выясните судьбу исходной отправки. Отдельно разберите fallback-маршрутизацию SMS при сбоях SMPP, чтобы резервный маршрут не стал источником дублей.
Как настроить очередь и повторы без перегрузки шлюза?
Передавайте SMS через очередь задач. Приложение, которое оформляет заказ или запись, записывает событие, а отдельный обработчик отправляет сообщение. Так временный сбой связи не заставляет клиента заново выполнять основное действие, а разработчик управляет повторными попытками отдельно от оформления заказа. Такой подход описан в материале о защите API и SMPP от дублей (smpp.by).
Для повторов задайте паузу, предел попыток и срок актуальности сообщения. Значения выбирайте по назначению SMS и ограничениям поставщика. Напоминание после начала записи уже потеряло смысл, даже если технически его ещё можно отправить. Просроченную задачу завершайте с понятной причиной в журнале.
При серии временных отказов увеличивайте интервалы между попытками. Добавляйте небольшой случайный разброс пауз, чтобы задачи не возвращались к шлюзу одновременно. Новые сообщения и повторы должны проходить через общий ограничитель скорости: иначе очередь повторов сама создаст дополнительную нагрузку.
После восстановления соединения не выгружайте всё накопленное сразу. Сначала уберите просроченные задачи, затем возобновите поток в пределах согласованной скорости. Для срочных сообщений выделите приоритет, но сохраните общий предел нагрузки на подключение.
Защиту от дублей привяжите к событию бизнеса. Повтор обработки одного события должен находить существующую отправку, а очередная попытка — оставаться внутри её истории. Ключ события сам по себе не гарантирует защиту на стороне шлюза: поддержку идемпотентности и срок действия такого механизма нужно уточнить у поставщика. Практические детали разобраны в статье как избежать дублей SMS при сбоях API и SMPP.
Как проверить обработку ошибок до запуска?
Попросите разработчика проверить сбои на тестовом подключении или в согласованной с поставщиком среде. Проверка должна показать не только ответ шлюза, но и дальнейшее действие приложения. Для каждого сценария сохраните историю задачи: по ней должно быть понятно, почему обработчик повторил SMS или остановился.
- Проверьте временный отказ: задача остаётся в очереди и ждёт назначенного времени повтора.
- Проверьте ошибку параметров: обработчик останавливает задачу и показывает причину, без повторной отправки прежнего запроса.
- Проверьте обрыв после передачи запроса: приложение сохраняет неопределённый результат и запускает сверку вместо немедленного повтора.
- Проверьте задержку отчёта о доставке: приложение сохраняет факт приёма SMS шлюзом и не создаёт дубль.
- Проверьте восстановление связи: очередь разбирается с ограничением скорости, а просроченные уведомления не уходят клиентам.
В мониторинге отдельно показывайте ошибки подключения, отказы на запросы и статусы доставки. Смешанный показатель «ошибки SMS» скрывает причину: отправка могла остановиться ещё до шлюза или завершиться отказом уже после приёма сообщения. Для уведомлений об аварии задавайте временное окно и повторную проверку, чтобы единичный сбой не выглядел как длительная остановка (smpp.by, «Как настроить мониторинг SMS-интеграции в 2026 году»).
Если интеграцию настраивает подрядчик, включите эти проверки в задание. Вместе с подключением к SMPP-шлюзу запросите правила повторов, журнал попыток и аналитику по причинам отказов. Результат можно принять по истории тестовых отправок: у каждой задачи есть объяснимое конечное состояние.
Типичные ошибки при обработке сбоев SMPP
- Повторять любой отказ. Причина: приложение не различает временный сбой и ошибку запроса. Исправление: назначить действие каждому известному коду из документации шлюза.
- Считать таймаут подтверждением неудачи. Причина: ответ потерялся, но шлюз мог принять SMS. Исправление: выделить неопределённый результат и согласовать порядок сверки.
- Отправлять SMS заново из-за задержки DLR. Причина: приложение смешивает приём сообщения и его доставку. Исправление: вести эти состояния отдельно.
- Сбрасывать историю при перезапуске обработчика. Причина: новая задача не видит прежнюю попытку. Исправление: сохранять связь события, попыток и идентификатора шлюза.
- Доставлять накопленные сообщения без проверки срока. Причина: очередь учитывает только технический успех. Исправление: перед каждой попыткой проверять актуальность уведомления.
Начните с одного действия: за две минуты отправьте поставщику шлюза запрос «Пришлите перечень кодов SMPP с правилами повторов и порядком проверки отправки, если соединение оборвалось до получения ответа». Этот ответ станет основой задания разработчику.


