Что означают статусы

Слово «статус» в кабинете означает две разные вещи, и почти каждый вопрос об отчёте возникает оттого, что их перепутали.

Статус рассылки отвечает на вопрос «закончил ли кабинет её отдавать». Статус сообщения отвечает на вопрос «что случилось с этим одним сообщением по дороге к этому одному телефону». Рассылка может показывать «Завершено», когда треть её сообщений ещё в пути, — и это нормально.

Четыре корзины

Что бы ни сообщил оператор, кабинет раскладывает это по четырём группам. Отчёт, карточка рассылки и полоска прогресса пользуются одними и теми же четырьмя.

Корзина	Что означает	Окончательная ли
Ожидает отправку	Принято, ещё не отдано — ждёт, повторяется или придержано	Нет
Отправлено	Отдано оператору, ответа о доставке ещё нет	Нет
Доставлено	Оператор подтвердил, что телефон получил	Да
Не доставлено	Всё остальное: отклонено, истёк срок, нет маршрута, неверный номер, неизвестно	Да

Названия в таблице — те, что на карточках итогов над отчётом и в полоске итогов под его строками. Подсказка с разбивкой по статусам доставки называет первую корзину так же: «Ожидает отправку». Строка одиночного сообщения несёт метку, которая называет те же корзины по-своему: «Ожидает», «Идет отправка…», «Доставлено», «Ошибка».

Из этой таблицы следуют две вещи, и обе удивляют.

«Отправлено» — это не хорошая новость. Это значит, что сообщение ушло и ничего не вернулось. Позже оно станет либо «Доставлено», либо «Не доставлено». Рассылка, которая долго стоит на «Отправлено», — это обычно рассылка на номера, чей оператор не присылает отчётов о доставке.

«Не доставлено» — это остаток, а не диагноз. Сюда попадает всё, что кабинет не может отнести к «Ожидает отправку», «Отправлено» или «Доставлено». Причину конкретного сообщения ищут в карточке рассылки, а не в названии корзины.

В итогах число «Не доставлено» — это арифметика

Полоска итогов под отчётом считает остаток: всё, что не «Ожидает отправку», не «Отправлено» и не «Доставлено», показано как «Не доставлено». Поэтому причину конкретного сообщения стоит посмотреть в карточке рассылки — там она написана.

Что означает «Отправлено» в агрегатах

В агрегатах есть ещё одна ловушка. В списке рассылок одна строка — это одна рассылка, а не одно сообщение. Пока рассылка в состоянии «Идёт отправка» или «Завершено», метка её строки выбирается по приоритету, а не по большинству:

1. что угодно в «Ожидает отправку» оставляет строку на собственном статусе рассылки — «Идёт отправка» или «Завершено»;
2. иначе что угодно доставленное делает её «Доставлено»;
3. иначе что угодно отправленное делает её «Идет отправка…»;
4. и только тогда она становится «Ошибка».

В любом другом состоянии строка показывает статус самой рассылки.

Рассылка на десять тысяч сообщений, из которых одно доставлено, а остальные провалились, в этом списке показана как «Доставлено». Именно поэтому число рассылок и число сообщений никогда не сходятся друг с другом — и именно поэтому существует карточка рассылки.

Рассылка «Завершено» или «Удалено» может выглядеть полностью доставленной

Когда рассылка «Завершено» или «Удалено», состояния её сообщений могут больше не храниться. Тогда карточка рассылки показывает всю рассылку доставленной: диаграмма идёт за состоянием самой рассылки, а не за состояниями её сообщений.

Части против сообщений

Сообщение длиннее одной части едет несколькими частями, и каждая часть получает от оператора собственный статус. Кабинет держит оба счёта:

• отчёты считают сообщения — одна строка это одно сообщение на один номер;
• аналитика считает оба рядом: сообщения и части.

Деньги идут за частями. Доставка тоже идёт за частями: длинное сообщение считается доставленным, когда доходят его части, — из-за этого в отчёте может появиться «Частично доставлено» у того, что на телефоне выглядит одной SMS.

Что показывает колонка «Прочитано»

Есть и пятая корзина — Прочитано, и наполняют её каналы, которые сообщают о прочтении: Viber среди них.

В SMS оператор подтверждает, что телефон получил сообщение, — именно это показывает колонка «Доставлено». Колонка «Прочитано» ведёт собственный счёт для тех каналов, у которых он есть, поэтому рядом с полной колонкой «Доставлено» она остаётся нулевой для обычных SMS: это SMS, работающая ровно так, как работает SMS. Число прочитанных к тому же никогда не бывает больше числа доставленных.

Полный перечень кодов

Каждый статус, который может вернуть оператор, имеет собственный номер и название — от QUEUED до SIM FULL. Полная нумерованная таблица живёт в разделе API этой документации, на странице о статусах сообщений: та страница объясняет каждый код, а эта — четыре корзины, в которые те коды сворачиваются.