Statuts de livraison
Acceptation et livraison sont deux événements
Section intitulée « 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. |
cancelled | Un administrateur a arrêté le message avant soumission et libéré ses crédits réservés. |
Les états n’apparaissent pas nécessairement tous lors de vos consultations. Un accusé peut arriver rapidement, tardivement ou plusieurs fois.
Consulter sans surcharger
Section intitulée « 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
Section intitulée « 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.
cancelled est définitif. Conservez l’identifiant et arrêtez les consultations répétées. Le rejeu de création restitue sa réponse initiale et ne remet jamais cet envoi en file. Consultez le statut par GET pour connaître son état courant. Aucune opération publique d’annulation n’est proposée.
Annulation confirmée
Section intitulée « Annulation confirmée »{ "id": "10000000-0000-4000-8000-000000000001", "to": "+261320000001", "sender_name": "BEFIANA", "segments": 2, "status": "cancelled", "send_at": "2030-01-14T06:00:00Z", "delivery_time": null}