Как читать ошибку
Для недоставленного сообщения указаны исходный код оператора связи и понятная причина, к которой мы его отнесли. Коды различаются у разных операторов, а набор причин единообразен, поэтому по нему можно принимать решения. Оба значения доступны в отчёте, экспорте и вебхуке message.failed. Сообщение со статусом ошибки было принято оператором, поэтому попытка оплачивается. Если платформа отклонила сообщение до отправки, оно получает статус Отклонено и не оплачивается.
Двенадцать причин
- Неизвестный номер. Такой номер не выделен абоненту. Удалите его из списка: доставить на него сообщение невозможно.
- Абонент недоступен. Телефон был выключен или вне сети в течение всего срока действия (48 часов по умолчанию). Повторите попытку в следующей кампании.
- Телефон занят или память заполнена. Устройство отклонило сообщение. Такое бывает редко; повторите позже.
- Заблокировано фильтром оператора. Оператор пометил текст или отправителя. Проверьте правила имени отправителя и не используйте сокращённые ссылки на строгих маршрутах.
- Портированный номер. Абонент перешёл к другому оператору, а маршрут не учёл перенос номера. Мы автоматически меняем маршрут; повторная попытка обычно проходит успешно.
- Недоступен в роуминге. Абонент находится за границей в сети, которая не принимает сообщение. Повторите позже или исключите номер.
- Обслуживание абонента приостановлено. Частая причина — неоплаченный счёт. Удалите номер после двух таких ошибок.
- Реестр «Не беспокоить». В странах с национальным реестром DND, таких как Индия, рекламный трафик на внесённые в него номера блокируется. Транзакционные шаблоны доставляются, рекламные — нет.
- Недопустимый отправитель для маршрута. Обычно платформа предотвращает эту ошибку, автоматически заменяя отправителя. Она появляется только при отключённой замене.
- Истёк срок действия. Оператор продолжал попытки доставки до окончания срока. Статус будет «Просрочено», а повторная плата не взимается.
- Направление недоступно. Такая проблема обычно отображается на странице статуса. Дождитесь закрытия инцидента: отправка сообщений из очереди возобновится.
- Оператор отклонил сообщение без указания причины. Некоторые операторы возвращают общий код ошибки. Мы отслеживаем такие случаи по каждому оператору и пересматриваем маршрут, если ошибка повторяется.
На какие закономерности реагировать
Отдельная ошибка — шум, а изменение доли — сигнал. Рост неизвестных номеров означает, что список устаревает: удалите их из отчёта одним нажатием. Рост блокировок у одного оператора указывает на текст или отправителя: смените тип отправителя либо удалите сокращённую ссылку. Одновременный скачок ошибок у всех операторов страны говорит о проблеме маршрута — обычно запись появляется на странице статуса ещё до того, как вы её заметите.
Что не считается ошибкой
Статус Отправлено без статуса Доставлено ещё не означает ошибку. Некоторые операторы передают отчёты о доставке пакетами или не передают их вовсе; это указано на странице страны. Статус Отклонено тоже не является ошибкой доставки: платформа не стала отправлять сообщение, которое не прошло проверку, и не списала за него средства.
Что-то непонятно или устарело? Напишите на [email protected]. Мы внесём исправления в руководство и обновим дату.