翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# AWS エンドユーザーメッセージング SMS イベントデータの例
AWS エンドユーザーメッセージング SMS は、SMS、MMS、および音声メッセージ配信のイベントデータをストリーミングできます。通信事業者が生成したイベントは、受信されるまでに最大 72 時間かかることがあるため、送信メッセージの配信に遅延があるかどうかを判断するのには使用しないでください。72 時間後、 AWS エンドユーザーメッセージング SMS がキャリアから最終イベントを受信していない場合、そのメッセージに何が起こったかわからない`UNKNOWN``messageStatus`ため、サービスは自動的に を返します。
**Topics**
+ [SMS サンプルログ](#configuration-sets-event-format-sms-example)
+ [SMS Protect のサンプルログ](#configuration-sets-event-format-sms-protect-example)
+ [音声イベントログの例](#configuration-sets-event-format-voice-example)
+ [MMS サンプルログ](#configuration-sets-event-format-mms-example)
## 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、音声のイベントタイプ](configuration-sets-event-types.md)」に記載されています。 |
| 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 と Unicode です。メッセージのエンコードの詳細については、「[SMS 文字制限](sms-limitations-character.md)」を参照してください。 |
| messageType | メッセージのタイプ。指定できる値は、Promotional および Transactionalです。 |
| messageStatus | メッセージのステータス。可能な値は以下のとおりです。[See the AWS documentation website for more details](http://docs.aws.amazon.com/ja_jp/sms-voice/latest/userguide/configuration-sets-event-format.html) |
| messageStatusDescription | メッセージステータスの説明。 |
| context | カスタム属性を指定でき、メッセージを送信するとログに記録されます。 |
| totalMessageParts | メッセージを送信するために AWS エンドユーザーメッセージング SMS が作成したメッセージパートの数。
通常、SMS メッセージには GSM-7 文字 160 文字または非 GSM 文字 67 文字のみを含めることができますが、これらの制限は国によって異なる場合があります。これらの制限を超えるメッセージを送信すると、 AWS End User Messaging SMS は自動的にメッセージを小さな部分に分割します。送信したメッセージパートの数に基づいて請求されます。メッセージパーツの詳細については、「[メッセージパーツ/秒 (MPS) の制限とは](sms-limitations-mps.md)」を参照してください。 |
| totalMessagePrice | メッセージの送信に課金された金額。この価格は、米ドルセントの 1000 分の 1 で示されます。例えば、この属性の値が 645 の場合、メッセージの送信に 0.645¢ が課金されます (645 / 1000 = 0.645¢ = $0.00645)。 |
| totalCarrierFee | メッセージに対する通信事業者料金の総額。 |
## SMS Protect のサンプルログ
[SMS Protect](protect.md) を使用した場合の 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、音声のイベントタイプ](configuration-sets-event-types.md)」に記載されています。 |
| 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 と Unicode です。メッセージのエンコードの詳細については、「[SMS 文字制限](sms-limitations-character.md)」を参照してください。 |
| messageType | メッセージのタイプ。指定できる値は、Promotional および Transactionalです。 |
| messageStatus | メッセージのステータス。可能な値は以下のとおりです。[See the AWS documentation website for more details](http://docs.aws.amazon.com/ja_jp/sms-voice/latest/userguide/configuration-sets-event-format.html) |
| messageStatusDescription | メッセージステータスの説明。 |
| context | カスタム属性を指定でき、メッセージを送信するとログに記録されます。 |
| totalMessageParts | メッセージを送信するために AWS エンドユーザーメッセージング SMS が作成したメッセージパートの数。
通常、SMS メッセージには GSM-7 文字 160 文字または非 GSM 文字 67 文字のみを含めることができますが、これらの制限は国によって異なる場合があります。これらの制限を超えるメッセージを送信すると、 AWS End User Messaging SMS は自動的にメッセージを小さな部分に分割します。送信したメッセージパートの数に基づいて請求されます。メッセージパーツの詳細については、「[メッセージパーツ/秒 (MPS) の制限とは](sms-limitations-mps.md)」を参照してください。 |
| totalMessagePrice | メッセージの送信に課金された金額。この価格は、米ドルセントの 1000 分の 1 で示されます。例えば、この属性の値が 645 の場合、メッセージの送信に 0.645¢ が課金されます (645 / 1000 = 0.645¢ = $0.00645)。 |
| totalCarrierFee | メッセージに対する通信事業者料金の総額。 |
| protectConfiguration | メッセージの送信時に使用された保護設定の ID と、その時点での送信先の国のステータス。SMS Protect の詳細については、「[SMS Protect](protect.md)」を参照してください。 |
| protectConfigurationAssessment | SMS Protect がメッセージの送信を許可またはブロックすべきと判断するかどうかの評価と、可能な場合はブロックの理由。 |
## 音声イベントログの例
音声イベントの 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、音声のイベントタイプ](configuration-sets-event-types.md)」に記載されています。 |
| 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 | メッセージのステータス。可能な値は以下のとおりです。[See the AWS documentation website for more details](http://docs.aws.amazon.com/ja_jp/sms-voice/latest/userguide/configuration-sets-event-format.html) |
| 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、音声のイベントタイプ](configuration-sets-event-types.md)」に記載されています。 |
| 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 | メッセージのステータス。可能な値は以下のとおりです。[See the AWS documentation website for more details](http://docs.aws.amazon.com/ja_jp/sms-voice/latest/userguide/configuration-sets-event-format.html) |
| messageStatusDescription | メッセージステータスの説明。 |
| context | カスタム属性を指定でき、メッセージを送信するとログに記録されます。 |
| totalMessageParts | メッセージを送信するために AWS エンドユーザーメッセージング SMS が作成したメッセージパートの数。メッセージパーツの詳細については、「[メッセージパーツ/秒 (MPS) の制限とは](sms-limitations-mps.md)」を参照してください。
|
| totalMessagePrice | メッセージの送信に課金された金額。この価格は、米ドルセントの 1000 分の 1 で示されます。例えば、この属性の値が 645 の場合、メッセージの送信に 0.645¢ が課金されます (645 / 1000 = 0.645¢ = $0.00645)。 |
| totalCarrierFee | メッセージに対する通信事業者料金の総額。 |