Suivi
Statut des messages et rapports de livraison
| status | Signification | Final | Facturé |
|---|---|---|---|
| scheduled | En attente de send_at. | No | Oui, remboursé si annulé |
| queued | Accepté et en attente du prochain passage dans la file (toutes les deux secondes). | No | Yes |
| sent | Transmis au réseau ; en attente du rapport de livraison. | No | Yes |
| delivered | Le terminal a confirmé la livraison. | Yes | Yes |
| failed | Impossible à livrer ; l'erreur indique pourquoi. | Yes | Non, remboursé |
| canceled | Son lot programmé a été annulé. | Yes | Non, remboursé |
Codes d'erreur sur les messages
| error.code | Signification |
|---|---|
| network_error | Le message n'a pas pu être transmis au réseau. Son coût a été recrédité au solde. |
| undeliverable | Le réseau a signalé que le terminal était injoignable. |
| canceled | Le lot programmé a été annulé avant son démarrage. |
Remboursements
Lorsqu'un message échoue, son coût complet est recrédité au solde immédiatement, sous forme d'une ligne de remboursement dans le registre mentionnant le lot. Le champ refunded du lot affiche le total cumulé.
Webhooks ou interrogation
Les webhooks sont la voie rapide : chaque statut final déclenche un appel à votre endpoint une fois établi. Pour de petits volumes ou pour vérification, interrogez GET /v1/messages/{id} ou GET /v1/batches/{id} ; la limite de taux permet les deux.