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

フォーカスモード

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

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

SMS サンプルログ

SMS イベントの JSON オブジェクトには以下の例に示されているデータが含まれています。



{
    "eventType": "TEXT_SUCCESSFUL",
    "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": "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`	メッセージを送信しようとした電話番号。
`isoCountryCode`	受信者の電話番号に関連付けられている国 (ISO 3166-1 alpha-2 形式で表示)。
`mcc`	Mobile Country Codes は、電話番号が属する国を識別します。このフィールドはオプションであり、存在しない場合があります。
`mnc`	モバイルネットワークコードは、モバイルネットワークオペレーターを識別します。このフィールドはオプションであり、存在しない場合があります。
`messageId`	AWS End User Messaging SMS がメッセージを受け入れるときに生成する一意の ID。
`messageRequestTimestamp`	SMS メッセージリクエストが受信された時刻。Unix 時間としてミリ秒単位で表示されます。
`messageEncoding`	メッセージのエンコード。指定できる値は GSM と Unicode です。メッセージエンコードの詳細については、「」を参照してくださいSMS 文字制限。
`messageType`	メッセージのタイプ。指定できる値は、Promotional および Transactionalです。
`messageStatus`	メッセージのステータス。可能な値は以下のとおりです。成功 – メッセージは電話キャリアによって受け入れられました。 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 – メッセージは配信キューに入れられます
`messageStatusDescription`	メッセージステータスの説明。
`context`	カスタム属性を指定でき、メッセージを送信するとログに記録されます。
`totalMessageParts`	メッセージを送信するために AWS End User Messaging SMS が作成したメッセージパートの数。通常、SMS メッセージには GSM-7 文字 160 文字または非 GSM 文字 67 文字のみを含めることができますが、これらの制限は国によって異なる場合があります。これらの制限を超えるメッセージを送信すると、 AWS End User Messaging SMS は自動的にメッセージを小さな部分に分割します。送信したメッセージパートの数に基づいて請求されます。メッセージパートの詳細については、「」を参照してくださいMessage Parts Per Second (MPS) の制限とは。
`totalMessagePrice`	メッセージの送信に課金された金額。この価格は、米ドルセントの 1000 分の 1 で示されます。例えば、この属性の値が `645` の場合、メッセージの送信に 0.645¢ が課金されます (645 / 1000 = 0.645¢ = $0.00645)。
`totalCarrierFee`	メッセージに対する通信事業者料金の合計コスト。

音声イベントログの例

Voice イベントの 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 – 音声メッセージについて完了したすべてのイベントを、指定された送信先に送信します。完了イベントは、音声メッセージが受信者に対して再生されたときに発生します。この状態は、メッセージが必ずしも受信者に配信されたことを意味するわけではありません。例えば、メッセージがボイスメールシステムに配信されたことを示す場合があります。応答済み – 応答イベントは、受信者が電話に応答したときに発生します。 COMPLETED – 通話は応答され、終了しました。 BUSY – ビジーイベントは、受信者の電話回線がビジー状態のときに発生します。 NO_ANSWER – 通話が行われた後に応答イベントは発生しませんが、受信者 (またはボイスメールシステム) は応答しません。 FAILED – 障害イベントは、メッセージの配信に失敗したときに発生します。 TTL_EXPIRED – TTL 期限切れイベントは、メッセージの配信に必要な時間が、メッセージを送信したときに指定した`TTL`値を超えたときに発生します。 SPAM – 呼び出しはスパムとしてマークされ、ブロックされました。
`callDurationInSeconds`	呼び出しの時間を秒単位で表します。
`totalDurationInMinutes`	通話の時間を分単位で表します。
`totalMessagePrice`	音声メッセージを送信するために請求した金額。この価格は、米ドルセントの 1000 分の 1 で示されます。
`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`	メッセージのステータス。可能な値は以下のとおりです。成功 – メッセージは電話キャリアによって受け入れられました。 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 が作成したメッセージパートの数。メッセージパートの詳細については、「」を参照してくださいMessage Parts Per Second (MPS) の制限とは。
`totalMessagePrice`	メッセージの送信に課金された金額。この価格は、米ドルセントの 1000 分の 1 で示されます。例えば、この属性の値が `645` の場合、メッセージの送信に 0.645¢ が課金されます (645 / 1000 = 0.645¢ = $0.00645)。
`totalCarrierFee`	メッセージに対する通信事業者料金の合計コスト。

ブラウザで JavaScript が無効になっているか、使用できません。

AWS ドキュメントを使用するには、JavaScript を有効にする必要があります。手順については、使用するブラウザのヘルプページを参照してください。

ドキュメントの表記規則

イベントタイプ

Amazon CloudWatch イベント送信先を設定する

このページの内容

Cookie の設定を選択する

Cookie の設定をカスタマイズする

Essential

Performance

Functional

Advertising

Cookie の設定を保存できません

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

SMS サンプルログ

音声イベントログの例

MMS サンプルログ

このページの内容

このページは役に立ちましたか?

次のトピック

前のトピック:

ヘルプが必要ですか?