01Статусы
Шесть терминов без двусмысленности.
Сообщение переходит только вперёд, поэтому поздний отчёт не отменяет предыдущий. Конечные статусы уже не меняются.
- В очередиПринято и оценено, ожидание слота маршрута.
- ОтправленоПередано оператору связи. В этот момент списывается плата.
- ДоставленоТелефон подтвердил получение.
- ОшибкаОператор связи не смог доставить сообщение. К статусу прилагается его код ошибки.
- Срок истёкНе доставлено в течение 48 часов.
- ОтклоненоОтклонено до отправки. Плата не списывается.
02Причины недоставки
Код оператора связи и рекомендуемое действие.
Исходные коды различаются у разных операторов связи. Мы сопоставляем их с кратким списком причин, поэтому из отчёта сразу понятно, нужно ли очистить список, изменить отправителя или подождать.
| Причина | Что произошло | Типичная доля | Что делать |
|---|---|---|---|
| Неизвестный номер | Номер не закреплён ни за одним абонентом. | 1–3% | Удалите номер из списка: доставить на него сообщение невозможно. |
| Абонент недоступен | Телефон был выключен или вне зоны сети в течение всего срока действия. | 1–2% | Повторите отправку в следующей кампании: телефон может снова появиться в сети. |
| Память телефона заполнена | Телефон не смог принять сообщение. | < 0,5% | Повторите попытку позже. |
| Заблокировано фильтром оператора связи | Оператор связи пометил текст или отправителя. | зависит от маршрута | Проверьте правила отправителя для страны; на строгих маршрутах не используйте сокращатели ссылок. |
| Отправитель не разрешён | Указан буквенно-цифровой отправитель, а маршрут требует числового или зарегистрированного отправителя. | 0% | Отклоняется до отправки: платформа автоматически предлагает допустимую замену. |
| Неподдерживаемое направление | Для этого префикса нет маршрута. | 0% | Отклонено при импорте, плата не списана. |
03Что можно делать с отчётом
Фильтровать, экспортировать и передавать данные.
-
Фильтровать по любому полю
Статус, направление, отправитель, кампания, диапазон дат и причина оператора связи. Часто используемые фильтры можно сохранить.
-
Экспортировать одним нажатием
CSV или JSON для отдельной кампании или текущей выборки: идентификатор сообщения, номер, статус, причина, временные метки и цена.
-
Получайте вебхуки
Каждое изменение статуса передаётся на адрес вашего обработчика сразу после события. Те же данные без периодических запросов.
-
Воронка кампании
Количество и доля отправленных, доставленных, недоставленных и ожидающих сообщений с разбивкой по причинам ошибок.
-
Очистка списка
Неизвестные номера можно удалить из исходного списка одним нажатием, чтобы не включать их в следующую кампанию.
-
История за 90 дней
Записи по каждому сообщению доступны для поиска в течение 90 дней. Сводки по кампаниям хранятся бессрочно.
04Вопросы, ответы
Вопросы об отчётах о доставке.
Что означает каждый статус?
«В очереди»: сообщение принято и оценено. «Отправлено»: передано оператору связи, плата списана. «Доставлено»: устройство подтвердило получение. «Ошибка»: оператор связи не смог доставить сообщение и вернул код. «Истёк срок»: сообщение не доставлено за 48 часов. «Отклонено»: отказ до отправки, плата не списана.
Как быстро обновляются статусы?
Статус «Отправлено» появляется сразу. Подтверждение доставки обычно приходит за несколько секунд, но некоторые операторы связи передают отчёты пакетами с задержкой в несколько минут. При ошибке код оператора связи появляется сразу после получения. Вебхуки отправляются при каждом изменении статуса.
Что такое код оператора связи?
Это причина недоставки от оператора связи: абонент недоступен, номер не существует, память телефона заполнена или сообщение заблокировано фильтром. Мы сохраняем исходный код и добавляем понятное русское описание, чтобы вы могли принять меры, например удалить недействительные номера.
Как долго хранится история?
Запись по каждому сообщению доступна для поиска и экспорта в течение 90 дней. Сводки по кампаниям хранятся бессрочно. Экспортируйте данные, которые нужны дольше.
Могу ли я экспортировать отчёты?
Да. Отчёт по отдельной кампании или отфильтрованным сообщениям можно выгрузить в CSV или JSON. В нём будут идентификатор сообщения, номер, статус, код оператора связи, временные метки и цена.
Взимается ли плата за отчёты?
Нет. Отчёты, экспорт и вебхуки включены в каждый аккаунт. Вы платите только за сообщения.
Могу ли я смотреть в одном отчёте сообщения из API и кампаний в панели?
Да. Все сообщения аккаунта попадают в единый отчёт. Сообщения из API можно снабдить тегом кампании и сгруппировать вместе с рассылками из панели.
Почему доставленных сообщений меньше, чем отправленных?
Некоторые телефоны выключены, часть номеров неактивна, а операторы могут фильтровать сообщения. Разбивка по причинам показывает основную проблему. Если растёт доля неизвестных номеров, обычно нужно очистить список, а не менять маршрут.
05Больше продуктов
Всё остальное в наборе инструментов.
Один аккаунт, общий баланс и единая таблица тарифов. Все перечисленные возможности включены без дополнительной платы.
Посмотреть тарифы- Массовые SMS-кампанииЗагрузите список, напишите один раз, разошлите миллионам.
- SMS APIОдин HTTP вызов на одно сообщение. Любой язык.
- ПланированиеОкна доставки по местному времени для каждого направления.
- Идентификатор отправителя и маршрутыБуквенно-цифровые, числовые или общие отправители.
- ВебхукиСобытия доставки передаются на адрес вашего обработчика.