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

RCS メッセージイベント

AWSエンドユーザーメッセージングで RCS メッセージを送信すると、RCS プラットフォームはメッセージライフサイクルの変更、受信者とのやり取り、システムレベルの結果をレポートするイベントを生成します。これらのイベントは、従来の SMS 配信受信よりも豊富なシグナルを提供するため、メッセージが配信、読み取り、期限切れ、または SMS または MMS にフォールバックされたかどうかをリアルタイムで確認できます。

アウトバウンドステータスイベント (配信、読み取り、有効期限、フォールバック) は、設定セットイベントの送信先を介して配信されます。インバウンドインタラクションイベント (タイプインジケータと提案タップ) は、RCS エージェントで設定した双方向 Amazon SNS トピックに配信されます。イベント送信先を設定するには、「」を参照してくださいAWS エンドユーザーメッセージング SMS のイベント送信先。

これらのイベントを生成するメッセージの詳細については、「」を参照してくださいリッチ RCS メッセージを送信する。

RCS イベントの共通フィールド

配信ステータスイベント、読み取り受信、インバウンドインタラクションイベントを含むすべての RCS イベントには、RCS エージェントを識別する次のフィールドが含まれます。

これらのフィールドは、すべての RCS イベントに存在します。これらは SMS または MMS イベントには含まれません。

配信ステータスイベント

配信ステータスイベントは、アウトバウンド RCS メッセージのライフサイクル状態を示します。これらのイベントを使用して、配信の確認、フォールバックロジックのトリガー、またはコンテンツ違反のオペレーションチームに警告します。

各アウトバウンドステータスイベントには、 RCS_DELIVERED (および関連する RCS ステータスイベントタイプ) eventType の と、次のいずれかの値を保持する messageStatus フィールドがあります。

次の例は、配信イベントペイロードを示しています。

{
    "eventType": "RCS_DELIVERED",
    "eventVersion": "1.0",
    "eventTimestamp": 1781661267660,
    "isFinal": true,
    "originationPhoneNumber": "rcs-c020de2520714385964ebf7b095c4b60",
    "destinationPhoneNumber": "+13022640220",
    "isoCountryCode": "US",
    "isInternationalSend": false,
    "messageId": "test-sc1-004",
    "messageRequestTimestamp": 1781300397157,
    "messageEncoding": "UNICODE",
    "messageType": "TRANSACTIONAL",
    "messageStatus": "DELIVERED",
    "messageStatusDescription": "Message has been accepted by phone",
    "totalMessageParts": 1,
    "totalMessagePrice": 0.007,
    "totalCarrierFee": 0.00494,
    "rcsMetadata": { "billingEventType": "RICH" },
    "rcsBusinessId": "endusermessagingtesting1_06fr8x6o_agent",
    "agentIsoCountryCode": "US"
}

受信の読み取り

読み取り受信は、受信者がメッセージを開いたか表示したことを示します。読み取り受信を使用してエンゲージメントを追跡し、読み取りレートを測定します。

読み取りイベントは、 を messageStatusに設定RCS_READして eventTypeの を使用しますREAD。

{
    "eventType": "RCS_READ",
    "eventVersion": "1.0",
    "eventTimestamp": 1781661267203,
    "isFinal": true,
    "originationPhoneNumber": "rcs-c020de2520714385964ebf7b095c4b60",
    "destinationPhoneNumber": "+13022640220",
    "isoCountryCode": "US",
    "isInternationalSend": false,
    "messageId": "test-sc1-004",
    "messageRequestTimestamp": 1781300397157,
    "messageEncoding": "UNICODE",
    "messageType": "TRANSACTIONAL",
    "messageStatus": "READ",
    "messageStatusDescription": "Message has been read by recipient",
    "totalMessageParts": 1,
    "totalMessagePrice": 0.0,
    "totalCarrierFee": 0.0,
    "rcsBusinessId": "endusermessagingtesting1_06fr8x6o_agent",
    "agentIsoCountryCode": "US"
}

読み取りレートは、READイベント数をDELIVEREDイベント数で割った値に 100 を掛けて計算できます。

タイピングインジケーター

入力インジケータイベントは、参加者がメッセージを作成していることを示します。これらのイベントは両方向に流れます。

次の例は、インバウンド入力通知を示しています。

{
    "originationNumber": "12679164820",
    "destinationNumber": "rcs-cb1e6e519e9049fabf8c0ae38e4d876b",
    "messageBody": "{\"type\":\"RCS_TYPING\",\"receivedAt\":\"2026-06-17T17:36:29.937+0000\"}",
    "inboundMessageId": "12679164820-2026-06-17T17:36:29.937+0000"
}

TTL の有効期限イベント

メッセージにTimeToLive値を設定し、メッセージが配信される前に TTL が経過すると、RCS プラットフォームはメッセージの取り消し (削除) を試みます。結果は、次のいずれかのイベントを生成します。

TTL の有効期限イベントは、フォールバック戦略と連動します。メッセージの有効期限の設定の詳細については、「」を参照してくださいRCS メッセージの有効期限の設定。

フォールバックイベント

RCS メッセージを配信できず、AWSエンドユーザーメッセージングが (プールベースの設定またはメッセージごとの を介してFallbackConfiguration) SMS または MMS フォールバックをトリガーすると、サービスはフォールバックの結果を示すイベントを生成します。

フォールバックイベントは以下を示します。

