Tracciamento
Stato del messaggio e rapporti di consegna
| status | Significato | Finale | Addebitato |
|---|---|---|---|
| scheduled | In attesa di send_at. | No | Sì, rimborsato se annullato |
| queued | Accettato e in attesa del prossimo passaggio in coda (ogni due secondi). | No | Yes |
| sent | Consegnato alla rete; in attesa del report di consegna. | No | Yes |
| delivered | Il dispositivo ha confermato la consegna. | Yes | Yes |
| failed | Impossibile consegnare; l'errore spiega il motivo. | Yes | No, rimborsato |
| canceled | Il suo batch programmato è stato annullato. | Yes | No, rimborsato |
Codici di errore sui messaggi
| error.code | Significato |
|---|---|
| network_error | Il messaggio non è stato consegnato alla rete. Il suo prezzo è stato riaccreditato al saldo. |
| undeliverable | La rete ha segnalato che il dispositivo non era raggiungibile. |
| canceled | Il batch programmato è stato annullato prima dell'invio. |
Rimborsi
Quando un messaggio fallisce, il suo prezzo completo viene riaccreditato al saldo nello stesso passaggio, come voce di rimborso nel registro che indica il batch. Il campo refunded del batch mostra il totale accumulato.
Webhooks o polling
Gli webhooks sono la via più veloce: ogni stato finale chiama il tuo endpoint una volta impostato. Per volumi ridotti o per verifiche, esegui il polling con GET /v1/messages/{id} o GET /v1/batches/{id}; il limite di richieste consente entrambi.