Відстеження
Статус повідомлення та звіти про доставку
| status | Значення | Фінальний | Списано |
|---|---|---|---|
| scheduled | Очікування на send_at. | No | Так, повертається, якщо скасовано |
| queued | Прийнято та очікується наступний прохід черги (кожні дві секунди). | No | Yes |
| sent | Передано мережі; очікування на звіт про доставку. | No | Yes |
| delivered | Пристрій підтвердив доставку. | Yes | Yes |
| failed | Не вдалося доставити; помилка пояснює причину. | Yes | Ні, повернено |
| canceled | Його запланований пакет було скасовано. | Yes | Ні, повернено |
Коди помилок у повідомленнях
| error.code | Значення |
|---|---|
| network_error | Повідомлення не вдалося передати мережі. Його вартість повернута на баланс. |
| undeliverable | Мережа повідомила, що пристрій недоступний. |
| canceled | Запланований пакет було скасовано до його початку. |
Повернення коштів
Коли повідомлення не вдається, його повна вартість повертається на баланс у тому ж проході, як рядок повернення в реєстрі, який називає пакет. Поле refunded пакету показує загальну суму повернених коштів.
Webhooks або опитування
Webhooks, це швидкий шлях: кожен фінальний статус викликає ваш endpoint після його встановлення. Для невеликих обсягів або для перевірки використовуйте опитування GET /v1/messages/{id} або GET /v1/batches/{id}; ліміт запитів дозволяє використовувати обидва способи.