これらのイベントをモニタリングしてフォールバック率を測定し、フォールバック配信を一貫して必要とする電話番号を特定します。メッセージごとのフォールバックの設定の詳細については、「」を参照してくださいメッセージごとの SMS または MMS フォールバックの設定。

提案タップ (ポストバック) イベント

受信者が提案 (提案された返信または提案されたアクション) を選択すると、その提案で設定したPostbackData文字列を含むポストバックイベントを受け取ります。ポストバックデータを使用して、表示テキストではなく会話ロジックをルーティングします。

通知の messageBodyには、 typeの JSON オブジェクトSUGGESTION、表示 text、および提案でpostbackData設定した が含まれます。

{
    "originationNumber": "12679164820",
    "destinationNumber": "rcs-cb1e6e519e9049fabf8c0ae38e4d876b",
    "messageBody": "{\"type\":\"SUGGESTION\",\"text\":\"Open\",\"postbackData\":\"Open\"}",
    "inboundMessageId": "nIMYZGrBUILWng0Qck0deqVaAoTSJY5PsktKYOBYJhVaTsrdMdrs714e8SLZAjD3"
}

提案とそのポストバックデータを設定する方法の詳細については、「」を参照してくださいRCS の提案の設定。

会話料金イベントとフィールド

会話料金を使用するように RCS エージェントを登録すると、AWSEnd User Messaging は、メッセージがアクティブな会話セッションの一部である間に配信イベントとインバウンドイベントにフィールドを追加し、セッションの開始時にCONVERSATION_STARTEDイベントを送信します。会話料金モデルの概要については、「」を参照してください会話料金。

会話フィールド

以下のフィールドは、メッセージがアクティブな会話セッションの一部である場合にのみ、配信イベントまたはインバウンドイベントに表示されます。メッセージが会話に含まれていない場合、AWSエンドユーザーメッセージングはこれらのフィールドを完全に省略します。

メッセージがアクティブな会話セッションの一部である場合、その配信イベントは totalMessagePriceと totalCarrierFee を報告します。これは0.0、セッション料金がメッセージに適用されるためです。次の例は、アクティブな会話内のメッセージの配信イベントを示しています。

{
    "eventType": "RCS_DELIVERED",
    "eventVersion": "1.0",
    "eventTimestamp": 1751234567890,
    "isFinal": true,
    "originationPhoneNumber": "rcs-f4e4252a5abe48bea50a6c176a056124",
    "destinationPhoneNumber": "+14376638816",
    "isoCountryCode": "CA",
    "isInternationalSend": false,
    "messageId": "b4a3196d-5b61-4884-a0d9-745acf1f6235",
    "messageRequestTimestamp": 1751234565000,
    "messageEncoding": "UNICODE",
    "messageType": "TRANSACTIONAL",
    "messageStatus": "DELIVERED",
    "messageStatusDescription": "Message has been accepted by phone",
    "totalMessageParts": 1,
    "totalMessagePrice": 0.0,
    "totalCarrierFee": 0.0,
    "rcsMetadata": {
        "billingEventType": "BASIC"
    },
    "rcsBusinessId": "endusermessagingtesting1_06fr8x6o_agent",
    "agentIsoCountryCode": "CA",
    "conversationInitiatingMessageId": "177930985040408106521449",
    "conversationInitiatingMessageType": "OUTBOUND",
    "conversationSessionFee": 0.012
}

CONVERSATION_STARTED イベント

AWSエンドユーザーメッセージングは、会話セッションの開始時に RCS イベント Amazon SNS トピックにCONVERSATION_STARTEDイベントを送信します。セッションは、エージェントがメッセージを送信し、受信者が 24 時間以内に応答したとき (ビジネス開始）、または受信者がメッセージを送信し、エージェントが応答したとき (ユーザー開始) に開始されます。

には、次のフィールドを含む JSON オブジェクトmessageBodyが含まれています。

次の例は、CONVERSATION_STARTEDイベントを示しています。

{
    "originationNumber": "14376638816",
    "destinationNumber": "rcs-e138fa39eabf4d6d8e95546248c8dfa7",
    "messageBody": "{\"type\":\"CONVERSATION_STARTED\",\"startTime\":\"2026-06-28T04:03:08.002+0000\",\"endTime\":\"2026-06-29T04:08:08.002+0000\",\"conversationInitiatingMessageId\":\"7e7da6ec-234a-4d4f-bbc5-943bcca663ab\",\"conversationInitiatingMessageType\":\"OUTBOUND\"}",
    "inboundMessageId": "7e7da6ec-234a-4d4f-bbc5-943bcca663ab"
}

送信先にイベントをルーティングする

AWSエンドユーザーメッセージングは、設定セットイベントの送信先を介して RCS イベントをルーティングします。送信オペレーションに関連付けられている設定セットでイベント送信先を設定します。サポートされている送信先は次のとおりです。

イベント送信先を作成および設定する方法については、「」を参照してくださいAWS エンドユーザーメッセージング SMS のイベント送信先。

を呼び出すときはSendRcsMessage、 ConfigurationSetNameパラメータを指定して、メッセージを設定セットに関連付けます。そのメッセージによって生成されたアウトバウンドステータスイベントは、設定した宛先にルーティングされます。

イベント送信先が一致するイベントタイプを設定する場合、各 RCS イベントタイプを個別にリストするのではなく ( RCS_DELIVEREDや など）、すべての RCS イベントタイプRCS_ALLを単一の一致タイプでサブスクライブするように選択できますRCS_READ。

イベント処理のベストプラクティス