Le DLR est un mécanisme crucial qui vous permet de recevoir des informations en temps réel sur l’état de livraison de chaque SMS que vous envoyez.
1. URL de Réception du DLR (WebHook) #
Cette section vous permet de spécifier l’endroit où FasterMessage doit envoyer les rapports de livraison.
- Définition : C’est l’adresse (URL) de votre serveur ou application où FasterMessage enverra les rapports DLR.
- Objectif : Recevoir des informations en temps réel sur l’état de livraison de chaque message (livré, non livré, en attente, etc.).
- Action : Vous devez saisir votre URL de réception du DLR dans le champ prévu. Une fois saisie, utilisez le bouton « Modifier » pour la sauvegarder.
2. Envoi du DLR et Méthode HTTP #
Cette partie définit comment le DLR sera techniquement renvoyé à votre URL.
- Mécanisme : Le DLR est renvoyé à votre serveur en utilisant la méthode HTTP que vous spécifiez.
- Méthodes Disponibles :
- GET : Les données du DLR (les variables) sont incluses directement dans l’URL de votre serveur sous forme de paramètres de requête.
- POST : Les données du DLR sont envoyées dans le corps de la requête HTTP à votre URL.
- Action : Vous devez choisir votre méthode HTTP préférée (GET ou POST) et cliquer sur « Modifier » pour sauvegarder ce choix.
3. Les Variables à Cocher (Données du DLR) #
Cette section vous permet de personnaliser le contenu exact du rapport de livraison que vous recevrez.
- Objectif : Les variables à cocher vous permettent de spécifier les informations que vous souhaitez voir incluses dans les rapports de réception de messages (le payload ou la query string du DLR).
- Action : Cochez toutes les variables dont votre application a besoin pour traiter correctement le statut de livraison. Après avoir sélectionné vos variables, cliquez sur « Valider » pour enregistrer votre sélection.
4- Liste des Variables Communes (et leur utilité) #
| Variables | Description |
| messageId | L’identifiant unique du message chez Fastermessage. |
| from | Le numéro (ou Sender ID) qui a envoyé le message. |
| to | Le numéro de téléphone du destinataire. |
| text | Le contenu du message envoyé. |
| messageStatusCode | Code numérique détaillé indiquant l’état de livraison (très utile pour l’automatisation). |
| sentAt | Horodatage indiquant quand le message a été envoyé depuis la plateforme. |
| smsCount | Le nombre de segments SMS facturés pour ce message (un SMS long compte pour plusieurs). |
| messageStatus | Le statut de livraison en texte (ex: DELIVERED, UNDELIVERED). |
| description | Une description textuelle plus détaillée du statut ou de l’erreur. |
| batchuuid | L’identifiant du lot (batch) si le message faisait partie d’un envoi groupé. |
| uuid | Un autre identifiant unique potentiel pour le message. |
En choisissant les variables nécessaires et en configurant votre URL et votre méthode HTTP, vous mettez en place un système d’Accusé de Réception fiable pour suivre la performance de vos communications.