View a markdown version of this page

RCS テキストメッセージの送信 - AWS エンドユーザーメッセージング SMS
RCS テキストメッセージと SMS の違いテキストメッセージの RcsMessageContent 構造テキストメッセージの送信SMS または MMS フォールバックテキストメッセージの制限テキストメッセージを使用するタイミング

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

RCS テキストメッセージの送信

TextMessage は、 SendRcsMessage API で送信できる最もシンプルなコンテンツタイプです。メッセージの下にインタラクティブボタンとして表示されるオプションの提案チップを含むプレーンテキストの本文 (最大 3,072 文字) で構成されます。

RCS テキストメッセージと SMS の違い

を介して送信されるテキストメッセージは、 SendTextMessage (SMS) を介して送信されるテキストメッセージとは 2 つの点でSendRcsMessage異なります。

  • 提案チップ: RCS テキストメッセージには最大 11 個の提案チップをアタッチできます。これらのチップを使用すると、受信者は返信、URL を開く、電話番号をダイヤルする、場所を共有する、またはカレンダーイベントを 1 つのステップで作成できます。SMS は提案をサポートしていません。

  • シングルメッセージ配信: RCS テキストメッセージは、長さ (最大 3,072 文字) に関係なく、単一のメッセージとして到着します。キャリアは 160 文字を超える SMS メッセージを複数のセグメントに分割します。このセグメントは順不同で到着したり、セグメント間で遅延が発生する可能性があります。

使用可能なすべての提案タイプとそのパラメータの詳細については、「」を参照してくださいRCS の提案の設定。

テキストメッセージの RcsMessageContent 構造

を呼び出すとSendRcsMessage、メッセージペイロードを RcsMessageContentパラメータとして渡します。テキストメッセージの場合は、 ContentフィールドをBody文字列を含むTextMessageオブジェクトに設定します。提案チップを含めるには、Suggestions配列を の最上位の兄弟として追加しますContent。

次の JSON スニペットは、提案を含むテキストメッセージRcsMessageContentの の構造を示しています。

{
  "Content": {
    "TextMessage": {
      "Body": "What would you like to do?"
    }
  },
  "Suggestions": [
    {
      "Reply": {
        "Text": "Check order status",
        "PostbackData": "action=check_order"
      }
    },
    {
      "OpenUrl": {
        "Text": "View details",
        "PostbackData": "action=view",
        "Url": "https://example.com/orders/1234"
      }
    }
  ]
}

この例では、以下のようになっています：

  • Content.TextMessage.Body にはメッセージテキストが含まれます (必須、1～3,072 文字）。

  • Suggestions は最上位の配列です (オプション、最大 11 項目）。各提案には、 Textフィールド (最大 25 文字) と PostbackDataフィールド (最大 2,048 文字) が必要です。

Suggestions 配列は、、Reply、OpenUrl、、DialPhoneShowLocation、 RequestLocationの 6 つのアクションタイプをサポートしていますCreateCalendarEvent。1 つのメッセージでさまざまな提案タイプを混在させることができます。各タイプの詳細については、「」を参照してくださいRCS の提案の設定。

テキストメッセージの送信

RCS テキストメッセージを送信するには、次の必須パラメータSendRcsMessageを指定して を呼び出します。

  • DestinationPhoneNumber: E.164 形式の受信者の電話番号。

  • OriginationIdentity: メッセージを送信するプール ID または AWS RCS エージェント。

  • RcsMessageContent: TextMessage オブジェクトContentを含む JSON 文字列。

API を呼び出すには、AWS CLI (aws pinpoint-sms-voice-v2 send-rcs-message) または boto3 pinpoint-sms-voice-v2クライアントなどの AWS SDK を使用します。

SMS または MMS フォールバック

受信者のデバイスが RCS をサポートしていない場合、または RCS チャネルで一時的にアクセスできない場合は、メッセージを SMS または MMS にフォールバックするように設定できます。フォールバックを有効にするには、SendRcsMessageリクエストに FallbackConfiguration オブジェクトを含めます。は、フォールバックメッセージに使用するフォールバックチャネル (SMS または MMS)、フォールバックメッセージ本文、発信元 ID (電話番号または送信者 ID) FallbackConfigurationを指定します。

フォールバックはオプションです。を省略FallbackConfigurationしても受信者が RCS を受信できない場合、メッセージは配信されません。

フォールバック動作の設定の詳細については、「」を参照してくださいリッチ RCS メッセージを送信する。

テキストメッセージの制限

[リソース] 制限 注意事項
メッセージ本文 (Body) 3,072 文字 (UTF-8) 必須。少なくとも 1 文字を含める必要があります。
メッセージあたりの提案 11 返信とアクションの合計。
提案表示テキスト (Text) 25 文字 すべての提案タイプに適用されます。
ポストバックデータ (PostbackData) 2,048 文字 すべての提案タイプに必要です。

テキストメッセージを使用するタイミング

以下TextMessageに使用します。

  • 注文の確認、配送の更新、予約のリマインダーなどの通知。

  • ワンタイムパスワードと検証コード。

  • 提案チップとして返信オプションを提供する会話プロンプト。自由テキスト入力なしでガイド付きインタラクションを可能にします。

  • コンテンツにイメージや構造化レイアウトを必要としない短いステータスの更新。

イメージ、動画、またはタイトルと説明を含む構造化レイアウトを必要とするメッセージの場合は、代わりにリッチカードまたはカルーセルを使用します。「リッチ RCS メッセージを送信する」を参照してください。