View a markdown version of this page

リッチ RCS メッセージを送信する - AWS エンドユーザーメッセージング SMS
前提条件SendTextMessage と SendRcsMessage の選択コンテンツタイプ提案SendRcsMessage リクエストの概要メッセージのサイズと数の制限配信イベントと受信者アクションベストプラクティス

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

リッチ RCS メッセージを送信する

AWSエンドユーザーメッセージングの SendRcsMessage API アクションを使用すると、リッチでインタラクティブなコンテンツを RCS (リッチコミュニケーションサービス) 経由で受信者に送信できます。リッチ RCS メッセージはプレーンテキストにとどまらず、リッチカード、カルーセル、メディアファイル、受信者がアクションを実行することを選択する提案が含まれます。これらのインタラクティブな要素は、一方向の通知を双方向の会話体験に変換します。例えば、受信者が予約を確認したり、製品カタログを閲覧したり、会話を離れずに場所を共有したりできます。

イメージとアクションボタン付きの製品カード、カレンダーの提案による予約確認、添付ファイル、受信者がスクロールする複数アイテムのカルーセルなど、視覚的にリッチでインタラクティブなコンテンツを配信SendRcsMessageする必要がある場合に使用します。各SendRcsMessageリクエストには、テキストコンテンツごとに個別のテキスト本文が含まれ、デバイスが RCS をサポートしていない受信者のオプションの SMS または MMS フォールバックを含めることができます。

リッチフォーマットを必要としないプレーンテキストメッセージの場合は、代わりに SendTextMessage API アクションを使用します。 はテキストコンテンツのみSendTextMessageを受け入れるため、リクエストがよりシンプルになり、受信者機能に基づいて RCS と SMS を自動的に選択するメッセージングプールで動作します。詳細については、「RCS メッセージの送信」を参照してください。

重要

RCS メッセージングは、RCS がサポートされているSendRcsMessageすべての国で で使用できます。現在のリストについては、「」を参照してくださいRCS でサポートされている国。

トピック

前提条件

リッチ RCS メッセージを送信する前に、 の RCS セットアップステップを完了しますRCS の使用を開始する。Active 状態の登録済み AWS RCS エージェントに加えて、以下を確認します。

  • 本番環境の受信者に送信する前にリッチコンテンツを検証するには、登録済みのテストデバイスをテストエージェントに追加し、テストメッセージを送信します。詳細については、「RCS メッセージのテスト」を参照してください。

  • 配信ステータスイベントを受信するようにイベント送信先 (Amazon SNS トピックまたは Amazon Data Firehose 配信ストリーム) を設定します。受信者の選択はポストバックイベントとしてアプリケーションに配信されるため、メッセージに提案などのインタラクティブな要素が含まれている場合は、イベント送信先が必要です。詳細については、「AWS エンドユーザーメッセージング SMS のイベント送信先」を参照してください。

  • SMS または MMS フォールバックを設定し、SMS ポンプのリスクがある送信先に送信する場合は、保護設定を関連付けて、オプトアウトルールと国ルールをフォールバックメッセージに適用します。詳細については、「AWS エンドユーザーメッセージング SMS での不正保護」を参照してください。

SendTextMessage と SendRcsMessage の選択

どちらの API アクションも RCS 経由でメッセージを配信できますが、目的は異なります。 SendTextMessage は、すべてのメッセージが SMS として配信可能であり、RCS 経由で配信できるため、リクエスト契約がよりシンプルになります。 はリッチ RCS コンテンツをSendRcsMessage引き受け、メディアや構造化コンテンツタイプ、time-to-live (TTL) によるメッセージの有効期限、メッセージごとの SMS または MMS フォールバックなど、 SendTextMessage にない機能を追加します。

SendRcsMessage と比較した SendTextMessage SendRcsMessage
機能 SendTextMessage SendRcsMessage
メッセージの内容 プレーンテキストのみ テキスト、ファイル、リッチカード、カルーセル。それぞれにオプションの提案があります。
配信チャネル RCS または SMS RCS、オプションの SMS または MMS フォールバック付き
チャネルの選択 プールは、受信者機能によって RCS または SMS を自動的に選択します 最初に RCS、次に設定された SMS または MMS フォールバック
Fallback (フォールバック) 自動、プールベース メッセージあたりの明示的な
発信元 ID プール、電話番号、送信者 ID、または AWS RCS エージェント プールまたは AWS RCS エージェント
メッセージの有効期限 (TTL) いいえ はい
契約をリクエストする よりシンプルに。SMS および MMS 送信と同じ API 個別のテキスト本文とコンテンツタイプを持つ専用 RCS API

SendTextMessage プレーンテキスト通知、プールベースの自動チャネル選択、または最小限のコード変更で既存の SMS ワークフローを移行する場合に選択します。リッチカード、カルーセル、メディアファイル、または提案SendRcsMessageが必要な場合、メッセージごとのフォールバックを定義する場合、または時間的制約のあるコンテンツに TTL ベースの有効期限が必要な場合に選択します。

コンテンツタイプ

