Жизненный цикл статуса — последовательность состояний 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.
