• 228 направлений
  • Без KYC — всегда
  • Bitcoin, Monero, USDT и ещё 4 валюты

Доставка и отчётность

Жизненный цикл сообщения

Жизненный цикл статуса — последовательность состояний SMS в шлюзе: «в очереди», «отправлено», затем «доставлено», «ошибка» или «истёк срок действия»; сообщение, не прошедшее проверку до отправки, получает статус «отклонено».

Принятое сообщение с рассчитанной ценой получает статус «В очереди» (queued) и может ждать в нём своего времени отправки, окна доставки или своей очереди в кампании с заданным темпом. Статус «Отправлено» (sent) оно получает при передаче оператору связи — в этот момент происходит списание. Отсюда сообщение приходит к одному из конечных состояний: «Доставлено» (delivered) после подтверждения доставки на телефон, «Ошибка» (failed), если оператор не смог его доставить, или «Срок истёк» (expired), если закончился срок действия. Шестое состояние — «Отклонено» (rejected): его получают сообщения, отклонённые до любой попытки отправки, и они никогда не оплачиваются.

СтатусЧто он означаетОплата
В очереди (queued)Принято, цена рассчитана; ждёт своего времени, окна или очередиПока нет
Отправлено (sent)Передано оператору связиДа, в этот момент
Доставлено (delivered)Телефон подтвердил получениеУже оплачено при отправке
Ошибка (failed)Оператор не смог доставить сообщение; указана причинаДа, сообщение было отправлено
Срок истёк (expired)Срок действия закончился до доставкиДа, сообщение было отправлено
Отклонено (rejected)Не допущено к отправкеНикогда

Статусы меняются только вперёд. События вебхуков могут приходить с опозданием, в виде повторных попыток или при повторной отправке, поэтому более ранний статус никогда не должен перезаписывать более поздний; обработчики применяют события по рангу статуса, а не по времени получения: конечные статусы выше «Отправлено», а «Отправлено» выше «В очереди». Условный пример: напоминание, созданное в 08:59 для окна, которое открывается в 09:00, находится в статусе «В очереди», затем в 09:00:01 получает статус «Отправлено», а в 09:00:05 — «Доставлено». Если событие о доставке первым дойдёт до вашей конечной точки, а за ним при повторной попытке придёт событие об отправке, запись должна остаться в статусе «Доставлено».

Часто встречаются две ошибки в интерпретации:

  • Считать «Отправлено» концом истории. Этот статус окончательный только в странах, где есть подтверждение оператора связи, но нет подтверждений доставки на телефон.
  • Считать «Отклонено» ошибкой доставки. Ничего не было отправлено, а значит, ничего не списано, и исправлять нужно входные данные; см. статусы «Ошибка» и «Отклонено».

В SMSMeteor: шесть статусов — «В очереди» (queued), «Отправлено» (sent), «Доставлено» (delivered), «Ошибка» (failed), «Срок истёк» (expired) и «Отклонено» (rejected); тестовые ключи возвращают седьмой, «Тест» (test), для сообщений, которые прошли проверку и расчёт цены, но не были отправлены и оплачены. За каждым изменением статуса следует подписанное событие вебхука: message.sent, message.delivered, message.failed, message.expired и message.rejected. Определение каждого статуса приведено в справочнике API.

Подробнее

Посмотрите, как это работает на практике.Для регистрации достаточно адреса электронной почты. Таблица тарифов открыта, оплата принимается в криптовалюте, тестовый ключ бесплатный.
Начать отправку