Отклонённое сообщение шлюз не отправляет и не тарифицирует: причиной может быть неверный номер, неподдерживаемое направление или запрещённый контент. Сообщение со сбоем уже принято оператором, но не доставлено, поэтому попытка оплачивается.
Разница в том, где остановилось сообщение. Отклонение происходит в шлюзе, ещё до какой-либо отправки, обычно прямо в ответе на запрос, с ошибкой, по которой можно сразу действовать: исправить номер, убрать направление, изменить текст. Ошибка доставки происходит позже, у оператора, после передачи сообщения, и возвращается с кодом оператора: неизвестный абонент, запрет, фильтрация, сетевая ошибка. Оба статуса — конечные состояния в жизненном цикле сообщения, но для счёта они означают противоположное.
| Статус | Где останавливается | Что возвращается | Оплата |
|---|---|---|---|
| Отклонено (rejected) | В шлюзе, до отправки | Сообщение об ошибке в ответе API или в отчёте об импорте | Никогда |
| Ошибка (failed) | У оператора, после отправки | Код оператора и причина вместе с отчётом о доставке | Да, попытка состоялась |
Оплата следует за попыткой. Отклонённое сообщение так и не дошло до оператора, поэтому платить не за что; сообщение со статусом «Ошибка» дошло, а операторы, как правило, берут плату за попытку независимо от того, закончилась ли она на телефоне.
Допустим, в условном пакете из 1000 сообщений 12 номеров записаны неверно. Ответ перечисляет эти 12 как отклонённые, каждое со своей ошибкой, а остальные 988 ставит в очередь. Позже 40 из 988 завершаются ошибкой «неизвестный абонент». В счёт входят 988 отправленных сообщений, включая 40 с ошибкой, а за 12 отклонённых ничего не списывается.
Две частые ошибки:
- Повторно отправлять отклонённые сообщения без изменений. Они будут отклонены снова; сначала исправьте входные данные.
- Повторно отправлять сообщения на номера, по которым пришла ошибка «неизвестный абонент». Попытка снова завершится ошибкой и снова будет оплачена.
В SMSMeteor: отклонённые строки перечисляются в отчёте об импорте или возвращаются по отдельности в ответах на пакетные запросы с указанием причины и никогда не оплачиваются; целиком отклоняется только некорректно составленный пакетный запрос. О каждом отклонении с указанием причины сообщает вебхук message.rejected. Сообщения со статусом «Ошибка» были переданы оператору, поэтому оплачиваются; они содержат carrier_code и понятную причину на английском языке в failure_reason.
