Śledzenie
Status wiadomości i raporty dostarczenia
| status | Znaczenie | Ostateczny | Naliczono |
|---|---|---|---|
| scheduled | Oczekiwanie na send_at. | No | Tak, zwrot środków w przypadku anulowania |
| queued | Zaakceptowane i oczekujące na kolejne przejście kolejki (co dwie sekundy). | No | Yes |
| sent | Przekazano do sieci; oczekiwanie na raport dostawy. | No | Yes |
| delivered | Telefon potwierdził dostawę. | Yes | Yes |
| failed | Nie można było dostarczyć; błąd wyjaśnia przyczynę. | Yes | Nie, zwrot środków |
| canceled | Jego zaplanowana partia została anulowana. | Yes | Nie, zwrot środków |
Kody błędów w wiadomościach
| error.code | Znaczenie |
|---|---|
| network_error | Wiadomość nie mogła zostać przekazana do sieci. Jej koszt został zwrócony na saldo. |
| undeliverable | Sieć zgłosiła, że nie można było połączyć się z telefonem. |
| canceled | Zaplanowana partia została anulowana przed rozpoczęciem. |
Zwroty
Gdy wiadomość nie zostanie dostarczona, jej pełny koszt zostaje zwrócony na saldo w tym samym przebiegu, jako pozycja zwrotu w księdze, która wskazuje partię. Pole refunded partii pokazuje bieżącą sumę.
Webhooks lub polling
Webhooks to szybka ścieżka: każdy ostateczny status wywołuje Twój endpoint, gdy zostanie ustawiony. Dla małych wolumenów lub w celu podwójnego sprawdzenia, użyj poll GET /v1/messages/{id} lub GET /v1/batches/{id}; limit szybkości pozostawia miejsce dla obu.