AWS End User Messaging SMS 이벤트 데이터의 예 - AWS 최종 사용자 메시징 SMS
SMS 예제 로그SMS 보호 예제 로그음성 예제 이벤트 로그MMS 예제 로그

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

AWS End User Messaging SMS 이벤트 데이터의 예

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

SMS 예제 로그

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 및 음성에 대한 이벤트 유형에 나열되어 있습니다.
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 문자 수 한도 섹션을 참조하세요.
messageType 메시지 유형. 가능한 값은 Promotional 및 Transactional입니다.
messageStatus

메시지의 상태입니다. 가능한 값은 다음과 같습니다.

  • SUCCESSFUL - 이동통신사에서 메시지를 수락했습니다.

  • DELIVERED - 수신자의 디바이스에서 메시지를 수락했습니다.

  • PENDING - 메시지가 아직 수신자의 디바이스로 전송되지 않았습니다.

  • INVALID - 대상 전화번호가 잘못되었습니다.

  • UNREACHABLE - 수신자의 디바이스가 현재 연결할 수 없거나 사용할 수 없습니다. 예를 들어, 디바이스의 전원이 꺼져 있거나 네트워크와의 연결이 끊어졌을 수 있습니다. 나중에 메시지 전송을 다시 시도할 수 있습니다.

  • UNKNOWN - 메시지 전송을 방해하는 오류가 발생했습니다. 이 오류는 일반적으로 일시적이며 나중에 메시지 전송을 다시 시도할 수 있습니다.

  • BLOCKED - 수신자의 디바이스가 발신자 전화번호로부터 발신되는 SMS 메시지를 차단하고 있습니다.

  • CARRIER_UNREACHABLE - 수신자의 모바일 네트워크 문제로 인해 메시지가 전송되지 않았습니다. 이 오류는 일반적으로 일시적이며 나중에 메시지 전송을 다시 시도할 수 있습니다.

  • SPAM - 수신자의 통신사에서 메시지의 콘텐츠를 스팸으로 식별하여 메시지 전송을 차단했습니다.

  • INVALID_MESSAGE - SMS 메시지 본문이 잘못되어 전송할 수 없습니다.

  • CARRIER_BLOCKED - 수신자의 이동통신사에서 이 메시지 전송을 차단했습니다. 이는 이동통신사에서 메시지 콘텐츠를 원치 않는 메시지 또는 악성 메시지로 식별할 때 종종 발생합니다.

  • TTL_EXPIRED - 특정 시간 내에 SMS 메시지를 전송할 수 없었습니다. 이 오류는 일반적으로 일시적이며 나중에 메시지 전송을 다시 시도할 수 있습니다.

  • ACCEPTED - SMS 메시지가 수락되었습니다.

  • FAILED - SMS 메시지가 수신자의 디바이스로 전송되지 않았습니다.

  • SENT - 메시지가 전송되었지만 수신자의 디바이스로 전송되지 않았습니다.

  • UNROUTABLE - 잘못된 계정 구성으로 인해 라우팅할 수 없습니다.

  • QUEUED - 전송할 메시지가 대기열에 있습니다.

  • PROTECT_BLOCKED - SMS 보호 규칙에 의해 SMS 메시지가 차단되었습니다.
messageStatusDescription 메시지 상태에 대한 설명입니다.
context 메시지를 보낼 때 지정할 수 있고 로깅되는 사용자 지정 속성입니다.
totalMessageParts

AWS End User Messaging SMS가 메시지를 전송하기 위해 생성한 메시지 파트 수입니다.

일반적으로 SMS 메시지는 160개의 GSM-7 문자 또는 67개의 비GSM 문자만 포함할 수 있지만 이러한 한도는 국가 에 따라 다를 수 있습니다. 이 한도를 초과하는 메시지를 전송하면 AWS End User Messaging SMS에서 자동으로 메시지를 더 작게 분할합니다. 전송하는 메시지 파트 수에 따라 요금이 청구됩니다. 메시지 파트에 관한 자세한 내용은 초당 메시지 파트(MPS) 한도의 의미를 참조하세요.
totalMessagePrice 메시지 전송에 대해 청구된 금액입니다. 이 가격은 미국 센트의 1/1000로 표시됩니다. 예를 들어 이 속성의 값이 645인 경우, 메시지 전송에 대해 0.645¢가 청구된 것입니다(645 / 1000 = 0.645¢ = $0.00645).
totalCarrierFee 메시지에 대한 통신사 수수료의 총 비용입니다.

SMS 보호 예제 로그

SMS 보호를 이용할 때 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 및 음성에 대한 이벤트 유형에 나열되어 있습니다.
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 문자 수 한도 섹션을 참조하세요.
messageType 메시지 유형. 가능한 값은 Promotional 및 Transactional입니다.
messageStatus

