기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# AWS End User Messaging SMS 이벤트 데이터 예제
<a name="configuration-sets-event-format"></a>

AWS End User Messaging SMS는 SMS, MMS 및 음성 메시지 전송에 대한 이벤트 데이터를 스트리밍할 수 있습니다. 통신사에서 생성한 이벤트는 수신될 때까지 최대 72시간이 걸릴 수 있으므로 아웃바운드 메시지 전송의 지연 여부를 판단하는 데 사용해서는 안 됩니다. 72시간 후 AWS End User Messaging SMS가 통신 사업자로부터 최종 이벤트를 수신하지 못한 경우 해당 메시지에 어떤 일이 발생했는지 알 수 `UNKNOWN` `messageStatus` 없으므로 서비스는 자동으로를 반환합니다.

**Topics**
+ [SMS 예제 로그](#configuration-sets-event-format-sms-example)
+ [SMS 보호 예제 로그](#configuration-sets-event-format-sms-protect-example)
+ [음성 예제 이벤트 로그](#configuration-sets-event-format-voice-example)
+ [MMS 예제 로그](#configuration-sets-event-format-mms-example)

## SMS 예제 로그
<a name="configuration-sets-event-format-sms-example"></a>

SMS 이벤트에 대한 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 |  이벤트의 유형입니다. 값은 [SMS, MMS 및 음성에 대한 이벤트 유형](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 End User Messaging SMS가 생성하는 고유 ID입니다. | 
| messageRequestTimestamp | SMS 메시지 요청이 수신된 시간입니다(밀리초 단위 Unix 시간). | 
| messageEncoding | 메시지의 인코딩입니다. 가능한 값은 GSM 및 유니코드입니다. 메시지 인코딩에 관한 자세한 내용은 [SMS 문자 수 한도](sms-limitations-character.md) 섹션을 참조하세요. | 
| messageType | 메시지 유형. 가능한 값은 Promotional 및 Transactional입니다. | 
| messageStatus |  메시지의 상태입니다. 가능한 값은 다음과 같습니다. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/sms-voice/latest/userguide/configuration-sets-event-format.html)  | 
| messageStatusDescription | 메시지 상태에 대한 설명입니다. | 
| context | 메시지를 보낼 때 지정할 수 있고 로깅되는 사용자 지정 속성입니다. | 
| totalMessageParts |  메시지를 보내기 위해 AWS End User Messaging SMS가 생성한 메시지 부분의 수입니다. 일반적으로 SMS 메시지는 160개의 GSM-7 문자 또는 67개의 비GSM 문자만 포함할 수 있지만 이러한 한도는 국가 에 따라 다를 수 있습니다. 이러한 제한을 초과하는 메시지를 보내면 AWS End User Messaging SMS가 자동으로 메시지를 더 작은 부분으로 분할합니다. 전송하는 메시지 파트 수에 따라 요금이 청구됩니다. 메시지 파트에 관한 자세한 내용은 [초당 메시지 파트(MPS) 한도의 의미](sms-limitations-mps.md)를 참조하세요.  | 
| totalMessagePrice | 메시지 전송에 대해 청구된 금액입니다. 이 가격은 미국 센트의 1/1000로 표시됩니다. 예를 들어 이 속성의 값이 645인 경우, 메시지 전송에 대해 0.645¢가 청구된 것입니다(645 / 1000 = 0.645¢ = \$10.00645). | 
| totalCarrierFee | 메시지에 대한 통신사 수수료의 총 비용입니다. | 

## SMS 보호 예제 로그
<a name="configuration-sets-event-format-sms-protect-example"></a>

[SMS 보호](protect.md)를 이용할 때 SMS 이벤트에 대한 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 |  이벤트의 유형입니다. 값은 [SMS, MMS 및 음성에 대한 이벤트 유형](configuration-sets-event-types.md)에 나열되어 있습니다.  | 
| eventVersion |  이벤트 JSON 스키마의 버전입니다.  | 
| eventTimestamp | 이벤트가 보고된 시간입니다(밀리초 단위 Unix 시간). | 
| isFinal | 메시지의 최종 상태인 경우, True입니다. 중간 메시지 상태가 있으며 최종 메시지 상태가 수신되는 데 최대 72시간이 걸릴 수 있습니다. | 
| originationPhoneNumber | 메시지를 전송한 전화 번호입니다. | 
| destinationPhoneNumber | 메시지 전송을 시도한 전화 번호입니다. | 
| isoCountryCode | 수신자의 전화 번호와 관련된 국가 이며, ISO 3166-1 alpha-2 형식으로 표시됩니다. | 
| mcc | 휴대폰 국가 코드는 전화번호가 속한 국가를 식별합니다. 이 필드는 선택 사항이며 존재하지 않을 수 있습니다. | 
| mnc | 모바일 네트워크 코드는 모바일 네트워크 운영자를 식별합니다. 이 필드는 선택 사항이며 존재하지 않을 수 있습니다. | 
| messageId | 메시지를 수락할 때 AWS End User Messaging SMS가 생성하는 고유 ID입니다. | 
| messageRequestTimestamp | SMS 메시지 요청이 수신된 시간입니다(밀리초 단위 Unix 시간). | 
| messageEncoding | 메시지의 인코딩입니다. 가능한 값은 GSM 및 유니코드입니다. 메시지 인코딩에 관한 자세한 내용은 [SMS 문자 수 한도](sms-limitations-character.md) 섹션을 참조하세요. | 
| messageType | 메시지 유형. 가능한 값은 Promotional 및 Transactional입니다. | 
| messageStatus |  메시지의 상태입니다. 가능한 값은 다음과 같습니다. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/sms-voice/latest/userguide/configuration-sets-event-format.html)  | 
| messageStatusDescription | 메시지 상태에 대한 설명입니다. | 
| context | 메시지를 보낼 때 지정할 수 있고 로깅되는 사용자 지정 속성입니다. | 
| totalMessageParts |  메시지를 보내기 위해 AWS End User Messaging SMS가 생성한 메시지 부분의 수입니다. 일반적으로 SMS 메시지는 160개의 GSM-7 문자 또는 67개의 비GSM 문자만 포함할 수 있지만 이러한 한도는 국가 에 따라 다를 수 있습니다. 이러한 제한을 초과하는 메시지를 보내면 AWS End User Messaging SMS가 자동으로 메시지를 더 작은 부분으로 분할합니다. 전송하는 메시지 파트 수에 따라 요금이 청구됩니다. 메시지 파트에 관한 자세한 내용은 [초당 메시지 파트(MPS) 한도의 의미](sms-limitations-mps.md)를 참조하세요.  | 
| totalMessagePrice | 메시지 전송에 대해 청구된 금액입니다. 이 가격은 미국 센트의 1/1000로 표시됩니다. 예를 들어 이 속성의 값이 645인 경우, 메시지 전송에 대해 0.645¢가 청구된 것입니다(645 / 1000 = 0.645¢ = \$10.00645). | 
| totalCarrierFee | 메시지에 대한 통신사 수수료의 총 비용입니다. | 
| protectConfiguration | 메시지를 보낼 때 사용된 보호 구성의 ID와 대상 국가가 당시에 있었던 상태입니다. SMS 보호에 관한 자세한 내용은 [SMS 보호](protect.md)를 참조하세요. | 
| protectConfigurationAssessment | SMS 보호가 메시지 전송이 허용되어야 하는지 차단되어야 하는지 여부와 가능한 경우 차단 이유에 대한 평가입니다. | 

## 음성 예제 이벤트 로그
<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 |  이벤트의 유형입니다. 값은 [SMS, MMS 및 음성에 대한 이벤트 유형](configuration-sets-event-types.md)에 나열되어 있습니다.  | 
| eventVersion |  이벤트 JSON 스키마의 버전입니다.  | 
| eventTimestamp | 이벤트가 보고된 시간입니다(밀리초 단위 Unix 시간). | 
| isFinal | 메시지의 최종 상태인 경우, True입니다. 중간 메시지 상태가 있습니다. | 
| originationPhoneNumber | 메시지를 전송한 전화 번호입니다. | 
| destinationPhoneNumber | 메시지 전송을 시도한 전화 번호입니다. | 
| isoCountryCode | 수신자의 전화 번호와 관련된 국가 이며, ISO 3166-1 alpha-2 형식으로 표시됩니다. | 
| messageId | 메시지를 수락할 때 AWS End User Messaging SMS가 생성하는 고유 ID입니다. | 
| messageRequestTimestamp | SMS 메시지 요청이 수신된 시간입니다(밀리초 단위 Unix 시간). | 
| messageStatus |  메시지의 상태입니다. 가능한 값은 다음과 같습니다. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/sms-voice/latest/userguide/configuration-sets-event-format.html)  | 
| callDurationInSeconds | 통화 시간(초)입니다. | 
| totalDurationInMinutes | 통화 시간(분)입니다. | 
| totalMessagePrice | 음성 메시지 전송에 대해 청구된 금액입니다. 이 가격은 미국 센트의 1/1000로 표시됩니다. | 
| context | 메시지를 보낼 때 지정할 수 있고 로깅되는 사용자 지정 속성입니다. | 

## MMS 예제 로그
<a name="configuration-sets-event-format-mms-example"></a>

MMS 이벤트에 대한 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 |  이벤트의 유형입니다. 값은 [SMS, MMS 및 음성에 대한 이벤트 유형](configuration-sets-event-types.md)에 나열되어 있습니다.  | 
| eventVersion |  이벤트 JSON 스키마의 버전입니다.  | 
| eventTimestamp | 이벤트가 보고된 시간입니다(밀리초 단위 Unix 시간). | 
| isFinal | 메시지의 최종 상태인 경우, True입니다. 중간 메시지 상태가 있으며 최종 메시지 상태가 수신되는 데 최대 72시간이 걸릴 수 있습니다. | 
| originationPhoneNumber | 메시지를 전송한 전화 번호입니다. | 
| destinationPhoneNumber | 메시지 전송을 시도한 전화 번호입니다. | 
| isoCountryCode | 수신자의 전화 번호와 관련된 국가 이며, ISO 3166-1 alpha-2 형식으로 표시됩니다. | 
| messageId | 메시지를 수락할 때 AWS End User Messaging SMS가 생성하는 고유 ID입니다. | 
| messageRequestTimestamp | SMS 메시지 요청이 수신된 시간입니다(밀리초 단위 Unix 시간). | 
| messageType | 메시지 유형. 가능한 값은 Promotional 및 Transactional입니다. | 
| messageStatus |  메시지의 상태입니다. 가능한 값은 다음과 같습니다. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/sms-voice/latest/userguide/configuration-sets-event-format.html)  | 
| messageStatusDescription | 메시지 상태에 대한 설명입니다. | 
| context | 메시지를 보낼 때 지정할 수 있고 로깅되는 사용자 지정 속성입니다. | 
| totalMessageParts |  메시지를 보내기 위해 AWS End User Messaging SMS가 생성한 메시지 부분의 수입니다. 메시지 파트에 관한 자세한 내용은 [초당 메시지 파트(MPS) 한도의 의미](sms-limitations-mps.md)를 참조하세요.   | 
| totalMessagePrice | 메시지 전송에 대해 청구된 금액입니다. 이 가격은 미국 센트의 1/1000로 표시됩니다. 예를 들어 이 속성의 값이 645인 경우, 메시지 전송에 대해 0.645¢가 청구된 것입니다(645 / 1000 = 0.645¢ = \$10.00645). | 
| totalCarrierFee | 메시지에 대한 통신사 수수료의 총 비용입니다. |