RcsMessageContent パラメータには、コンテンツタイプが 1 つだけのContentオブジェクトと、オプションのメッセージレベルSuggestionsリストが含まれます。1 つのリクエストで複数のコンテンツタイプを組み合わせることはできません。

RCS コンテンツタイプ
コンテンツタイプ 説明 詳細情報
TextMessage 最大 3,072 文字のテキスト本文とオプションの候補。SMS メッセージとは異なり、RCS テキストメッセージには提案を含めることができ、セグメントに分割されるのではなく、単一のメッセージとして配信されます。 RCS テキストメッセージの送信
FileMessage HTTPS または Amazon S3 URL によって参照される単一のメディアファイル (イメージ、動画、オーディオ、PDF)。 RCS ファイルメッセージの送信
RichCard オプションのメディア、タイトル、説明、最大 4 つの提案を含む構造化カード。 RCS リッチカードの送信
カルーセル スクロール可能な 2～10 枚のカードセット。それぞれに独自のメディア、テキスト、提案があります。 RCS カルーセルの送信

提案

提案は、受信者がアクションを実行することを選択するインタラクティブなチップです。任意のコンテンツタイプに提案を追加できます。メッセージレベルの提案はメッセージ全体に適用され (最大 11)、カードレベルの提案は個々のリッチカードまたはカルーセルカードに適用されます (最大 4)。AWSエンドユーザーメッセージングは、返信、リンク、電話番号のダイヤルや場所の共有などのアクションを含む 6 つの提案タイプをサポートしています。提案タイプ、そのパラメータ、および提案タップの受信方法の完全なリストについては、「」を参照してくださいRCS の提案の設定。

SendRcsMessage リクエストの概要

SendRcsMessage リクエストでは、次のキーパラメータを使用します。

キー SendRcsMessage パラメータ
[Parameter] (パラメータ) [Required] (必須) 説明
DestinationPhoneNumber はい E.164 形式の受信者の電話番号。例: +12065550100。
OriginationIdentity はい 送信元のプールまたは AWS RCS エージェントの ID または ARN。エージェントはアクティブ状態である必要があります。
RcsMessageContent いいえ メッセージの内容。、TextMessage、FileMessage、RichCardまたは のいずれか 1 つだけを含むContentオブジェクトとCarousel、オプションのトップレベルSuggestionsリストが含まれます。
FallbackConfiguration いいえ RCS 配信が成功しなかった場合に送信する SMS または MMS メッセージ。必須 Channel (SMS または MMS)MessageBody、、MMS MediaUrlsのオプション、電話番号または送信者 ID OriginationIdentityである が含まれます。
TimeToLive いいえ メッセージが配信されない場合にメッセージが期限切れになるまでの秒単位の時間。最小は 1 秒、最大は 172,800 秒 (48 時間) です。10 秒以上の値をお勧めします。
MessageFeedbackEnabled いいえ に設定するとtrue、メッセージのメッセージフィードバックが有効になります。受信者がメッセージを受信したら、 PutMessageFeedbackオペレーションを呼び出してメッセージのステータスを更新します。

正常なレスポンスは、配信ステータスイベントの関連付けMessageIdに使用する を返します。

注記

のフォールバックSendRcsMessageは、 を介したメッセージごとに設定されますFallbackConfiguration。完全なフォールバック動作については、「」を参照してくださいメッセージごとの SMS または MMS フォールバックの設定。

メッセージのサイズと数の制限

RCS メッセージの制限
制限 値
テキストメッセージ本文3,072 文字
リッチカードのタイトル200 文字
リッチカードの説明2,000 文字
メディアファイルサイズ100 MB
メディア URL の長さ2,000 文字
メッセージあたりの提案11
カードあたりの提案4
提案表示テキスト25 文字
ポストバックデータ2,048 文字
カルーセルカード2～10 カード
Time-to-live1 秒～172,800 秒 (48 時間)

すべてのコンテンツタイプの RCS の制限と制限については、「」を参照してくださいメッセージングの制限と制限。

配信イベントと受信者アクション

AWSエンドユーザーメッセージングは、配信、読み取り、失敗、期限切れ、ポストバックイベントなど、メッセージの配信ステータスと受信者アクションを報告するイベントを生成します。受信者が提案を選択し、PostbackData値を含めると、ポストバックイベントが生成されます。これらのイベントを Amazon SNS トピック、Amazon Data Firehose 配信ストリーム、または Amazon CloudWatch Logs にルーティングします。詳細については、「RCS メッセージイベント」を参照してください。

ベストプラクティス

豊富な RCS メッセージを会話型のインタラクティブなエクスペリエンスとして設計します。ワンタイムパスワードなどの時間的制約のあるコンテンツTimeToLiveには を設定し、デバイスが RCS をサポートしていない場合でも受信者に到達する必要があるメッセージの SMS または MMS フォールバックを設定し、提案ラベルを短く保ち (制限は 25 文字）、構造化識別子を に含めPostbackDataて、アプリケーションが追加のルックアップなしでレスポンスをルーティングできるようにします。詳細なガイダンスについては、「」を参照してくださいRCS のベストプラクティス。