View a markdown version of this page

コンソールからリッチ RCS メッセージを送信する - AWSエンドユーザーメッセージング SMS

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

コンソールからリッチ RCS メッセージを送信する

AWSエンドユーザーメッセージングコンソールには、コードを記述せずにリッチ RCS メッセージを構築および送信するために使用できるビジュアルメッセージコンポーザーが用意されています。コンポーザーは SendRcsMessage API に直接マッピングされ、テキストメッセージ、ファイルメッセージ、リッチカード、カルーセルなどのすべてのコンテンツタイプをサポートします。インタラクティブな提案を任意のメッセージタイプにアタッチし、time-to-live (TTL) 設定を設定し、デバイスが RCS をサポートしていない受信者の SMS または MMS フォールバックを設定できます。

RCS テストインターフェイスのアウトバウンドテストメッセージタブからリッチメッセージを作成して送信します。API をSendRcsMessageアプリケーションに統合する前にレンダリングと配信を検証できるように、メッセージは検証済みの RBM テスターに送信されます。

メッセージを設定すると、リアルタイムの電話プレビューに、受信者のデバイスでのメッセージのレンダリング方法が表示されます。同等の JSON ペイロードまたは AWSCLI コマンドをコピーして、アプリケーションコードで同じメッセージ構造を使用することもできます。

メッセージタイプとその API 構造の詳細については、「」を参照してくださいリッチ RCS メッセージを送信する。提案のタイプと動作の詳細については、「」を参照してくださいRCS の提案の設定

前提条件

コンソールからリッチ RCS メッセージを送信する前に、以下を確認してください。

  • RCS エージェントはテスト中またはアクティブ状態です。

  • エージェントに関連付けられている検証済み RBM テスターの電話番号が少なくとも 1 つあります。セットアップ手順については、「RCS メッセージのテスト」を参照してください。

  • Amazon S3 からメディアファイルを送信する予定の場合、S3 バケットにはsms-voice.amazonaws.com読み取りアクセスを許可するバケットポリシーが必要です。詳細については、「RCS ファイルメッセージの送信」を参照してください。

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

