本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# AWS 最终用户消息 SMS 事件数据示例
<a name="configuration-sets-event-format"></a>

AWS 最终用户消息 SMS 可以流式传输短信、彩信和语音消息传送的事件数据。由于接收运营商生成的事件可能需要长达 72 小时，因此不应依赖这些事件来判断出站消息是否存在延迟。72 小时后，如果 AWS 最终用户消息短信未收到运营商的最终事件，则该服务会自动返回，`UNKNOWN``messageStatus`因为我们不知道该消息发生了什么。

**Topics**
+ [短信示例日志](#configuration-sets-event-format-sms-example)
+ [短信保护示例日志](#configuration-sets-event-format-sms-protect-example)
+ [语音示例事件日志](#configuration-sets-event-format-voice-example)
+ [彩信示例日志](#configuration-sets-event-format-mms-example)

## 短信示例日志
<a name="configuration-sets-event-format-sms-example"></a>

短信事件的 JSON 对象包含以下示例中显示的数据。

```
{
    "eventType": "TEXT_SUCCESSFUL",
    "eventVersion": "1.0",
    "eventTimestamp": 1686975103470,
    "isFinal": true,
    "originationPhoneNumber": "+12065550152",
    "destinationPhoneNumber": "+14255550156",
    "isInternationalSend": false,
    "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 |  事件类型。值列在 [短信、彩信和语音的事件类型](configuration-sets-event-types.md) 中  | 
| eventVersion |  事件 JSON 架构的版本。  | 
| eventTimestamp | 报告事件的时间，显示为以毫秒为单位的 Unix 时间。 | 
| isFinal | 如果此为消息的最终状态，则为 True。有中间消息状态，可能需要长达 72 小时才能收到最终消息状态。 | 
| originationPhoneNumber | 用于发送消息的电话号码。 | 
| destinationPhoneNumber | 尝试将消息发送到的电话号码。 | 
| isInternationalSend | 如果此电话号码启用了国际消息收发功能，则为 True。 | 
| isoCountryCode | 与接收人的电话号码关联的国家，按 ISO 3166-1 alpha-2 格式显示。 | 
| mcc | 移动国家/地区代码用于标识电话号码所属的国家/地区。此字段为可选字段，可能不存在。 | 
| mnc | 移动网络代码用于标识移动网络运营商。此字段为可选字段，可能不存在。 | 
| messageId |  AWS 最终用户消息 SMS 在接受消息时生成的唯一 ID。 | 
| messageRequestTimestamp | 接收短信请求的时间，显示为以毫秒为单位的 Unix 时间。 | 
| messageEncoding | 消息的编码。可能的值为 GSM 和 Unicode。有关消息编码的更多信息，请参阅[短信字符限制](sms-limitations-character.md)。 | 
| messageType | 消息类型。可能的值为 Promotional 和 Transactional。 | 
| messageStatus |  消息的状态。可能的值有： [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/sms-voice/latest/userguide/configuration-sets-event-format.html)  | 
| messageStatusDescription | 消息状态的描述。 | 
| context | 您可以指定并将在您发送消息时被记录的自定义属性。 | 
| totalMessageParts |   AWS 最终用户消息 SMS 为发送消息而创建的消息部分的数量。 通常，短信只能包含 160 个 GSM-7 字符或 67 个非 GSM 字符，但这些限制会因国家而异。如果您发送的消息超过了这些限制，则 AWS 最终用户消息短信会自动将消息拆分为较小的部分。我们根据您发送的消息部分数量收取费用。有关消息部分的更多信息，请参阅[每秒消息部分数（MPS）限制是什么](sms-limitations-mps.md)。  | 
| totalMessagePrice | 我们向您收取的发送消息的费用。此价格以千分之一美分显示。例如，如果此属性的值为 645，则我们收取的消息发送单价是 0.645¢ (645 / 1000 = 0.645¢ = \$10.00645)。 | 
| totalCarrierFee | 消息的运营商费用总成本。 | 

## 短信保护示例日志
<a name="configuration-sets-event-format-sms-protect-example"></a>

使用[短信保护](protect.md)时，短信事件的 JSON 对象包含以下示例中显示的数据。

```
{
    "eventType": "TEXT_PROTECT_BLOCKED",
    "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": "PROTECT_BLOCKED",
    "messageStatusDescription": "Message blocked by protect configuration",
    "context": {
        "account": "bar"
    },
    "totalMessageParts": 1,
    "totalMessagePrice": 0,
    "totalCarrierFee": 0, 
    "protectConfiguration": {  
        "protectConfigurationId": "protect-d777777777777771bbd5d59f4d903479", 
        "protectStatus": "FILTER" 
    }, 
    "protectConfigurationAssessment": { 
        "protectRecommendation": "BLOCK"
         "protectInsights": { 
            "blockReason": "AIT_SUSPECTED" 
         }
         
    }
}
```


****  

| 属性 | 说明 | 
| --- | --- | 
| eventType |  事件类型。值列在 [短信、彩信和语音的事件类型](configuration-sets-event-types.md) 中  | 
| eventVersion |  事件 JSON 架构的版本。  | 
| eventTimestamp | 报告事件的时间，显示为以毫秒为单位的 Unix 时间。 | 
| isFinal | 如果此为消息的最终状态，则为 True。有中间消息状态，可能需要长达 72 小时才能收到最终消息状态。 | 
| originationPhoneNumber | 用于发送消息的电话号码。 | 
| destinationPhoneNumber | 尝试将消息发送到的电话号码。 | 
| isoCountryCode | 与接收人的电话号码关联的国家，按 ISO 3166-1 alpha-2 格式显示。 | 
| mcc | 移动国家/地区代码用于标识电话号码所属的国家/地区。此字段为可选字段，可能不存在。 | 
| mnc | 移动网络代码用于标识移动网络运营商。此字段为可选字段，可能不存在。 | 
| messageId |  AWS 最终用户消息 SMS 在接受消息时生成的唯一 ID。 | 
| messageRequestTimestamp | 接收短信请求的时间，显示为以毫秒为单位的 Unix 时间。 | 
| messageEncoding | 消息的编码。可能的值为 GSM 和 Unicode。有关消息编码的更多信息，请参阅[短信字符限制](sms-limitations-character.md)。 | 
| messageType | 消息类型。可能的值为 Promotional 和 Transactional。 | 
| messageStatus |  消息的状态。可能的值有： [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/sms-voice/latest/userguide/configuration-sets-event-format.html)  | 
| messageStatusDescription | 消息状态的描述。 | 
| context | 您可以指定并将在您发送消息时被记录的自定义属性。 | 
| totalMessageParts |   AWS 最终用户消息 SMS 为发送消息而创建的消息部分的数量。 通常，短信只能包含 160 个 GSM-7 字符或 67 个非 GSM 字符，但这些限制会因国家而异。如果您发送的消息超过了这些限制，则 AWS 最终用户消息短信会自动将消息拆分为较小的部分。我们根据您发送的消息部分数量收取费用。有关消息部分的更多信息，请参阅[每秒消息部分数（MPS）限制是什么](sms-limitations-mps.md)。  | 
| totalMessagePrice | 我们向您收取的发送消息的费用。此价格以千分之一美分显示。例如，如果此属性的值为 645，则我们收取的消息发送单价是 0.645¢ (645 / 1000 = 0.645¢ = \$10.00645)。 | 
| totalCarrierFee | 消息的运营商费用总成本。 | 
| protectConfiguration | 发送消息时使用的保护配置的 ID 以及目标国家/地区当时的状态。有关短信保护的更多信息，请参阅[短信保护](protect.md)。 | 
| protectConfigurationAssessment | 评估短信保护认为您的消息应允许发送还是阻止发送，并提供阻止原因（如果有）。 | 

## 语音示例事件日志
<a name="configuration-sets-event-format-voice-example"></a>

语音事件的 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 |  事件类型。值列在 [短信、彩信和语音的事件类型](configuration-sets-event-types.md) 中  | 
| eventVersion |  事件 JSON 架构的版本。  | 
| eventTimestamp | 报告事件的时间，显示为以毫秒为单位的 Unix 时间。 | 
| isFinal | 如果此为消息的最终状态，则为 True。有中间消息状态。 | 
| originationPhoneNumber | 用于发送消息的电话号码。 | 
| destinationPhoneNumber | 尝试将消息发送到的电话号码。 | 
| isoCountryCode | 与接收人的电话号码关联的国家，按 ISO 3166-1 alpha-2 格式显示。 | 
| messageId |  AWS 最终用户消息 SMS 在接受消息时生成的唯一 ID。 | 
| messageRequestTimestamp | 接收短信请求的时间，显示为以毫秒为单位的 Unix 时间。 | 
| messageStatus |  消息的状态。可能的值有： [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/sms-voice/latest/userguide/configuration-sets-event-format.html)  | 
| callDurationInSeconds | 通话持续时间（以秒为单位）。 | 
| totalDurationInMinutes | 通话持续时间（以分钟为单位）。 | 
| totalMessagePrice | 我们向您收取的发送语音消息的费用。此价格以千分之一美分显示。 | 
| context | 您可以指定并将在您发送消息时被记录的自定义属性。 | 

## 彩信示例日志
<a name="configuration-sets-event-format-mms-example"></a>

彩信事件的 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 |  事件类型。值列在 [短信、彩信和语音的事件类型](configuration-sets-event-types.md) 中  | 
| eventVersion |  事件 JSON 架构的版本。  | 
| eventTimestamp | 报告事件的时间，显示为以毫秒为单位的 Unix 时间。 | 
| isFinal | 如果此为消息的最终状态，则为 True。有中间消息状态，可能需要长达 72 小时才能收到最终消息状态。 | 
| originationPhoneNumber | 用于发送消息的电话号码。 | 
| destinationPhoneNumber | 尝试将消息发送到的电话号码。 | 
| isoCountryCode | 与接收人的电话号码关联的国家，按 ISO 3166-1 alpha-2 格式显示。 | 
| messageId |  AWS 最终用户消息 SMS 在接受消息时生成的唯一 ID。 | 
| messageRequestTimestamp | 接收短信请求的时间，显示为以毫秒为单位的 Unix 时间。 | 
| messageType | 消息类型。可能的值为 Promotional 和 Transactional。 | 
| messageStatus |  消息的状态。可能的值有： [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/sms-voice/latest/userguide/configuration-sets-event-format.html)  | 
| messageStatusDescription | 消息状态的描述。 | 
| context | 您可以指定并将在您发送消息时被记录的自定义属性。 | 
| totalMessageParts |   AWS 最终用户消息 SMS 为发送消息而创建的消息部分的数量。有关消息部分的更多信息，请参阅[每秒消息部分数（MPS）限制是什么](sms-limitations-mps.md)。   | 
| totalMessagePrice | 我们向您收取的发送消息的费用。此价格以千分之一美分显示。例如，如果此属性的值为 645，则我们收取的消息发送单价是 0.645¢ (645 / 1000 = 0.645¢ = \$10.00645)。 | 
| totalCarrierFee | 消息的运营商费用总成本。 |