AWS エンドユーザーメッセージング SMS イベントデータの例

AWS エンドユーザーメッセージング SMS は、SMS、MMS、および音声メッセージ配信のイベントデータをストリーミングできます。通信事業者が生成したイベントは、受信されるまでに最大 72 時間かかることがあるため、送信メッセージの配信に遅延があるかどうかを判断するのには使用しないでください。72 時間後、 AWS エンドユーザーメッセージング SMS がキャリアから最終イベントを受信していない場合、そのメッセージに何が起こったかわからないUNKNOWNmessageStatusため、サービスは自動的に を返します。

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 Protect のサンプルログ

SMS Protect を使用した場合の 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 電話番号またはショートコードの場合、メッセージは (直接または RCS フォールバック後に) SMS 経由で配信されました。RCS フォールバック動作の詳細については、「」を参照してください電話プールを使用した RCS から SMS へのフォールバック。