Statuts et accusés de réception - DexNotify

Message        scheduled → queued → sending → completed | partially_failed | failed
                    └─────────┴─────────┴──▶ cancelled
Destinataire   pending → sending → sent → delivered | failed | expired
                                  └──▶ outcome_unknown → sent | delivered | failed | expired

Statut du destinataire	Sens
`sent`	l’opérateur a accepté le SMS
`delivered`	l’accusé de réception (DLR) de l’opérateur dit qu’il est arrivé
`failed`, `expired`	non remis ; les unités sont remboursées
`outcome_unknown`	la requête est partie, l’opérateur n’a pas répondu

Un SMS en outcome_unknown n’est jamais renvoyé : il a peut-être été reçu. Ses unités restent réservées jusqu’à ce que l’opérateur tranche.

Le message se conclut quand plus aucun destinataire n’attend : completed si tous sont partis, failed si aucun, partially_failed sinon.

Les routes

Route	Rend
`GET /api/v1/sms/messages/{id}`	statut, compteurs par statut, unités ; le destinataire d’un envoi unique
`GET /api/v1/sms/messages/{id}/recipients?status=`	les destinataires, paginés, avec leur code d’erreur
`GET /api/v1/sms/messages/{id}/report`	répartition par statut et par pays, accusés de réception cumulés
`GET /api/v1/sms/messages?status=&from=&to=&page=`	l’historique du projet
`GET /api/v1/sms/messages/export`	le même historique en CSV
`GET /api/v1/sms/stats`	envoyés, remis, échecs, unités, par période

Portée : sms:read. Sans sms:send, les numéros lus dans l’historique sont masqués (+22177•••4567). Plutôt que d’interroger ces routes en boucle, abonnez-vous aux webhooks sms.sent, sms.delivered, sms.failed et sms.message.completed.