Reçus de livraison
Lorsque vous envoyez une requête à l'API SMS, celle-ci renvoie un tableau d'adresses de message un pour chaque message. Idéalement, ces objets auront un status de 0ce qui indique que le message a été envoyé avec succès. Mais cela ne signifie pas que votre message est parvenu à vos destinataires. Cela signifie seulement que votre message a été mis en file d'attente pour l'envoi.
Vonage's routage adaptatif identifie ensuite le meilleur transporteur pour votre message. Lorsque le transporteur sélectionné a délivré le message, il renvoie un message de type récépissé de livraison (DLR).
Pour recevoir des DLR dans votre candidature, vous devez fournir un webhook pour que Vonage les envoie. Vous pouvez également utiliser l'option Reports API pour télécharger périodiquement vos enregistrements, y compris l'état de livraison de chaque message.
Note: Dans la plupart des cas, un DLR est un indicateur fiable de la remise d'un message. Toutefois, il ne s'agit pas d'une garantie absolue. Voir fonctionnement des accusés de réception.
Fonctionnement des accusés de réception
Les récépissés de livraison sont soit :
- Transporteur - renvoyé lorsque le fournisseur de services reçoit le message
- Combiné - renvoyé lorsque le combiné de l'utilisateur reçoit le message
Tous les accusés de réception ne garantissent pas que la cible a reçu votre message. Certains accusés de réception représentent la réussite d'une seule étape du processus de livraison, comme la transmission du message à un autre opérateur. D'autres accusés de réception sont des faux. Pour cette raison, Vonage ne peut pas garantir complètement l'exactitude d'un ARL. Cela dépend de l'opérateur pays vous envoyez des messages et les fournisseurs concernés.
Si votre message est plus long que ce qui peut être envoyé dans un seul SMS, les messages sont concaténé. Vous devriez recevoir un DLR de l'opérateur pour chaque partie du SMS concaténé. Les DLR des combinés pour un message concaténé sont retardés. En effet, le combiné cible doit traiter chaque partie du message concaténé avant d'accuser réception du message complet.
Comprendre le récépissé de livraison
Il s'agit d'un DLR typique :
{
"err-code": "0",
"message-timestamp": "2018-10-25 12:10:29",
"messageId": "0B00000127FDBC63",
"msisdn": "447547232824",
"network-code": "23410",
"price": "0.03330000",
"scts": "1810251310",
"status": "delivered",
"to": "Vonage"
}
Les domaines les plus importants sont status et err-code car ils vous indiquent si votre message a été délivré et, dans le cas contraire, ce qui n'a pas fonctionné.
Messages d'état DLR
Les status Le champ "SMS" du DLR vous indique si votre SMS a été délivré avec succès. Les valeurs possibles sont les suivantes :
status | Description |
|---|---|
accepted | Le message a été accepté pour livraison, mais n'a pas encore été livré. |
delivered | Le message a été délivré |
buffered | Le message a été mis en mémoire tampon en vue d'une livraison ultérieure |
expired | Le message a été retenu par le système de relance du transporteur en aval et n'a pas pu être délivré dans le délai imparti. |
failed | Message non délivré |
rejected | Le transporteur en aval refuse de délivrer le message |
unknown | Aucune information utile n'est disponible |
Codes d'erreur DLR
Les err-code dans le DLR fournit des informations plus détaillées et peut aider à résoudre un échec de livraison. Un code non nul indique que le message n'a pas pu être délivré.
err-code | Signification | Description | |
|---|---|---|---|
| 0 | Livré | Le message a été transmis avec succès | |
| 1 | Inconnu | Le message n'a pas été délivré et aucune raison n'a pu être déterminée. | |
| 2 | Abonné absent - Temporaire | Le message n'a pas été délivré parce que le combiné était temporairement indisponible - réessayer | |
| 3 | Abonné absent - Permanent | Le numéro n'est plus actif et doit être supprimé de votre base de données. | |
| 4 | Appel interdit par l'utilisateur | Il s'agit d'une erreur permanente. Le numéro doit être supprimé de votre base de données et l'utilisateur doit contacter son opérateur de réseau pour supprimer la barre. | |
| 5 | Erreur de portabilité | Il y a un problème lié à la portabilité du numéro et vous devez contacter l'opérateur de réseau pour le résoudre | |
| 6 | Rejet anti-spam | Le message a été bloqué par le filtre anti-spam d'un opérateur. | |
| 7 | Combiné occupé | Le combiné n'était pas disponible au moment de l'envoi du message - réessayer | |
| 8 | Erreur de réseau | Le message a échoué en raison d'une erreur de réseau - réessayer | |
| 9 | Numbers illégaux | L'utilisateur a expressément demandé à ne pas recevoir de messages d'un service spécifique. | |
| 10 | Message illégal | Il y a une erreur dans un paramètre du message, par exemple un drapeau d'encodage erroné. | |
| 11 | Incorruptible | Vonage ne parvient pas à trouver un itinéraire adéquat pour transmettre le message. soutien | |
| 12 | Destination inaccessible | L'itinéraire vers le numéro est introuvable - confirmer le numéro du destinataire | |
| 13 | Restriction de l'âge de l'abonné | La cible ne peut pas recevoir votre message en raison de son âge | |
| 14 | Numbers bloqués par le transporteur | Le destinataire doit demander à son opérateur d'activer les SMS dans son plan. | |
| 15 | Paiements anticipés Fonds insuffisants | Le destinataire bénéficie d'un plan prépayé et ne dispose pas d'un crédit suffisant pour recevoir votre message. | |
| 16 | Dépassement du quota de la passerelle | La livraison du message a échoué parce que le nombre autorisé de demandes par période a été dépassé. NB : Cette erreur n'apparaît que pour les Account enregistrés aux États-Unis et en France. | |
| 17 | Message bloqué par le fournisseur | Le fournisseur de messagerie a choisi de bloquer ce message. Cela peut être dû au contenu ou aux restrictions imposées par le fournisseur. | |
| 20 | Règle de circulation du défenseur de la fraude | Le message a été rejeté par une règle de trafic du Défenseur contre la fraude. Réviser les règles de circulation dans le tableau de bord du client. Plus d'informations sur les règles de circulation du Défenseur de la Fraude | |
| 21 | Numérotation séquentielle anormale détectée | Le seuil de la plage de numéros de contact à haute densité a été dépassé. | |
| 22 | Fraud Defender SMS Burst Protection | La limite de trafic a été atteinte | |
| 23 | Protection de l'AIT | Le message a été rejeté par Fraud Defender AIT Protection | |
| 24 | Règle du réseau Fraud Defender | Le message a été rejeté par une règle du réseau de lutte contre la fraude. Réviser les règles du réseau dans le tableau de bord du client. | |
| 25 | Règle du pays du défenseur de la fraude | Le message a été rejeté par une règle de pays du défenseur de la fraude. Révision des règles nationales dans le tableau de bord du client. | |
| 39 | Adresse d'expéditeur illégale pour une destination aux États-Unis | Tous les SMS envoyés aux États-Unis doivent provenir d'un numéro long ou d'un code court préapprouvé aux États-Unis et associé à votre compte Vonage. Plus d'informations sur les caractéristiques et les restrictions des SMS américains | |
| 41 | Dépassement de la limite journalière | Contrôle des soumissions interrompu en raison du volume maximal atteint pour la période | |
| 50 | Filtre d'entités | Le message a échoué pour les raisons suivantes entity-id sont incorrectes ou ne sont pas fournies. Plus d'informations sur les réglementations nationales | |
| 51 | Filtre d'en-tête | Le message a échoué car l'ID de l'en-tête (from numéro de téléphone) était incorrecte ou manquante. Plus d'informations sur les réglementations nationales | |
| 52 | Filtre de contenu | Le message a échoué pour les raisons suivantes content-id sont incorrectes ou ne sont pas fournies. Plus d'informations sur les réglementations nationales | |
| 53 | Filtre de consentement | Le message a échoué car le consentement n'est pas autorisé. Plus d'informations sur les réglementations nationales | |
| 54 | Erreur de régulation | Erreur de régulation inattendue - contact soutien | |
| 99 | Erreur générale | Une erreur s'est produite dans le traitement de votre demande - veuillez contacter soutien |
Les autres champs du DLR sont expliqués dans la section Référence API.
Utiliser l'API SMS dans les campagnes
Avant de lancer votre campagne de messagerie, vérifiez les éléments suivants guide des spécificités nationales pour les pays destinataires. Si le pays vers lequel vous envoyez vos envois ne fournit pas de DLR fiables, utilisez le formulaire de demande d'informations. Conversion API afin de fournir à Vonage davantage de données et d'assurer le meilleur acheminement.
En option, vous pouvez identifier des clients ou des campagnes spécifiques en joignant une référence à chaque message envoyé. Ces références sont incluses dans le récépissé de livraison. Transmettez la référence que vous avez choisie dans la demande en spécifiant une valeur de client-ref d'un maximum de 40 caractères.
Autres ressources
- Guide des webhooks - un guide détaillé sur l'utilisation des webhooks avec la plateforme de Vonage
- Pourquoi mon SMS n'a-t-il pas été délivré ? - conseils utiles de dépannage