Pagsubaybay
Status ng mensahe at delivery reports
| status | Kahulugan | Panghuli | Sinisingil |
|---|---|---|---|
| scheduled | Naghihintay para sa send_at. | No | Oo, ibabalik kung nakansela |
| queued | Tinanggap at naghihintay para sa susunod na pagdaan sa pila (bawat dalawang segundo). | No | Yes |
| sent | Naipasa sa network; naghihintay sa delivery report. | No | Yes |
| delivered | Kumpirmado ng handset ang paghahatid. | Yes | Yes |
| failed | Hindi naipahatid; ang error ang nagsasabi kung bakit. | Yes | Hindi, ibinalik |
| canceled | Ang naka-iskedyul na batch ay nakansela. | Yes | Hindi, ibinalik |
Mga error code sa mensahe
| error.code | Kahulugan |
|---|---|
| network_error | Hindi maipasa ang mensahe sa network. Ang presyo nito ay ibinalik sa balance. |
| undeliverable | Iniulat ng network na hindi maabot ang handset. |
| canceled | Ang naka-iskedyul na batch ay nakansela bago ito magsimula. |
Refunds
Kapag nabigo ang isang mensahe, ang buong presyo nito ay ibabalik sa balance sa parehong pagdaan, bilang refund line sa ledger na nagpapakilala sa batch. Ang batch field na refunded ay nagpapakita ng running total.
Webhooks o polling
Ang Webhooks ay ang mabilis na daan: bawat final status ay tumatawag sa iyong endpoint kapag ito ay naitakda. Para sa maliliit na volume, o para sa double-check, mag-poll ng GET /v1/messages/{id} o GET /v1/batches/{id}; ang rate limit ay nagbibigay ng puwang para sa pareho.