Що означають статуси

Слово «статус» у кабінеті означає дві різні речі, і майже кожне питання про звіт виникає через те, що їх переплутали.

Статус розсилки відповідає на питання «чи закінчив кабінет її віддавати». Статус повідомлення відповідає на питання «що сталося з цим одним повідомленням дорогою до цього одного телефона». Розсилка може показувати «Завершено», коли третина її повідомлень ще в дорозі, — і це нормально.

Чотири кошики

Що б не повідомив оператор, кабінет розкладає це на чотири групи. Звіт, картка розсилки і смужка прогресу користуються тими самими чотирма.

Кошик	Що означає	Чи остаточний
Очікує відправлення	Прийнято, ще не віддано — чекає, повторюється або притримане	Ні
Відправлено	Віддано операторові, відповіді про доставку ще немає	Ні
Доставлено	Оператор підтвердив, що телефон отримав	Так
Не доставлено	Усе інше: відхилено, вичерпано строк, немає маршруту, хибний номер, невідомо	Так

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

З цієї таблиці випливають дві речі, і обидві дивують.

«Відправлено» — це не добра новина. Це означає, що повідомлення пішло і нічого не повернулося. Згодом воно стане або «Доставлено», або «Не доставлено». Розсилка, яка довго стоїть на «Відправлено», — це зазвичай розсилка на номери, чий оператор не надсилає звітів про доставку.

«Не доставлено» — це залишок, а не діагноз. Сюди потрапляє все, що кабінет не може віднести до «Очікує відправлення», «Відправлено» або «Доставлено». Причину конкретного повідомлення шукають у картці розсилки, а не в назві кошика.

У підсумках кількість «Не доставлено» — це арифметика

Смужка підсумків під звітом рахує залишок: усе, що не «Очікує відправлення», не «Відправлено» і не «Доставлено», показано як «Не доставлено». Тому причину конкретного повідомлення варто подивитися в картці розсилки — там вона написана.

Що означає «Відправлено» в агрегатах

В агрегатах є ще одна пастка. У списку розсилок один рядок — це одна розсилка, а не одне повідомлення. Поки розсилка в стані «Триває відправлення» або «Завершено», позначка її рядка обирається за пріоритетом, а не за більшістю:

1. будь-що в «Очікує відправлення» лишає рядок на власному статусі розсилки — «Триває відправлення» або «Завершено»;
2. інакше будь-що доставлене робить її «Доставлено»;
3. інакше будь-що відправлене робить її «Триває відправлення…»;
4. і лише тоді вона стає «Помилка».

У будь-якому іншому стані рядок показує статус самої розсилки.

Розсилка на десять тисяч повідомлень, з яких одне доставлено, а решта провалилася, у цьому списку показана як «Доставлено». Саме тому кількість розсилок і кількість повідомлень ніколи не сходяться між собою — і саме тому існує картка розсилки.

Розсилка «Завершено» або «Видалено» може виглядати повністю доставленою

Коли розсилка «Завершено» або «Видалено», стани її повідомлень можуть більше не зберігатися. Тоді картка розсилки показує всю розсилку доставленою: діаграма йде за станом самої розсилки, а не за станами її повідомлень.

Частини проти повідомлень

Повідомлення, довше за одну частину, їде кількома частинами, і кожна частина отримує від оператора власний статус. Кабінет тримає обидва підрахунки:

• звіти рахують повідомлення — один рядок це одне повідомлення на один номер;
• аналітика рахує обидва поруч: повідомлення і частини.

Гроші йдуть за частинами. Доставка теж іде за частинами: довге повідомлення вважається доставленим, коли доходять його частини, — через це у звіті може з'явитися «Частково доставлено» для того, що на телефоні виглядає як одна SMS.

Що показує колонка «Прочитано»

Є ще п'ятий кошик — Прочитано, і наповнюють його канали, які звітують про прочитання: Viber серед них.

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

Повний перелік кодів

Кожен статус, який може повернути оператор, має власний номер і назву — від QUEUED до SIM FULL. Повна нумерована таблиця живе в розділі API цієї документації, на сторінці про статуси повідомлень: та сторінка пояснює кожен код, а ця — чотири кошики, у які ті коди згортаються.