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
|
The SID of the Account associated with this MessageFeedback resource. |
message_sid
|
The SID of the Message resource associated with this MessageFeedback resource. |
outcome
|
Reported outcome indicating whether there is confirmation that the Message recipient performed a tracked user action. Can be: |
date_created
|
The date and time in GMT when this MessageFeedback resource was created, specified in RFC 2822 format. |
date_updated
|
The date and time in GMT when this MessageFeedback resource was last updated, specified in RFC 2822 format. |
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
|
The SID of the Account associated with the Message resource for which to create MessageFeedback. |
message_sid
Path
|
The SID of the Message resource for which to create MessageFeedback. |
outcome
Optional
|
The outcome to report. Use |
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.