메시지의 상태입니다. 가능한 값은 다음과 같습니다.

  • SUCCESSFUL - 이동통신사에서 메시지를 수락했습니다.

  • DELIVERED - 수신자의 디바이스에서 메시지를 수락했습니다.

  • PENDING - 메시지가 아직 수신자의 디바이스로 전송되지 않았습니다.

  • INVALID - 대상 전화번호가 잘못되었습니다.

  • UNREACHABLE - 수신자의 디바이스가 현재 연결할 수 없거나 사용할 수 없습니다. 예를 들어, 디바이스의 전원이 꺼져 있거나 네트워크와의 연결이 끊어졌을 수 있습니다. 나중에 메시지 전송을 다시 시도할 수 있습니다.

  • UNKNOWN - 메시지 전송을 방해하는 오류가 발생했습니다. 이 오류는 일반적으로 일시적이며 나중에 메시지 전송을 다시 시도할 수 있습니다.

  • BLOCKED - 수신자의 디바이스가 발신자 전화번호로부터 발신되는 SMS 메시지를 차단하고 있습니다.

  • CARRIER_UNREACHABLE - 수신자의 모바일 네트워크 문제로 인해 메시지가 전송되지 않았습니다. 이 오류는 일반적으로 일시적이며 나중에 메시지 전송을 다시 시도할 수 있습니다.

  • SPAM - 수신자의 통신사에서 메시지의 콘텐츠를 스팸으로 식별하여 메시지 전송을 차단했습니다.

  • INVALID_MESSAGE - SMS 메시지 본문이 잘못되어 전송할 수 없습니다.

  • CARRIER_BLOCKED - 수신자의 이동통신사에서 이 메시지 전송을 차단했습니다. 이는 이동통신사에서 메시지 콘텐츠를 원치 않는 메시지 또는 악성 메시지로 식별할 때 종종 발생합니다.

  • TTL_EXPIRED - 특정 시간 내에 SMS 메시지를 전송할 수 없었습니다. 이 오류는 일반적으로 일시적이며 나중에 메시지 전송을 다시 시도할 수 있습니다.

  • ACCEPTED - SMS 메시지가 수락되었습니다.

  • FAILED - SMS 메시지가 수신자의 디바이스로 전송되지 않았습니다.

  • SENT - 메시지가 전송되었지만 수신자의 디바이스로 전송되지 않았습니다.

  • UNROUTABLE - 잘못된 계정 구성으로 인해 라우팅할 수 없습니다.

  • QUEUED - 전송할 메시지가 대기열에 있습니다.

  • PROTECT_BLOCKED - SMS 보호 규칙에 의해 SMS 메시지가 차단되었습니다.
messageStatusDescription 메시지 상태에 대한 설명입니다.
context 메시지를 보낼 때 지정할 수 있고 로깅되는 사용자 지정 속성입니다.
totalMessageParts

AWS End User Messaging SMS가 메시지를 전송하기 위해 생성한 메시지 파트 수입니다.

일반적으로 SMS 메시지는 160개의 GSM-7 문자 또는 67개의 비GSM 문자만 포함할 수 있지만 이러한 한도는 국가 에 따라 다를 수 있습니다. 이 한도를 초과하는 메시지를 전송하면 AWS End User Messaging SMS에서 자동으로 메시지를 더 작게 분할합니다. 전송하는 메시지 파트 수에 따라 요금이 청구됩니다. 메시지 파트에 관한 자세한 내용은 초당 메시지 파트(MPS) 한도의 의미를 참조하세요.
totalMessagePrice 메시지 전송에 대해 청구된 금액입니다. 이 가격은 미국 센트의 1/1000로 표시됩니다. 예를 들어 이 속성의 값이 645인 경우, 메시지 전송에 대해 0.645¢가 청구된 것입니다(645 / 1000 = 0.645¢ = $0.00645).
totalCarrierFee 메시지에 대한 통신사 수수료의 총 비용입니다.
protectConfiguration 메시지를 보낼 때 사용된 보호 구성의 ID와 대상 국가가 당시에 있었던 상태입니다. SMS 보호에 관한 자세한 내용은 SMS 보호를 참조하세요.
protectConfigurationAssessment SMS 보호가 메시지 전송이 허용되어야 하는지 차단되어야 하는지 여부와 가능한 경우 차단 이유에 대한 평가입니다.

음성 예제 이벤트 로그

음성 이벤트에 대한 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 및 음성에 대한 이벤트 유형에 나열되어 있습니다.
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

