Ressource Commentaires sur le message
Commentaires sur le message est une sous‐ressource d'une ressource de message. Les commentaires sur le message désignent le résultat rapporté par l'utilisateur d'un message.
Pour mieux comprendre et optimiser la remise des messages, reportez‐vous à Envoi de commentaires sur les messages à Twilio.
Vous recherchez des instructions détaillées sur le suivi du statut de remise des messages que vous envoyez ? Suivez notre guide de Suivi du statut de remise dans le langage de programmation de votre choix.
Propriétés de Commentaires sur le message
| Resource Properties in REST API format | |
|---|---|
account_sid
|
SID du Compte qui a créé la ressource MessageFeedback. |
message_sid
|
SID de la ressource de message pour laquelle le feedback a été fourni. |
outcome
|
Indique si le feedback est arrivé. Ce peut être : |
date_created
|
Date et heure de création de la ressource, en GMT, spécifiées au format RFC 2822. |
date_updated
|
Date et heure de la dernière mise à jour de la ressource, en GMT, spécifiées au format RFC 2822. |
uri
|
URI de la ressource relatif à |
Valeurs de résultat
Voici les valeurs possibles pour le paramètre Outcome :
| Résultat | Description |
|---|---|
| non confirmé |
Le message n'est pas encore parvenu au numéro de téléphone Notez que cela peut signifier que le message a le statut Votre application ne doit pas utiliser POST pour cette valeur, car il est défini par défaut lorsque le POST HTTP initial inclut |
| confirmé | Le message est parvenu au numéro de téléphone To. Même si la remise du message est retardée, vous devez quand même utiliser POST pour cette valeur dès que vous avez confirmé la réception du message. |
Créer une ressource Commentaires sur le message
https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/Messages/{MessageSid}/Feedback.json
Pour suivre les commentaires sur le message, vous devez définir ProvideFeedback=true lors de la création initiale du message. Cette action crée une instance Message Feedback ayant un paramètre Outcome au statut unconfirmed.
Dès que vous confirmez la remise de votre message, vous pouvez mettre à jour l'instance Commentaire. Utilisez POST sur la ressource Commentaires sur le message pour mettre à jour Outcome au statut confirmed.
Parameters
| Parameters in REST API format | |
|---|---|
account_sid
Path
|
SID du Compte qui va créer la ressource. |
message_sid
Path
|
SID de la ressource de message pour laquelle le feedback a été fourni. |
outcome
Optional
|
Indique si le feedback est arrivé. Ce peut être : |
Exemple d'utilisation
Définissez le paramètre ProvideFeedback sur true lorsque vous envoyez le message.
curl -X POST 'https://api.twilio.com/2010-04-01/Accounts/ACa9b8c7d6e5f43120a9b8c7d6e5f43120/Messages.json' \ --data-urlencode 'To=+18085551234' \ --data-urlencode 'From=+16045559876' \ --data-urlencode 'Body=Votre code de vérification est : 249205' \ --data-urlencode 'ProvideFeedback=true' \ -u ACa9b8c7d6e5f43120a9b8c7d6e5f43120:[AuthToken]
Enregistrez le SID de message : vous pouvez le trouver dans la réponse de l'API de votre message envoyé :
{"sid": "SM1f2e3d4c5b6a70891f2e3d4c5b6a7089", "date_created": "Jeu, 14 juil 2016 14:18:40 +0000", ...}
Si l'utilisateur reçoit le message texte, utilisez POST sur la sous‐ressource Commentaires pour définir le paramètre Outcome du message sur « confirmé ».
curl -X POST 'https://api.twilio.com/2010-04-01/Accounts/ACa9b8c7d6e5f43120a9b8c7d6e5f43120/Messages/SM1f2e3d4c5b6a70891f2e3d4c5b6a7089/Feedback.json' \ --data-urlencode 'Outcome=confirmé' \ -u ACa9b8c7d6e5f43120a9b8c7d6e5f43120:[AuthToken]
Example 1
Prise en charge par la bibliothèque d'aide
Le endpoint Commentaires sur le message est pris en charge dans nos bibliothèques d'aide de nouvelle génération. Ce endpoint n'est pas pris en charge par nos bibliothèques d'aide héritées.
Si vous utilisez une bibliothèque d'aide héritée, vous pouvez toujours utiliser l'API Commentaires sur le message en utilisant POST directement sur le endpoint REST.
Besoin d'aide ?
Ça arrive à tout le monde, il est parfois difficile de coder. Obtenez de l'aide dès maintenant auprès de notre équipe d'assistance, ou appuyez‑vous sur la sagesse collective en visitant le collectif Stack Overflow Twilio ou en parcourant le tag Twilio sur Stack Overflow.
