View a markdown version of this page

メッセージごとの SMS または MMS フォールバックの設定 - AWS エンドユーザーメッセージング SMS

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

メッセージごとの SMS または MMS フォールバックの設定

RCS メッセージを送信すると、受信者のデバイスが RCS をサポートしていないか、配信前にメッセージの有効期限が切れる可能性があります。メッセージごとのフォールバックでは、RCS メッセージが受信者に到達できない場合にAWSエンドユーザーメッセージングが自動的に配信する代替 SMS または MMS コンテンツを指定できます。FallbackConfiguration パラメータを含めることで、各SendRcsMessageリクエストのフォールバックを設定します。

フォールバックトリガーの場合

AWSエンドユーザーメッセージングは、次の 2 つの状況でフォールバックメッセージをトリガーします。

  • 即時 RCS 失敗: 受信者のデバイスまたはキャリアが RCS をサポートしていないか、RCS チャネルがメッセージを拒否します。

  • TTL の有効期限: TimeToLive値を設定すると、タイマーの有効期限が切れる前にメッセージが配信されません。メッセージの有効期限の詳細については、「」を参照してくださいRCS メッセージの有効期限の設定

リクエストFallbackConfigurationに を含めず、RCS メッセージが失敗または期限切れになった場合、フォールバックメッセージは送信されません。

プールベースのフォールバックと比較したメッセージごとのフォールバック

でのメッセージごとのフォールバックは、 で使用できる自動プールベースのフォールバックSendRcsMessageとは異なりますSendTextMessage。プールベースのフォールバックの詳細については、「」を参照してください電話プールを使用した RCS から SMS へのフォールバック

フォールバックメカニズムの比較
機能 プールベースのフォールバック (SendTextMessage) メッセージごとのフォールバック (SendRcsMessage)
設定 プールに RCS エージェントと SMS ID の両方が含まれている場合、自動 明示的: 各リクエストFallbackConfigurationに含める
フォールバックチャネル SMS (プールで選択) SMS または MMS ( で選択Channel)
フォールバックコンテンツ 同じメッセージ本文 SMS または MMS 用にカスタマイズされた個別のコンテンツを提供する
ID の選択 プールは発信元 ID を選択します 電話番号または送信者 ID を指定する
Trigger トリガー) RCS はサポートされていません (タイムアウトベース) RCS の即時失敗または TTL の有効期限

FallbackConfiguration 構造

FallbackConfiguration パラメータは、SendRcsMessageリクエストの単一のオブジェクトです。フォールバックが SMS か MMS かを示すように Channel フィールドを設定し、対応するコンテンツフィールドを指定します。

FallbackConfiguration フィールド
フィールド Type 必須 説明
Channel 文字列 はい フォールバックチャネル。有効な値: SMS または MMS
MessageBody String 条件付き フォールバックメッセージのテキスト本文。最大 1,600 文字。Channel が の場合は必須ですSMS。の場合MMS、少なくとも 1 つの MessageBodyまたは を指定MediaUrlsする必要があります。
MediaUrls 文字列のリスト 条件付き MMS フォールバックの 1 つ以上のメディア URLs。の場合MMS、少なくとも 1 つの MessageBodyまたは を指定MediaUrlsする必要があります。
OriginationIdentity String 条件付き フォールバックメッセージの発信元 ID。電話番号または送信者 ID (値、ID、または ARN) を受け入れます。プールまたは RCS エージェントを指定することはできません。このフィールドを省略し、元のメッセージがプールを介して送信された場合、サービスはそのプールから適切な数を選択します。
重要

フォールバックMessageBody制限は 1,600 文字です。これは、RCS TextMessage本文の 3,072 文字の制限よりも短くなります。SMS または MMS 文字の制約に収まるようにフォールバックコンテンツを作成します。

次の JSON は、SMS フォールバックのFallbackConfigurationオブジェクトの構造を示しています。

{ "Channel": "SMS", "MessageBody": "Your order has shipped. Track at https://example.com/track/12345", "OriginationIdentity": "+18005550199" }

次の JSON は、MMS フォールバックの構造を示しています。

{ "Channel": "MMS", "MessageBody": "Your order has shipped.", "MediaUrls": ["https://cdn.example.com/shipping-confirmation.jpg"], "OriginationIdentity": "+18005550199" }

SMS フォールバックの設定

SMS にフォールバックするには、 Channelを に設定SMSし、 を指定しますMessageBody。SMS は提案チップやリッチカードをサポートしていないため、重要な URLs をメッセージ本文にプレーンテキストとして含めます。

MMS フォールバックの設定

MMS にフォールバックするには、 Channelを に設定MMSし、 で 1 つ以上のメディア URLs を指定しますMediaUrls。RCS メッセージにビジュアルコンテンツ (イメージを含むリッチカードなど) が含まれており、RCS をサポートしていない受信者のビジュアルエクスペリエンスを維持したい場合は、MMS フォールバックを使用します。

フォールバックとメッセージの有効期限の組み合わせ

リクエストFallbackConfigurationTimeToLiveと の両方を設定すると、AWSEnd User Messaging は TTL の期間中に RCS 配信を試みます。タイマーの有効期限が切れる前にメッセージが配信されない場合、サービスはフォールバックメッセージを送信します。このパターンは、ワンタイムパスワードや予約リマインダーなどの時間的制約のあるコンテンツに役立ちます。

メッセージの有効期限の設定の詳細については、「」を参照してくださいRCS メッセージの有効期限の設定

次の例では、SMS フォールバックで 60 秒の TTL を設定します。

{ "DestinationPhoneNumber": "+12065550100", "OriginationIdentity": "rcs-agent-1234567890", "RcsMessageContent": "{\"Content\":{\"TextMessage\":{\"Body\":\"Your verification code is 483291.\"}}}", "TimeToLive": 60, "FallbackConfiguration": { "Channel": "SMS", "MessageBody": "Your verification code is 483291.", "OriginationIdentity": "+18005550199" } }

ベストプラクティス

  • フォールバックコンテンツを個別に書き込みます。リッチ RCS コンテンツ (サジェストチップ、リッチカード、カルーセル) は SMS や MMS に直接翻訳されません。RCS 本文を逐語的に再利用するのではなく、簡潔で自己完結型のフォールバックメッセージを記述します。

  • SMS フォールバックに URL をプレーンテキストとして含めURLs。インタラクティブ提案チップ (OpenUrlアクションなど) を のインライン URLs に置き換えますMessageBody

  • ビジュアルコンテンツには MMS フォールバックを使用します。RCS メッセージにイメージを含むリッチカードまたはカルーセルが含まれている場合、MMS フォールバックは RCS サポートのない受信者のビジュアルコンテキストを保持します。

  • 妥当な TTL を設定します。フォールバックを と組み合わせるときはTimeToLive、配信試行とタイムラインのバランスを取る TTL を選択します。時間的制約のあるメッセージの場合、TTL が 30~60 秒の場合、フォールバックする前に短い RCS 配信ウィンドウが表示されます。一般的なメッセージの場合、ウィンドウが長い (数分から数時間) と、RCS チャネルが成功する機会が増えます。

  • 送信元 ID を確認します。フォールバック設定OriginationIdentityの は、AWSエンドユーザーメッセージングアカウントに登録され、送信先国に SMS または MMS を送信できる電話番号または送信者 ID である必要があります。