Как исключить повторные SMS о заказе при сбоях связи с CRM?

Как исключить повторные SMS о заказе при сбоях связи с CRM?

Начните с проверки: сохраняет ли интеграция факт отправки SMS для конкретного события заказа. Чтобы исключить повторы, CRM и сервис уведомлений должны узнавать одно и то же событие при повторном запросе. Для этого используют постоянный идентификатор события, журнал отправок и проверку результата перед новой попыткой. Если связь оборвалась, отсутствие ответа ещё не означает, что сервис не принял сообщение. Ниже разберём, как найти источник дублей, поставить задачу разработчику и проверить защиту без рассылки клиентам.

Почему после сбоя клиент получает одинаковые SMS?

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

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

Для проверки возьмите один заказ с дублем и сопоставьте записи в CRM с журналом SMS-сервиса. Найдите событие, время запросов и идентификаторы сообщений. Если CRM отправила несколько запросов, разбирать нужно правила запуска и повторные попытки. Если запрос один, а сервис показывает несколько сообщений, передайте его идентификатор в поддержку для проверки.

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

Как настроить одно SMS на одно событие заказа?

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

Ключ должен различать события внутри заказа. Одного номера заказа недостаточно: после подтверждения покупки клиенту ещё может понадобиться сообщение о готовности к выдаче. Если заказ повторно проходит тот же этап по обоснованной причине, интеграции нужно различать и эти переходы.

  1. Определите точное событие. Например, переход заказа в статус «Готов к выдаче», а не любое сохранение карточки с этим статусом.
  2. Назначьте событию постоянный ключ. Свяжите его с заказом, типом уведомления и конкретным переходом статуса.
  3. До обращения к SMS-сервису создайте запись в журнале отправок. Запретите создание второй записи с таким же ключом.
  4. Сохраните ответ сервиса и идентификатор сообщения. Повторный обработчик должен найти эту запись и продолжить проверку результата.
  5. Проверьте поддержку ключа повторного запроса в API провайдера. Если она есть, передавайте один и тот же ключ при каждой попытке.

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

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

Что делать, если SMS-сервис не ответил?

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

Для неизвестного результата заведите отдельное состояние, например «Ожидает проверки». Дальнейшее действие зависит от возможностей API: запросить статус, дождаться уведомления от сервиса или повторить запрос с прежним ключом, если провайдер гарантирует защиту от повторной отправки.

Если API не поддерживает ни поиск исходного запроса, ни безопасный повтор, полностью гарантировать одно SMS при потере ответа нельзя. Выберите явное правило для таких случаев: приостановить отправку и передать её на проверку сотруднику. Это оставляет неопределённость видимой, вместо того чтобы скрывать её за новым сообщением.

Мониторинг доставки помогает разобраться с результатом, но статус «доставлено» не сообщает, прочитал ли клиент SMS. Поэтому отсутствие ответа клиента не стоит использовать как автоматическую причину отправить тот же текст снова. Подробнее об этом различии — в статье почему статус SMS «доставлено» не подтверждает прочтение.

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

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

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

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

  • Повторно сохраните карточку без смены статуса. Новое уведомление не должно появиться.
  • Передайте одно событие в обработку повторно. Интеграция должна найти прежний ключ и запись об отправке.
  • Попросите разработчика воспроизвести потерю ответа после приёма запроса сервисом. Система должна перейти к проверке результата или безопасному повтору.
  • Запустите обработку одного события одновременно. Уникальный ключ должен остановить вторую отправку.
  • Переведите заказ на следующий этап. Защита от дублей не должна блокировать другое нужное уведомление.

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

Типичные ошибки при защите от повторных SMS

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

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

Следующий шаг на две минуты: откройте настройки CRM и выпишите, какие правила отправляют SMS при переходе заказа в статус «Готов к выдаче».