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
}

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" 
         }
         
    }
}

음성 예제 이벤트 로그

음성 이벤트에 대한 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"
    }
}

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
}

RCS 예제 로그

RCS 이벤트의 JSON 객체에는 다음 예제에 표시된 데이터가 포함됩니다. originationPhoneNumber 필드는 메시지가 RCS를 통해 기본적으로 전달되었는지 아니면 SMS로 다시 전달되었는지에 따라 달라집니다.

RCS 네이티브 전송 - originationPhoneNumber 필드에는 RCS 에이전트 ID가 포함됩니다.

{
    "eventType": "TEXT_SUCCESSFUL",
    "eventVersion": "1.0",
    "eventTimestamp": 1714000000000,
    "isFinal": true,
    "originationPhoneNumber": "rcs-agent-id-example",
    "destinationPhoneNumber": "+14255550156",
    "isInternationalSend": false,
    "messageId": "a1b2c3d4-e5f6-7890-abcd-ef1234example",
    "messageRequestTimestamp": 1714000000000,
    "messageType": "TRANSACTIONAL",
    "messageStatus": "SUCCESSFUL",
    "messageStatusDescription": "Message has been accepted by phone carrier",
    "totalMessageParts": 1,
    "totalMessagePrice": 0.003,
    "totalCarrierFee": 0.0
}

SMS 대체 전송 - originationPhoneNumber 필드에는 SMS 전송에 사용되는 E.164 전화번호 또는 단축 코드가 포함됩니다.

{
    "eventType": "TEXT_SUCCESSFUL",
    "eventVersion": "1.0",
    "eventTimestamp": 1714000000000,
    "isFinal": true,
    "originationPhoneNumber": "+12065550152",
    "destinationPhoneNumber": "+14255550156",
    "isInternationalSend": false,
    "messageId": "b2c3d4e5-f6a7-8901-bcde-f12345example",
    "messageRequestTimestamp": 1714000000000,
    "messageType": "TRANSACTIONAL",
    "messageStatus": "SUCCESSFUL",
    "messageStatusDescription": "Message has been accepted by phone carrier",
    "totalMessageParts": 1,
    "totalMessagePrice": 0.00645,
    "totalCarrierFee": 0.0
}

전송 채널을 확인하려면 originationPhoneNumber 필드를 검사합니다. 값이 RCS 에이전트 ID인 경우 메시지는 RCS를 통해 전송되었습니다. 값이 E.164 전화번호 또는 단축 코드인 경우 SMS를 통해(직접 또는 RCS 대체 후) 메시지가 전송되었습니다. RCS 폴백 동작에 대한 자세한 내용은 섹션을 참조하세요전화 풀을 사용한 RCS에서 SMS로의 대체.