Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Empfangen eingehender RCS-Nachrichten

AWS End User Messaging unterstützt bidirektionales RCS-Messaging, sodass Sie Textnachrichten von Ihren Kunden empfangen können. Eingehende RCS-Nachrichten folgen demselben Muster wie bidirektionale SMS-Nachrichten: Eingehende Nachrichten werden an ein von Ihnen konfiguriertes Amazon SNS SNS-Thema zugestellt und Sie verarbeiten sie mithilfe von Lambda-Funktionen oder anderen SNS-Abonnenten.

In diesem Abschnitt wird erklärt, wie bidirektionales RCS-Messaging funktioniert, wie Sie es für Ihren AWS RCS-Agenten aktivieren, das Payload-Format für eingehende Nachrichten und wie Sie Schlüsselwörter verwalten. Informationen zur Verwaltung von AWS RCS Agents finden Sie unterVerwaltung von RCS-Agenten. Informationen zum Senden von RCS-Nachrichten finden Sie unter. RCS-Nachrichten senden

So funktioniert bidirektionales RCS-Messaging

Wenn ein Kunde eine Textnachricht an Ihren AWS RCS-Agenten sendet, empfängt AWS End User Messaging die Nachricht und veröffentlicht sie unter einem von Ihnen festgelegten Amazon SNS SNS-Thema. Von dort aus können Sie die Nachricht mit einem beliebigen SNS-Abonnenten verarbeiten, z. B. mit einer Lambda-Funktion, einer Amazon SQS SQS-Warteschlange oder einem Endpunkt. HTTP/HTTPS

Der bidirektionale RCS-Messaging-Ablauf funktioniert wie folgt:

RCS in AWS End User Messaging unterstützt derzeit eingehende Textnachrichten. Wenn ein Kunde eine Medienmitteilung (z. B. ein Bild oder Video) an Ihren AWS RCS-Agenten sendet, wird die Nachricht mit dem Status IGNORIERT protokolliert. Ihre Anwendung empfängt keine Mediennachrichten über das SNS-Thema.

Konfiguration Ihres Ziels für bidirektionales Versenden

Um eingehende RCS-Nachrichten in Ihrer Anwendung zu empfangen und zu verarbeiten, müssen Sie bidirektionales Messaging aktivieren und ein Ziel auf Ihrem AWS RCS Agent konfigurieren. Bidirektionales Messaging ist standardmäßig deaktiviert. Wenn Sie es aktivieren, geben Sie ein Amazon SNS SNS-Thema an, in dem AWS End User Messaging eingehende Nachrichten zustellt. Sie können das Ziel mithilfe der AWS End User Messaging-Konsole oder der API konfigurieren.

Console

So konfigurieren Sie Ihr bidirektionales Messaging-Ziel mithilfe der Konsole

1. Öffnen Sie die AWS End User Messaging-Konsole.

2. Wählen Sie im Navigationsbereich RCS-Agenten aus.

3. Wählen Sie den AWS RCS-Agenten aus, den Sie konfigurieren möchten.

4. Wählen Sie die Registerkarte Bidirektionales Messaging.

5. Wählen Sie Einstellungen ändern aus.

6. Aktivieren Sie die Option Bidirektionale Nachrichtenübermittlung aktivieren.

7. Wählen Sie als SNS-Thema ein vorhandenes Amazon SNS SNS-Thema aus oder erstellen Sie ein neues. Dies ist das Thema, in dem eingehende Nachrichten veröffentlicht werden.

8. Wählen Sie Speichern.

AWS CLI

Um Ihr bidirektionales Messaging-Ziel mithilfe der API zu konfigurieren, rufen Sie die UpdateRcsAgent API mit den folgenden Parametern auf:

• two-way-enabled— Auf einstellen, true um bidirektionales Messaging zu aktivieren.

• two-way-channel-arn— Der ARN des Amazon SNS SNS-Themas, in dem eingehende Nachrichten veröffentlicht werden.

• two-way-channel-role— Der ARN der IAM-Rolle, die AWS End User Messaging die Berechtigung erteilt, Nachrichten zum SNS-Thema zu veröffentlichen.

Im folgenden Beispiel wird das bidirektionale Messaging-Ziel mithilfe der AWS CLI konfiguriert:

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
                    

Berechtigungen für das SNS-Thema

Das Amazon SNS SNS-Thema, das Sie für bidirektionales RCS-Messaging konfigurieren, muss es AWS Endbenutzernachrichten ermöglichen, Nachrichten an dieses Thema zu veröffentlichen. Sie haben zwei Möglichkeiten, Zugriff zu gewähren.

Option 1: Verwenden Sie eine IAM-Rolle

