Как отменять SMS о брошенной корзине после заказа через API

Как отменять SMS о брошенной корзине после заказа через API

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

Где держать отложенное SMS, чтобы его можно было отменить?

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

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

Правило исключения покупателей уже есть в практических разборах: клиентов с оформленным заказом убирают из сценария распродажи (smska.by). Для брошенной корзины перед отправкой проверяют статус заказа и отменяют SMS, если он изменился на «оформлен» или «оплачен» (messages.by). На уровне интеграции это означает отдельную проверку перед обращением к шлюзу.

Если исходная цепочка работает в RetailCRM, общий контекст настройки разобран в статье на ibz.by. Названия событий и доступные действия проверьте в своей версии CRM и модуле магазина: универсального имени события для всех подключений нет.

Как связать корзину, заказ и задание на отправку?

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

Ниже — пример состава задания. Названия полей условные: это схема для обсуждения интеграции, а не готовый формат запроса к определённому API.

  • cart_id — идентификатор корзины, к которой относится напоминание.
  • cart_version — версия корзины, если магазин различает её изменения.
  • task_id — идентификатор задания, по которому интеграция отменяет отправку.
  • send_at — время, когда обработчик должен проверить условия и отправить SMS.
  • status — состояние задания, например «ожидает», «отменено» или «передано шлюзу».

Когда магазин создаёт заказ, он передаёт интеграции связь с корзиной. Интеграция находит все её ожидающие напоминания и отменяет их. Если в цепочке предусмотрено повторное касание, закрывайте всю цепочку: отмена только ближайшего задания оставит следующее активным. Автоматическое завершение цепочки после оформления заказа описано и в разборе связки SMS и email (telemedia.by).

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

Как построить отмену через API без повторных отправок?

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

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

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

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

Чтобы событие заказа не потерялось между сохранением покупки и отправкой уведомления интеграции, полезен подход transactional outbox для связи заказа и SMS. Магазин сохраняет событие вместе с изменением заказа, а отдельный обработчик передаёт его дальше с повторами при сбое.

Если магазин временно не отвечает на проверку статуса, безопаснее отложить напоминание и повторить проверку. Заранее задайте срок актуальности: после него задание закрывается без отправки, чтобы старое SMS не ушло вслед за восстановлением сервиса.

Что проверять в логах и при тестовом запуске?

Начните с тестовой корзины и своего номера. В журнале должна прослеживаться одна история: создание задания, оформление заказа, запрос отмены и итоговый статус. Для поиска этой истории нужны идентификаторы корзины и задания, время каждого действия и причина пропуска отправки.

Разделяйте ответы «запрос на отмену принят» и «задание отменено». Если API выполняет отмену асинхронно, первый ответ ещё не подтверждает результат. Интеграции потребуется получить итоговый статус предусмотренным в API способом.

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

В аналитике трафика разделяйте отмену до отправки, приём сообщения шлюзом и доставку. Это разные этапы. Подтверждение приёма не доказывает доставку, а запись «отменено» во внутренней очереди не отзывает сообщение, которое провайдер уже принял.

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

Типичные ошибки при отмене SMS

  • Проверять заказ только при создании задания. За время задержки покупатель завершает покупку; повторите проверку непосредственно перед отправкой.
  • Отменять сообщения только по телефону. Это смешивает разные корзины; используйте связь конкретного заказа с корзиной.
  • Считать удаление задания отзывом SMS. Если шлюз уже принял сообщение, сначала уточните, поддерживает ли он отмену на этом этапе.
  • Оставлять второе напоминание активным. При оформлении заказа закрывайте все ожидающие задания соответствующей цепочки.
  • Отправлять после сбоя без проверки актуальности. Перед повторной попыткой заново проверьте заказ и срок действия задания.

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

Сейчас откройте описание своей интеграции и за две минуты найдите ответ на один вопрос: где ожидает отложенное SMS — в очереди магазина или у провайдера? Если ответа нет, отправьте этот вопрос разработчику.