本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
AWS 最终用户消息 SMS 可以流式传输有关短信、彩信和语音消息传送的事件数据。承运人生成的事件最多可能需要 72 小时才能接收,因此不应将其用于确定出站邮件传送是否存在延迟。72 小时后,如果 AWS 最终用户消息短信未收到运营商的最终事件,则该服务将自动返回 UNKNOWN,messageStatus
因为我们不知道该消息发生了什么。
短信示例日志
短信事件的 JSON 对象包含以下示例中显示的数据。
{
"eventType": "TEXT_SUCCESSFUL",
"eventVersion": "1.0",
"eventTimestamp": 1686975103470,
"isFinal": true,
"originationPhoneNumber": "+12065550152",
"destinationPhoneNumber": "+14255550156",
"isoCountryCode": "US",
"mcc": "310",
"mnc": "800",
"messageId": "862a8790-60c0-4430-9b2b-658bdexample",
"messageRequestTimestamp": 1686975103170,
"messageEncoding": "GSM",
"messageType": "PROMOTIONAL",
"messageStatus": "SUCCESSFUL",
"messageStatusDescription": "Message has been accepted by phone carrier",
"context": {
"account": "bar"
},
"totalMessageParts": 1,
"totalMessagePrice": 0.09582,
"totalCarrierFee": 0.0
}
属性 | 描述 |
---|---|
eventType |
事件类型。值列在 短信、彩信和语音的事件类型 |
eventVersion |
事件 JSON 架构的版本。 |
eventTimestamp |
报告事件的时间,显示为以毫秒为单位的 Unix 时间。 |
isFinal |
True 如果这是消息的最终状态。有中间消息状态,最长可能需要 72 小时才能收到最终的消息状态。 |
originationPhoneNumber |
用于发送消息的电话号码。 |
destinationPhoneNumber |
尝试将消息发送到的电话号码。 |
isoCountryCode |
与接收人的电话号码关联的国家,按 ISO 3166-1 alpha-2 格式显示。 |
mcc |
移动国家/地区代码用于标识电话号码所属的国家/地区。此字段为可选字段,可能不存在。 |
mnc |
移动网络代码用于标识移动网络运营商。此字段为可选字段,可能不存在。 |
messageId |
AWS 最终用户消息 SMS 在接受消息时生成的唯一 ID。 |
messageRequestTimestamp |
接收 SMS 消息请求的时间,显示为 Unix 时间,以毫秒为单位。 |
messageEncoding |
消息的编码。可能的值为 GSM 和 Unicode。有关消息编码的更多信息,请参阅短信字符限制。 |
messageType |
消息类型。可能的值为 Promotional 和 Transactional。 |
messageStatus |
消息的状态。可能的值有:
|
messageStatusDescription |
对消息状态的描述。 |
context |
您可以指定并将在您发送消息时记录的自定义属性。 |
totalMessageParts |
AWS 最终用户消息 SMS 为发送消息而创建的消息部分的数量。 通常,短信只能包含 160 个 GSM-7 字符或 67 个非 GSM 字符,但这些限制会因国家而异。如果您发送的消息超过了这些限制,则 AWS 最终用户消息短信会自动将消息拆分为较小的部分。我们根据您发送的消息部分数量收取费用。有关消息部分的更多信息,请参阅每秒消息分数 (MPS) 的限制是多少。 |
totalMessagePrice |
我们向您收取的发送消息的费用。此价格以千分之一美分显示。例如,如果此属性的值为 645 ,则我们收取的消息发送单价是 0.645¢ (645 / 1000 = 0.645¢ = $0.00645)。 |
totalCarrierFee |
一条消息的运营商费用总额。 |
语音示例事件日志
语音事件的 JSON 对象包含以下示例中显示的数据。
{
"eventType": "VOICE_COMPLETED",
"eventVersion": "1.0",
"eventTimestamp": 1697835373500,
"isFinal": true,
"originationPhoneNumber": "+12065550153",
"destinationPhoneNumber": "+14255550159",
"isoCountryCode": "US",
"messageId": "567f6c11-6e8b-4352-9749-a42a0example",
"messageRequestTimestamp": 1697835372720,
"messageStatus": "COMPLETED",
"callDurationInSeconds": 60,
"totalDurationInMinutes": 1,
"totalMessagePrice": 0.013,
"context": {
"account": "bar"
}
}
属性 | 描述 |
---|---|
eventType |
事件类型。值列在 短信、彩信和语音的事件类型 |
eventVersion |
事件 JSON 架构的版本。 |
eventTimestamp |
报告事件的时间,显示为以毫秒为单位的 Unix 时间。 |
isFinal |
True 如果这是消息的最终状态。有中间的消息状态。 |
originationPhoneNumber |
用于发送消息的电话号码。 |
destinationPhoneNumber |
尝试将消息发送到的电话号码。 |
isoCountryCode |
与接收人的电话号码关联的国家,按 ISO 3166-1 alpha-2 格式显示。 |
messageId |
AWS 最终用户消息 SMS 在接受消息时生成的唯一 ID。 |
messageRequestTimestamp |
接收 SMS 消息请求的时间,显示为 Unix 时间,以毫秒为单位。 |
messageStatus |
消息的状态。可能的值有:
|
callDurationInSeconds |
通话时长(以秒为单位)。 |
totalDurationInMinutes |
通话时长(以分钟为单位)。 |
totalMessagePrice |
我们向您收取的发送语音留言的金额。此价格以千分之一美分显示。 |
context |
您可以指定并将在您发送消息时记录的自定义属性。 |
彩信示例日志
彩信事件的 JSON 对象包含以下示例中显示的数据。
{
"contentType":"MMS",
"eventType": "MEDIA_DELIVERED",
"eventVersion": "1.0",
"eventTimestamp": 1635197695208,
"isFinal": true,
"originationPhoneNumber": "+12065550153",
"destinationPhoneNumber": "+14255550159",
"isoCountryCode": "US",
"messageId": "b4a3196d-5b61-4884-a0d9-745acf1f6235example",
"messageRequestTimestamp": 1635197693241,
"messageType": "TRANSACTIONAL",
"messageStatus": "DELIVERED",
"messageStatusDescription": "Message has been accepted by phone",
"context": {"foo":"bar"},
"totalMessageParts": 1,
"totalMessagePrice": 0.0195,
"totalCarrierFee": 0.00266
}
属性 | 描述 |
---|---|
eventType |
事件类型。值列在 短信、彩信和语音的事件类型 |
eventVersion |
事件 JSON 架构的版本。 |
eventTimestamp |
报告事件的时间,显示为以毫秒为单位的 Unix 时间。 |
isFinal |
True 如果这是消息的最终状态。有中间消息状态,最长可能需要 72 小时才能收到最终的消息状态。 |
originationPhoneNumber |
用于发送消息的电话号码。 |
destinationPhoneNumber |
尝试将消息发送到的电话号码。 |
isoCountryCode |
与接收人的电话号码关联的国家,按 ISO 3166-1 alpha-2 格式显示。 |
messageId |
AWS 最终用户消息 SMS 在接受消息时生成的唯一 ID。 |
messageRequestTimestamp |
接收 SMS 消息请求的时间,显示为 Unix 时间,以毫秒为单位。 |
messageType |
消息类型。可能的值为 Promotional 和 Transactional。 |
messageStatus |
消息的状态。可能的值有:
|
messageStatusDescription |
对消息状态的描述。 |
context |
您可以指定并将在您发送消息时记录的自定义属性。 |
totalMessageParts |
AWS 最终用户消息 SMS 为发送消息而创建的消息部分的数量。有关消息部分的更多信息,请参阅每秒消息分数 (MPS) 的限制是多少。 |
totalMessagePrice |
我们向您收取的发送消息的费用。此价格以千分之一美分显示。例如,如果此属性的值为 645 ,则我们收取的消息发送单价是 0.645¢ (645 / 1000 = 0.645¢ = $0.00645)。 |
totalCarrierFee |
一条消息的运营商费用总额。 |