本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

接收傳入 RCS 訊息

AWS 最終使用者傳訊支援雙向 RCS 訊息，可讓您接收來自客戶的文字訊息。傳入 RCS 訊息遵循與 SMS 雙向傳訊相同的模式：傳入的訊息會傳送到您設定的 Amazon SNS 主題，而您使用 Lambda 函數或其他 SNS 訂閱者來處理這些訊息。

本節說明雙向 RCS 訊息的運作方式、如何為 AWS RCS 代理程式啟用訊息、傳入訊息承載格式，以及如何管理關鍵字。如需管理 AWS RCS 代理程式的詳細資訊，請參閱 管理 RCS 代理程式。如需傳送 RCS 訊息的資訊，請參閱 傳送 RCS 訊息。

雙向 RCS 訊息的運作方式

當客戶傳送文字訊息到您的 AWS RCS 代理程式時， AWS 最終使用者傳訊會收到訊息，並將其發佈到您指定的 Amazon SNS 主題。從那裡，您可以使用任何 SNS 訂閱者來處理訊息，例如 Lambda 函數、Amazon SQS 佇列或 HTTP/HTTPS 端點。

雙向 RCS 訊息傳送流程的運作方式如下：

AWS 最終使用者傳訊中的 RCS 目前支援傳入文字訊息。如果客戶傳送媒體訊息 （例如影像或影片） 到您的 AWS RCS 代理程式，訊息會以 IGNORED 狀態記錄。您的應用程式不會透過 SNS 主題接收媒體訊息。

設定您的雙向傳訊目的地

若要在應用程式中接收和處理傳入 RCS 訊息，您必須在 AWS RCS 代理程式上啟用雙向傳訊並設定目的地。雙向傳訊預設為停用。當您啟用它時，您可以指定 AWS Amazon SNS 主題，其中終端使用者傳訊會傳送傳入訊息。您可以使用 AWS 最終使用者傳訊主控台或 API 來設定目的地。

Console

使用主控台設定雙向傳訊目的地

1. 開啟 AWS 最終使用者傳訊主控台。

2. 在導覽窗格中，選擇 RCS 代理程式。

3. 選擇您要設定的 AWS RCS 代理程式。

4. 選擇雙向傳訊索引標籤。

5. 選擇編輯設定。

6. 開啟啟用雙向訊息。

7. 針對 SNS 主題，選擇現有的 Amazon SNS 主題或建立新的主題。這是發佈傳入訊息的主題。

8. 選擇儲存。

AWS CLI

若要使用 API 設定雙向傳訊目的地，請使用下列參數呼叫 UpdateRcsAgent API：

• two-way-enabled — 設定為 true以啟用雙向傳訊。

• two-way-channel-arn — 發佈傳入訊息的 Amazon SNS 主題 ARN。

• two-way-channel-role — IAM 角色的 ARN，授予 AWS 最終使用者傳訊將訊息發佈至 SNS 主題的許可。

下列範例使用 CLI AWS 設定雙向傳訊目的地：

aws pinpoint-sms-voice-v2 update-rcs-agent \
    --rcs-agent-id rcs-a1b2c3d4 \
    --two-way-enabled \
    --two-way-channel-arn arn:aws:sns:us-east-1:123456789012:MyRCSInboundTopic \
    --two-way-channel-role arn:aws:iam::123456789012:role/SMSVoiceSNSPublishRole
                    

SNS 主題許可

您為雙向 RCS 訊息設定的 Amazon SNS 主題必須允許 AWS 最終使用者訊息將訊息發佈到其中。您有兩種授予存取權的選項。

選項 1：使用 IAM 角色

建立 AWS 最終使用者傳訊可擔任的 IAM 角色，以將訊息發佈到您的 SNS 主題。此角色同時需要信任政策和許可政策。

以下是 IAM 角色的信任政策。將 accountId 取代為 的唯一 ID AWS 帳戶。

{
  "Version": "2012-10-17", 
  "Statement": [
    {
      "Sid": "SMSVoice",
      "Effect": "Allow",
      "Principal": {
        "Service": "sms-voice.amazonaws.com"
      },
      "Action": "sts:AssumeRole",
      "Condition": {
        "StringEquals": {
          "aws:SourceAccount": "accountId"
        }
      }
    }
  ]
}

以下是 IAM 角色的許可政策。SMSVoiceAllowSNSPublish Sid 允許發佈至 Amazon SNS 主題，而 SMSVoiceAllowEncryptedSNSTopics Sid 是加密 Amazon SNS 主題的選用項目。進行下列變更：