次の手順を使用して、AWSエンドユーザーメッセージングコンソールからリッチ RCS メッセージを構成して送信します。

  1. でAWSエンドユーザーメッセージングコンソールを開きますhttps://console.aws.amazon.com/sms-voice/

  2. ナビゲーションペインの設定で、RCS エージェントを選択します。

  3. 発信元 ID として使用するエージェントを選択します。エージェントのステータスは、テスト中またはアクティブである必要があります。

  4. テストタブを選択します。

  5. RCS テストインターフェイスで、アウトバウンドテストメッセージタブを選択します。

  6. 「テスト RCS メッセージの送信」セクションの「RBM テスターの選択」で、検証済みの RBM テスターの電話番号を選択します。

  7. (オプション) 設定セットで、メッセージイベントを追跡する設定セットを選択します。

  8. Select API で、SendRcsMessage を選択します。

  9. メッセージ形式の選択 で、送信するメッセージタイプを選択します。

    • テキスト: メッセージ本文を入力します (最大 3,072 文字)。

    • ファイル: メディアソースで、S3 バケットまたはパブリック URL を選択し、送信するファイルの S3 URI (または HTTPS URL) を入力します。S3 の参照を選択してバケットからファイルを選択するか、ビューを選択して新しいブラウザタブで参照ファイルを開きます。 ファイルの最大サイズは 100 MB です。必要に応じて、動画または PDF ファイルのサムネイル URL を指定します。

    • リッチカード: 次のカードフィールドを設定します。タイトル、説明、またはメディアの少なくとも 1 つが必要です。

      • カード向き: VERTICALまたは を選択しますHORIZONTAL

      • カードタイトル: タイトル (最大 200 文字) を入力します。

      • カードの説明: 説明を入力します (最大 2,000 文字)。

      • メディア URL: メディアソースで、S3 バケットまたはパブリック URL を選択し、S3 URI (または HTTPS URL) を入力します。S3 を参照を選択してファイルを選択するか、表示を選択して新しいブラウザタブで開きます。 ファイルの最大サイズは 100 MB です。

      • (オプション) メディアサムネイル URL: メディア全ロードの前に表示されるプレビューイメージ。

      • (水平方向のみ) サムネイルの配置: サムネイル画像を配置RIGHTするには、 LEFTまたは を選択します。

      • カード提案: カード境界内でボタンとしてレンダリングする提案を最大 4 つ追加します。提案タイプについては、「」を参照してくださいRCS の提案の設定

    • カルーセル: 以下を設定します。

      • カードの幅: SMALLまたは を選択しますMEDIUM

      • メディアの高さ (すべてのカード): SHORTまたは を選択しますMEDIUM。カルーセル内のすべてのカードは、同じメディアの高さを使用します。

      • カード: 2~10 個のカードを追加します。各カードには、カードタイトル、カードの説明、メディア URL (S3 バケットまたはパブリック URL、最大 100 MB)、および最大 4 つのカード提案が含まれます。カードごとに少なくとも 1 つのタイトル、説明、またはメディアが必要です。

    • JSON: raw RcsMessageContent JSON ペイロードを直接貼り付けます。JSON 形式 を選択してペイロードをフォーマットします。コンソールは構造を検証し、電話プレビューをリアルタイムで更新します。

  10. (オプション) S3 ブラウザを使用してメディアファイルを設定します。

    1. [S3 を参照] を選択します。

    2. ドロップダウンリストからバケットを選択します。

    3. プレフィックス (フォルダ) を移動してファイルを見つけます。

    4. ファイルを選択します。URL フィールドは自動的に入力されます。

    注記

    S3 バケットには、オブジェクトへのsms-voice.amazonaws.com読み取りアクセスを許可するバケットポリシーが必要です。必要なポリシーについては、「」を参照してくださいRCS ファイルメッセージの送信

  11. (オプション) メッセージレベルの提案を追加します。「提案」セクションで、次の操作を行います。

    1. 提案の追加を選択します。

    2. 提案タイプで、返信オープン URLダイヤルフォン場所の表示リクエストの場所カレンダーイベントのいずれかを選択します。

    3. 選択したタイプの必須フィールドを入力します。すべての提案タイプには、Text値 (最大 25 文字) と PostbackData (最大 2,048 文字) が必要です。

    4. 繰り返して、最大 11 個のメッセージレベルの提案を追加します。

    メッセージレベルの提案は、メッセージ全体の下にチップリストとしてレンダリングされます。メッセージレベルの提案は、任意のコンテンツタイプ (テキスト、ファイル、リッチカード、カルーセル) にアタッチできます。詳細については、「RCS の提案の設定」を参照してください。

  12. (オプション) time-to-live (TTL) を設定します。詳細オプションを展開し、有効期限 (秒) フィールドに値を入力します。有効な値は 1~172,800 秒 (48 時間) です。最小値は 10 秒にすることをお勧めします。

    TTL の有効期限が切れる前にメッセージが配信されない場合、サービスは TTL の有効期限イベントをトリガーします。フォールバックを設定した場合、その時点でフォールバックメッセージが表示されます。

    Advanced options セクションには、Max price (USD)Dry runMessage feedbackProtect configuration、および Context (オプションのキーと値のメタデータ) も含まれています。

  13. (オプション) SMS または MMS フォールバックを設定します。フォールバック設定セクションを展開します。

    1. フォールバックチャネルでは、SMS または MMS を選択します。

    2. フォールバックメッセージ本文には、メッセージテキスト (最大 1,600 文字) を入力します。フォールバックチャネルが選択されている場合、メッセージ本文が必要です。

    3. MMS では、1 つ以上のメディア URLsを指定することもできます。

    4. 送信元 ID には、フォールバック SMS または MMS メッセージに使用する電話番号または送信者 ID を入力します。これは、RCS エージェントから を送信するときに必要です。

    フォールバックは、メッセージが RCS 経由で配信できない場合 (受信者のデバイスが RCS をサポートしていない場合や TTL の有効期限が切れた場合など) にトリガーされます。詳細については、「リッチ RCS メッセージを送信する」を参照してください。

  14. (オプション) 詳細オプションで、Dry run を有効にして、送信せずにメッセージ構造を検証します。これは料金を発生させず、受信者にメッセージを配信しません。

  15. コンポーザーの右側にある電話プレビューを確認します。プレビューはリアルタイムで更新され、以下が表示されます。

    • コンテンツのレンダリング (テキスト、メディア、カードレイアウト、カルーセルスクロール)

    • メッセージの下に提案チップ

    • カード内のカードレベルのボタン

    注記

    プレビューは Android レンダリングに近似します。iOS または他の RCS クライアントの表示は異なる場合があります。プレビューでは、提案の選択動作はシミュレートされません。

  16. テストメッセージを送信を選択して、選択した RBM テスターにメッセージを送信するか、次のいずれかのオプションを使用します。

    • JSON のコピー: メッセージ JSON をクリップボードにコピーします。RcsMessageContent を選択してコンテンツ部分のみをコピーするか、Full API リクエストを選択してSendRcsMessageリクエスト本文全体をコピーします。

    • CLI コマンドをコピーする: 同等のaws pinpoint-sms-voice-v2 send-rcs-messageコマンドをコピーします。

入力の検証

コンソールは、メッセージを設定するときにリアルタイム検証を実行します。検証エラーは、影響を受けるフィールドの横にインラインで表示されます。次の表は、検証ルールをまとめたものです。

コンソール検証ルール
フィールド ルール
Phone number (電話番号) E.164 形式である必要があります
メディア URL https:// または で始まる必要があります s3://
メディアファイルサイズ 最大 100 MB
提案テキスト 最大 25 文字
ポストバックデータ 最大 2,048 文字
カードタイトル 最大 200 文字
カードの説明 最大 2,000 文字
カルーセルカード 最小 2、最大 10
カードレベルの提案 カードあたり最大 4
メッセージレベルの提案 最大 11
テキストメッセージ本文 最大 3,072 文字
TTL 1~172,800 秒
フォールバックメッセージ本文 最大 1,600 文字