Erstellen Sie eine IAM-Rolle, von der AWS End User Messaging die Veröffentlichung von Nachrichten zu Ihrem SNS-Thema übernehmen kann. Die Rolle benötigt sowohl eine Vertrauensrichtlinie als auch eine Berechtigungsrichtlinie.

Im Folgenden finden Sie die Vertrauensrichtlinie für die IAM-Rolle. accountIdErsetzen Sie durch die eindeutige ID für Ihre AWS-Konto.

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

Im Folgenden finden Sie die Berechtigungsrichtlinie für die IAM-Rolle. Die SMSVoiceAllowSNSPublish Sid ermöglicht die Veröffentlichung in Amazon SNS SNS-Themen und die SMSVoiceAllowEncryptedSNSTopics Sid ist optional für verschlüsselte Amazon SNS SNS-Themen. Nehmen Sie die folgenden Änderungen vor:

{
  "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"
        }
      }
    }
  ]
}

Option 2: Verwenden Sie eine SNS-Themenrichtlinie

Alternativ können Sie dem SNS-Thema direkt eine Richtlinienerklärung hinzufügen, die es AWS Endbenutzernachrichten ermöglicht, Nachrichten zu veröffentlichen. snsTopicArnErsetzen Sie es durch den ARN Ihres SNS-Themas.

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

Payload-Format für eingehende Nachrichten

Wenn Ihr AWS RCS-Agent eine eingehende Textnachricht empfängt, veröffentlicht AWS End User Messaging eine JSON-Payload für das konfigurierte Amazon SNS SNS-Thema. Die Payload für eingehende RCS-Nachrichten verwendet dasselbe Format wie die bidirektionale SMS-Nachrichtenübermittlung:

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

Die Payload für eingehende Nachrichten enthält die folgenden Felder:

Unterstützte Nachrichtentypen

RCS in AWS End User Messaging unterstützt derzeit den Empfang eingehender Textnachrichten. Wenn ein Kunde eine Textnachricht an Ihren AWS RCS-Agenten sendet, wird die Nachricht zur Verarbeitung an Ihr konfiguriertes Amazon SNS SNS-Thema gesendet.

Wenn ein Kunde eine Medienmitteilung (z. B. ein Bild, ein Video oder eine Datei) an Ihren AWS RCS-Agenten sendet, protokolliert AWS End User Messaging die Nachricht mit dem Status IGNORIERT. Mediennachrichten werden nicht zu Ihrem SNS-Thema zugestellt und von Ihrer Anwendung nicht verarbeitet. Dem Absender wird kein Fehler zurückgegeben.

Schlüsselwortverwaltung für RCS

Mithilfe von Schlüsselwörtern können Sie automatische Antworten konfigurieren, wenn Kunden bestimmte Wörter oder Ausdrücke an Ihren AWS RCS-Agenten senden. Wenn eine eingehende Nachricht mit einem konfigurierten Schlüsselwort übereinstimmt, sendet AWS End User Messaging die zugehörige automatische Antwortnachricht zurück an den Kunden.

Für RCS werden die Schlüsselwörter auf dem AWS RCS Agent konfiguriert und gelten für alle zugehörigen RCS for Business IDs (Testing Agent und Country Launch Agents). Sie können bis zu 30 Schlüsselwörter pro AWS RCS-Agent konfigurieren.

Verwenden Sie die AWS End User Messaging-Konsole oder die API, um Keywords für Ihren AWS RCS Agent zu verwalten. Allgemeine Informationen zur Schlüsselwortverwaltung finden Sie unterSchlüsselwörter in SMS-Nachrichten für AWS Endbenutzer.

Verarbeitung eingehender Nachrichten mit Lambda

Ein gängiges Muster für die Verarbeitung eingehender RCS-Nachrichten besteht darin, eine Lambda-Funktion für das Amazon SNS SNS-Thema zu abonnieren, das für bidirektionales Messaging konfiguriert ist. Die Lambda-Funktion empfängt die Nutzlast eingehender Nachrichten und kann Ihre Anwendungslogik implementieren, z. B. die Beantwortung von Kundenanfragen, die Verarbeitung von Befehlen oder die Weiterleitung von Nachrichten an andere Systeme.

Das folgende Python-Beispiel zeigt eine Lambda-Funktion, die eingehende RCS-Nachrichten verarbeitet und mithilfe der API eine Antwort sendet: SendTextMessage

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}
        

In diesem Beispiel die Lambda-Funktion:

Bewährte Methoden für eingehende RCS-Nachrichten

Beachten Sie bei der Implementierung von bidirektionalem RCS-Messaging die folgenden bewährten Methoden: