Statuts possibles d'un SMS
| Statut | Description |
|---|---|
accepted | Message accepté pour livraison, mais pas encore livré |
delivered | Message reçu |
buffered | Message mis en attente pour une livraison ultérieure |
expired | Le message a expiré après plusieurs tentatives chez l’opérateur |
failed | Message non reçu |
rejected | L’opérateur a refusé la livraison du message |
unknown | Aucune information exploitable disponible |
Comprendre les accusés de réception (DLR)
Lorsque vous effectuez une requête réussie vers l’API SMS, celle-ci retourne un tableau d’objets message, un pour chaque message. Idéalement, ces objets ont un status égal à 0, indiquant un succès. Cependant, cela ne signifie pas que votre message est arrivé chez le destinataire : cela indique uniquement que votre message a été correctement mis en file d’attente pour l’envoi.
Le mécanisme de routage adaptatif de Vonage identifie ensuite le meilleur opérateur pour acheminer votre message. Une fois que l’opérateur sélectionné a livré le message, il renvoie un accusé de réception de livraison (Delivery Receipt ou DLR).
Remarque : dans la plupart des cas, un DLR est un indicateur fiable qu’un message a été livré. Toutefois, ce n’est pas une garantie absolue. Voir le fonctionnement détaillé des accusés de réception ci-dessous.
Fonctionnement des accusés de réception
Les accusés de réception peuvent être de deux types :
|
Tous les accusés de réception ne garantissent pas que le message a bien été lu ou effectivement reçu par l’utilisateur final. Certains accusés indiquent uniquement la réussite d’une étape intermédiaire (par exemple, le transfert du message à un autre opérateur). D’autres peuvent même être erronés.
Pour cette raison, nous ne pouvons pas garantir à 100 % l’exactitude d’un accusé de réception. Cela dépend des pays de destination et des opérateurs impliqués.
Si votre message dépasse la longueur maximale d’un SMS, il sera concaténé (découpé en plusieurs SMS). Vous devriez recevoir un accusé de réception opérateur pour chaque segment du message.
Les accusés de réception côté appareil mobile pour les messages concaténés sont retardés, car le téléphone doit recevoir et reconstituer tous les segments avant de confirmer la réception complète.
Codes d’erreur Accusé de réception (DLR)
Le champ err-code fournit des informations plus détaillées en cas d’échec. Toute valeur différente de 0 indique que le message n’a pas été reçu.
| Code | Signification | Description |
|---|---|---|
| 0 | Délivré | Message reçu avec succès |
| 1 | Inconnu | Message non reçu sans raison identifiable |
| 2 | Abonné absent – Temporaire | Téléphone temporairement indisponible – nouvelle tentative possible |
| 3 | Abonné absent – Permanent | Numéro inactif, à supprimer de votre base |
| 4 | Appels/SMS bloqués par l’utilisateur | Erreur permanente – l’utilisateur doit contacter son opérateur |
| 5 | Erreur de portabilité | Problème lié à la portabilité du numéro |
| 6 | Rejet anti-spam | Message bloqué par un filtre anti-spam |
| 7 | Téléphone occupé | Terminal indisponible – nouvelle tentative possible |
| 8 | Erreur réseau | Échec réseau – nouvelle tentative possible |
| 9 | Numéro interdit | L’utilisateur a demandé à ne plus recevoir ce type de messages |
| 10 | Message invalide | Erreur de paramètre (ex. encodage incorrect) |
| 11 | Non routable | Aucun itinéraire valide trouvé |
| 12 | Destination injoignable | Numéro incorrect ou introuvable |
| 13 | Restriction d’âge | Le destinataire ne peut pas recevoir ce message |
| 14 | Numéro bloqué par l’opérateur | SMS désactivés sur le forfait |
| 15 | Crédit insuffisant (prépayé) | Le destinataire n’a pas assez de crédit |
| 16 | Quota dépassé | Trop de requêtes (US et France uniquement) |
| 17 | Message bloqué par le fournisseur | Blocage lié au contenu ou à des règles internes |
| 20 | Règle Fraud Defender | Message rejeté par une règle anti-fraude |
| 21 | Appels séquentiels anormaux | Seuil de numéros consécutifs dépassé |
| 22 | Protection anti-burst SMS | Limite de trafic atteinte |
| 23 | Protection AIT | Message rejeté par la protection AIT |
| 24 | Règle réseau Fraud Defender | Blocage via règle réseau |
| 25 | Règle pays Fraud Defender | Blocage via règle pays |
| 39 | Expéditeur non autorisé (US) | Numéro d’envoi non conforme aux règles US |
| 41 | Limite journalière atteinte | Volume maximal atteint |
| 50 | Filtre entité | entity-id manquant ou incorrect |
| 51 | Filtre en-tête | Champ from incorrect ou manquant |
| 52 | Filtre contenu | content-id manquant ou incorrect |
| 53 | Filtre consentement | Consentement non autorisé |
| 54 | Erreur réglementaire | Erreur réglementaire inattendue |
| 99 | Erreur générale | Erreur interne – contacter le support |
Associé à
Mise à jour