{
  "Version": "2012-10-17", 
  "Statement": [
    {
      "Sid": "SMSVoiceAllowSNSPublish",
      "Effect": "Allow",
      "Action": "sns:Publish",
      "Resource": "arn:partition:sns:region:accountId:snsTopicName",
      "Condition": {
        "StringEquals": {
          "aws:ResourceAccount": "accountId"
        }
      }
    },
    {
      "Sid": "SMSVoiceAllowEncryptedSNSTopics",
      "Effect": "Allow",
      "Action": [
        "kms:Decrypt",
        "kms:GenerateDataKey*"
      ],
      "Resource": "*",
      "Condition": {
        "StringEquals": {
          "kms:EncryptionContext:aws:sns:topicArn": "arn:partition:sns:region:accountId:snsTopicName",
          "aws:CalledViaLast": "sns.amazonaws.com"
        }
      }
    }
  ]
}

選項 2：使用 SNS 主題政策

或者，將政策陳述式直接新增至允許 AWS 最終使用者傳訊發佈訊息的 SNS 主題。將 snsTopicArn 取代為 SNS 主題的 ARN。

{
  "Effect": "Allow",
  "Principal": {
    "Service": "sms-voice.amazonaws.com"
  },
  "Action": "sns:Publish",
  "Resource": "snsTopicArn"
}

傳入訊息承載格式

當您的 AWS RCS 代理程式收到傳入文字訊息時， AWS 最終使用者傳訊會將 JSON 承載發佈至設定的 Amazon SNS 主題。RCS 傳入訊息承載使用與 SMS 雙向訊息相同的格式：

{
  "originationNumber": "+14255550182",
  "destinationNumber": "+12125550101",
  "messageKeyword": "JOIN",
  "messageBody": "EXAMPLE",
  "inboundMessageId": "cae173d2-66b9-564c-8309-21f858e9fb84",
  "previousPublishedMessageId": "wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY"
}
        

傳入訊息承載包含下列欄位：

支援的訊息類型

AWS 最終使用者傳訊中的 RCS 目前支援接收傳入文字訊息。當客戶傳送文字訊息到您的 AWS RCS 代理程式時，訊息會傳送到您設定的 Amazon SNS 主題進行處理。

如果客戶傳送媒體訊息 （例如影像、影片或檔案） 到您的 AWS RCS 代理程式， AWS 最終使用者傳訊會以 IGNORED 狀態記錄訊息。媒體訊息不會交付到您的 SNS 主題，也不會由您的應用程式處理。不會將錯誤傳回給寄件者。

RCS 的關鍵字管理

關鍵字可讓您在客戶將特定單字或片語傳送到 AWS RCS 代理程式時設定自動回應。當傳入訊息符合設定的關鍵字時， AWS 最終使用者傳訊會將關聯的自動回應訊息傳回給客戶。

對於 RCS，關鍵字是在 AWS RCS 代理程式上設定，並套用至所有相關聯的 RCS for Business IDs（測試代理程式和國家/地區啟動代理程式）。每個 AWS RCS 代理程式最多可設定 30 個關鍵字。

若要管理 AWS RCS 代理程式的關鍵字，請使用 AWS 最終使用者傳訊主控台或 API。如需關鍵字管理的一般資訊，請參閱 AWS 最終使用者傳訊簡訊中的關鍵字。

使用 Lambda 處理傳入訊息

處理傳入 RCS 訊息的常見模式是將 Lambda 函數訂閱為雙向傳訊設定的 Amazon SNS 主題。Lambda 函數會收到傳入訊息承載，並可以實作您的應用程式邏輯，例如回應客戶查詢、處理命令或將訊息路由到其他系統。

下列 Python 範例顯示處理傳入 RCS 訊息並使用 SendTextMessage API 傳送回應的 Lambda 函數：

import json
import boto3

sms_client = boto3.client('pinpoint-sms-voice-v2')

def lambda_handler(event, context):
    # Parse the SNS message
    for record in event['Records']:
        sns_message = json.loads(record['Sns']['Message'])

        origination_number = sns_message['originationNumber']
        message_body = sns_message['messageBody']
        keyword = sns_message.get('messageKeyword', '')

        print(f"Received message from {origination_number}: {message_body}")

        # Process the message and determine a response
        if keyword.upper() == 'HELP':
            response_text = 'Available commands: HELP, STATUS, STOP'
        elif keyword.upper() == 'STATUS':
            response_text = 'Your account is active. No action needed.'
        else:
            response_text = (
                f'Thanks for your message. '
                f'Reply HELP for available commands.'
            )

        # Send a response back to the customer
        try:
            response = sms_client.send_text_message(
                DestinationPhoneNumber=origination_number,
                OriginationIdentity='pool-a1b2c3d4e5f6g7h8i',
                MessageBody=response_text,
                MessageType='TRANSACTIONAL'
            )
            print(f"Response sent. Message ID: {response['MessageId']}")
        except Exception as e:
            print(f"Failed to send response: {str(e)}")

    return {'statusCode': 200}
        

在此範例中，Lambda 函數：

傳入 RCS 訊息的最佳實務

實作雙向 RCS 訊息時，請遵循下列最佳實務：