MessageFeedback Resource

MessageFeedback is a subresource of a Message resource. Message Feedback represents the user-reported outcome of a message.

To better understand and optimize message deliverability, see sending Message Feedback to Twilio.

Looking for step-by-step instructions on tracking the delivery status of your sent messages? Follow our guide to Tracking Delivery Status in your programming language of choice.

MessageFeedback properties

Resource Properties in REST API format
`account_sid`	sid<AC> Not PII The SID of the Account that created the MessageFeedback resource.
`message_sid`	sid<MM> Not PII The SID of the Message resource for which the feedback was provided.
`outcome`	enum:outcome Not PII Whether the feedback has arrived. Can be: `unconfirmed` or `confirmed`. If `provide_feedback`=`true` in the initial HTTP POST, the initial value of this property is `unconfirmed`. After the message arrives, update the value to `confirmed`.
`date_created`	date_time<rfc2822> Not PII The date and time in GMT that the resource was created specified in RFC 2822 format.
`date_updated`	date_time<rfc2822> Not PII The date and time in GMT that the resource was last updated specified in RFC 2822 format.
`uri`	文字列 Not PII The URI of the resource, relative to `https://api.twilio.com`.

結果の値

下記はOutcomeパラメーターで取りうる値です:

結果概要

unconfirmed

結果	概要
unconfirmed	メッセージが、まだ `To` 電話番号に到着していません。 Note that this may mean the message has `failed` or it is still `pending`. For the purposes of the Message Feedback API, `failed` and `pending` are both considered `unconfirmed`. Your application should not POST this value as is set by default when the initial HTTP POST includes `ProvideFeedback=true`.
confirmed	The message has arrived at the `To` phone number. Even if the message is delayed in delivery, you should still POST this value as soon as you have confirmed that the message was received.

メッセージが、まだ To 電話番号に到着していません。

Note that this may mean the message has failed or it is still pending. For the purposes of the Message Feedback API, failed and pending are both considered unconfirmed.

Your application should not POST this value as is set by default when the initial HTTP POST includes ProvideFeedback=true.

confirmed The message has arrived at the To phone number.

Even if the message is delayed in delivery, you should still POST this value as soon as you have confirmed that the message was received.

Create a MessageFeedback resource

post

https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/Messages/{MessageSid}/Feedback.json

To track message feedback, you must set ProvideFeedback=true when you first create the Message. This will create a Message Feedback instance with an Outcome of unconfirmed.

Once you confirm that your message arrived at its destination, you can update the Feedback instance. POST to the Message Feedback resource to update Outcome to confirmed.

パラメーター

Parameters in REST API format
`account_sid` Path	post sid<AC> Not PII The SID of the Account that will create the resource.
`message_sid` Path	post sid<MM> Not PII The SID of the Message resource for which the feedback was provided.
`outcome` オプション	post enum:outcome Not PII Whether the feedback has arrived. Can be: `unconfirmed` or `confirmed`. If `provide_feedback`=`true` in the initial HTTP POST, the initial value of this property is `unconfirmed`. After the message arrives, update the value to `confirmed`.

Parameters in REST API format

account_sid

Path

post sid<AC> Not PII

The SID of the Account that will create the resource.

message_sid

Path

post sid<MM> Not PII

The SID of the Message resource for which the feedback was provided.

outcome

オプション

post enum:outcome Not PII

Whether the feedback has arrived. Can be: unconfirmed or confirmed. If provide_feedback=true in the initial HTTP POST, the initial value of this property is unconfirmed. After the message arrives, update the value to confirmed.

使用例

Set the ProvideFeedback parameter to true when you send the 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=Your verification code is: 249205' \
--data-urlencode 'ProvideFeedback=true'  \
-u ACa9b8c7d6e5f43120a9b8c7d6e5f43120:[AuthToken]

Save the message SID – you can find this in the API response of your sent message:

{"sid": "SM1f2e3d4c5b6a70891f2e3d4c5b6a7089", "date_created": "Thu, 14 Jul 2016 14:18:40 +0000", ...}

If the user receives the text message, POST to the Feedback subresource to set the message Outcome to 'confirmed'.

curl -X POST 'https://api.twilio.com/2010-04-01/Accounts/ACa9b8c7d6e5f43120a9b8c7d6e5f43120/Messages/SM1f2e3d4c5b6a70891f2e3d4c5b6a7089/Feedback.json' \
--data-urlencode 'Outcome=confirmed'  \
-u ACa9b8c7d6e5f43120a9b8c7d6e5f43120:[AuthToken]