AWS 最終使用者簡訊 SMS 事件資料範例

AWS 最終使用者傳訊簡訊可以串流 SMS、MS 和語音訊息交付的事件資料。由於接收電信業者產生的事件最多可能需要 72 小時，因此您不應該使用這些事件來判斷傳出訊息傳遞是否有延遲。72 小時後，如果 AWS 最終使用者簡訊簡訊尚未收到電信業者的最終事件，服務會自動傳回 ，UNKNOWNmessageStatus因為我們不知道該訊息發生了什麼事。

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 電話號碼或短碼，訊息會透過 SMS 傳遞 （直接或在 RCS 後退）。如需 RCS 備用行為的詳細資訊，請參閱 使用電話集區的 RCS 到 SMS 備用。