Statuts de livraison

Acceptation et livraison sont deux événements

Une réponse HTTP réussie confirme le résultat de l’opération API. Elle ne prouve pas que le destinataire a reçu le message. Utilisez l’identifiant public retourné dès la création pour consulter GET /api/sms/v2/messages/{id}/.

Défilement horizontal si nécessaire. Au clavier : Tab, puis les flèches gauche et droite.

Statut	Signification
scheduled	Le message est enregistré pour une date future.
processing	Le traitement de l’envoi est en cours.
accepted	La soumission a été acceptée ; la livraison n’est pas encore confirmée.
delivered	Un accusé confirme la livraison.
undeliverable	Le résultat de livraison indique une impossibilité de livrer.
blocked	L’envoi est bloqué avant soumission au fournisseur.
failed	L’envoi a échoué avec un résultat certain.
unknown	Les éléments disponibles ne permettent pas de conclure.

Les états n’apparaissent pas nécessairement tous lors de vos consultations. Un accusé peut arriver rapidement, tardivement ou plusieurs fois.

Consulter sans surcharger

La clé doit disposer de delivery.read et appartenir à l’organisation du message. Conservez le dernier état connu et espacez progressivement vos consultations tant qu’aucun résultat terminal n’est disponible. Traitez une éventuelle limitation HTTP 429 selon les indications de la réponse.

Pour les lots, consultez les compteurs du lot et parcourez ses messages avec le curseur retourné. Le succès de création du lot ne remplace pas les résultats individuels.

Faire apparaître l’incertitude

Un statut unknown ne doit pas devenir « non envoyé » dans votre interface. Affichez un état explicite et conservez l’identifiant pour votre investigation. Un délai sans accusé ne suffit pas non plus à conclure à un échec.

Si le résultat reste incertain, contactez l’assistance avec l’identifiant et la période concernés.