메시지의 상태입니다. 가능한 값은 다음과 같습니다.

  • INITIATED - 음성 메시지가 다이얼링을 시작할 준비가 되었습니다.

  • RINGING - 벨소리 이벤트는 전화가 연결된 후 수신자가 응답하기 전에 발생합니다.

  • COMPLETED - 음성 메시지의 모든 완료 이벤트를 지정된 대상으로 보냅니다. 완료 이벤트는 오디오 메시지가 수신자에게 재생되면 발생합니다. 이 상태가 반드시 메시지가 수신자에게 전달되었음을 의미하지는 않습니다. 예를 들어, 메시지가 음성 메일 시스템으로 전송되었음을 나타낼 수 있습니다.

  • ANSWERED - 응답 이벤트는 수신자가 전화를 받으면 발생합니다.

  • COMPLETED - 호출이 응답되고 종료되었습니다.

  • BUSY - 통화 중 이벤트는 수신자의 전화선이 통화 중이면 발생합니다.

  • NO_ANSWER - 응답 없음 이벤트는 전화가 연결되었지만 수신자(또는 음성 메일 시스템)가 응답하지 않으면 발생합니다.

  • FAILED - 실패 이벤트는 메시지 전송에 실패하면 발생합니다.

  • TTL_EXPIRED - TTL 만료 이벤트는 메시지 전송에 필요한 시간이 메시지를 전송할 때 지정한 TTL 값을 초과하면 발생합니다.

  • SPAM - 통화가 스팸으로 표시되고 차단되었습니다.

  • PROTECT_BLOCKED - SMS 보호 규칙에 의해 SMS 메시지가 차단되었습니다.
callDurationInSeconds 통화 시간(초)입니다.
totalDurationInMinutes 통화 시간(분)입니다.
totalMessagePrice 음성 메시지 전송에 대해 청구된 금액입니다. 이 가격은 미국 센트의 1/1000로 표시됩니다.
context 메시지를 보낼 때 지정할 수 있고 로깅되는 사용자 지정 속성입니다.

MMS 예제 로그

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 및 음성에 대한 이벤트 유형에 나열되어 있습니다.
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

메시지의 상태입니다. 가능한 값은 다음과 같습니다.

  • SUCCESSFUL - 이동통신사에서 메시지를 수락했습니다.

  • DELIVERED - 수신자의 디바이스에서 메시지를 수락했습니다.

  • PENDING - 메시지가 아직 수신자의 디바이스로 전송되지 않았습니다.

  • INVALID - 대상 전화번호가 잘못되었습니다.

  • UNREACHABLE - 수신자의 디바이스가 현재 연결할 수 없거나 사용할 수 없습니다. 예를 들어, 디바이스의 전원이 꺼져 있거나 네트워크와의 연결이 끊어졌을 수 있습니다. 나중에 메시지 전송을 다시 시도할 수 있습니다.

  • UNKNOWN - 메시지 전송을 방해하는 오류가 발생했습니다. 이 오류는 일반적으로 일시적이며 나중에 메시지 전송을 다시 시도할 수 있습니다.

  • BLOCKED - 수신자의 디바이스가 발신 번호로부터의 SMS/MMS 메시지를 차단하고 있습니다.

  • CARRIER_UNREACHABLE - 수신자의 모바일 네트워크 문제로 인해 메시지가 전송되지 않았습니다. 이 오류는 일반적으로 일시적이며 나중에 메시지 전송을 다시 시도할 수 있습니다.

  • SPAM - 수신자의 통신사에서 메시지의 콘텐츠를 스팸으로 식별하여 메시지 전송을 차단했습니다.

  • INVALID_MESSAGE - SMS/MMS 메시지 본문이 잘못되어 전송할 수 없습니다.

  • CARRIER_BLOCKED - 수신자의 이동통신사에서 이 메시지 전송을 차단했습니다. 이는 이동통신사에서 메시지 콘텐츠를 원치 않는 메시지 또는 악성 메시지로 식별할 때 종종 발생합니다.

  • TTL_EXPIRED - 특정 시간 내에 SMS 메시지를 전송할 수 없었습니다. 이 오류는 일반적으로 일시적이며 나중에 메시지 전송을 다시 시도할 수 있습니다.

  • ACCEPTED - SMS 메시지가 수락되었습니다.

  • FAILED - SMS 메시지가 수신자의 디바이스로 전송되지 않았습니다.

  • SENT - 메시지가 전송되었지만 수신자의 디바이스로 전송되지 않았습니다.

  • UNROUTABLE - 잘못된 계정 구성으로 인해 라우팅할 수 없습니다.

  • QUEUED - 전송할 메시지가 대기열에 있습니다.
messageStatusDescription 메시지 상태에 대한 설명입니다.
context 메시지를 보낼 때 지정할 수 있고 로깅되는 사용자 지정 속성입니다.
totalMessageParts

AWS End User Messaging SMS가 메시지를 전송하기 위해 생성한 메시지 파트 수입니다. 메시지 파트에 관한 자세한 내용은 초당 메시지 파트(MPS) 한도의 의미를 참조하세요.
totalMessagePrice 메시지 전송에 대해 청구된 금액입니다. 이 가격은 미국 센트의 1/1000로 표시됩니다. 예를 들어 이 속성의 값이 645인 경우, 메시지 전송에 대해 0.645¢가 청구된 것입니다(645 / 1000 = 0.645¢ = $0.00645).
totalCarrierFee 메시지에 대한 통신사 수수료의 총 비용입니다.