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

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

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

Что проверить перед повторной отправкой SMS?

SMPP — протокол, через который приложение передаёт SMS шлюзу. В этой цепочке есть разные события: приложение передало запрос, шлюз ответил на него, затем пришёл отчёт о доставке. Успешный ответ шлюза ещё не подтверждает, что телефон получил сообщение. А отсутствие ответа само по себе не доказывает, что шлюз отверг запрос.

Поэтому начните с журнала одной отправки. Найдите событие, которое запустило SMS, ответ шлюза и идентификатор сообщения, если шлюз его вернул. Затем сопоставьте их с отчётом о доставке — DLR. Названия статусов и правила их обработки уточните в документации поставщика.

В журнале стоит разделить следующие сведения:

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

Это разделение помогает разобраться в спорном случае. Например, уведомление о готовности заказа осталось без ответа из-за обрыва соединения. Если приложение сразу создаст новую отправку, оно потеряет связь с первой попыткой. Сохраните её как отправку с неопределённым результатом и проверьте доступные сведения у шлюза.

Какие ошибки SMPP повторять, а какие остановить?

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

  1. При явном временном отказе назначайте повтор с паузой. Основанием должна быть документация шлюза, которая разрешает новую попытку для этого ответа.
  2. При ошибке параметров остановите отправку до исправления запроса. Повтор того же содержимого не устранит причину отказа.
  3. При проблеме подключения или доступа приостановите соответствующий поток. Сначала восстановите соединение или исправьте настройки учётной записи.
  4. При отсутствии ответа проверьте предыдущую попытку. Возвращать SMS в обычную очередь можно только по заранее согласованному правилу для неопределённого результата.
  5. После приёма SMS шлюзом обрабатывайте дальнейшие статусы отдельно. Задержка DLR сама по себе не должна запускать новую отправку.

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

Для смены маршрута действует тот же принцип: сначала выясните судьбу исходной отправки. Отдельно разберите fallback-маршрутизацию SMS при сбоях SMPP, чтобы резервный маршрут не стал источником дублей.

Как настроить очередь и повторы без перегрузки шлюза?

Передавайте SMS через очередь задач. Приложение, которое оформляет заказ или запись, записывает событие, а отдельный обработчик отправляет сообщение. Так временный сбой связи не заставляет клиента заново выполнять основное действие, а разработчик управляет повторными попытками отдельно от оформления заказа. Такой подход описан в материале о защите API и SMPP от дублей (smpp.by).

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

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

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

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

Как проверить обработку ошибок до запуска?

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

  1. Проверьте временный отказ: задача остаётся в очереди и ждёт назначенного времени повтора.
  2. Проверьте ошибку параметров: обработчик останавливает задачу и показывает причину, без повторной отправки прежнего запроса.
  3. Проверьте обрыв после передачи запроса: приложение сохраняет неопределённый результат и запускает сверку вместо немедленного повтора.
  4. Проверьте задержку отчёта о доставке: приложение сохраняет факт приёма SMS шлюзом и не создаёт дубль.
  5. Проверьте восстановление связи: очередь разбирается с ограничением скорости, а просроченные уведомления не уходят клиентам.

В мониторинге отдельно показывайте ошибки подключения, отказы на запросы и статусы доставки. Смешанный показатель «ошибки SMS» скрывает причину: отправка могла остановиться ещё до шлюза или завершиться отказом уже после приёма сообщения. Для уведомлений об аварии задавайте временное окно и повторную проверку, чтобы единичный сбой не выглядел как длительная остановка (smpp.by, «Как настроить мониторинг SMS-интеграции в 2026 году»).

Если интеграцию настраивает подрядчик, включите эти проверки в задание. Вместе с подключением к SMPP-шлюзу запросите правила повторов, журнал попыток и аналитику по причинам отказов. Результат можно принять по истории тестовых отправок: у каждой задачи есть объяснимое конечное состояние.

Типичные ошибки при обработке сбоев SMPP

  • Повторять любой отказ. Причина: приложение не различает временный сбой и ошибку запроса. Исправление: назначить действие каждому известному коду из документации шлюза.
  • Считать таймаут подтверждением неудачи. Причина: ответ потерялся, но шлюз мог принять SMS. Исправление: выделить неопределённый результат и согласовать порядок сверки.
  • Отправлять SMS заново из-за задержки DLR. Причина: приложение смешивает приём сообщения и его доставку. Исправление: вести эти состояния отдельно.
  • Сбрасывать историю при перезапуске обработчика. Причина: новая задача не видит прежнюю попытку. Исправление: сохранять связь события, попыток и идентификатора шлюза.
  • Доставлять накопленные сообщения без проверки срока. Причина: очередь учитывает только технический успех. Исправление: перед каждой попыткой проверять актуальность уведомления.

Начните с одного действия: за две минуты отправьте поставщику шлюза запрос «Пришлите перечень кодов SMPP с правилами повторов и порядком проверки отправки, если соединение оборвалось до получения ответа». Этот ответ станет основой задания разработчику.