Отслеживание
Статус сообщений и отчеты о доставке
| 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}; лимит запросов позволяет использовать оба метода.