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-Medien

Benutzer können Medien (Bilder, Videos, Audiodateien und Dokumente) in RCS-Konversationen mit Ihrem Agenten senden. Wenn Sie den Speicher für eingehende Medien konfigurieren, lädt AWS End User Messaging die Medien vom RCS-Anbieter herunter, lädt sie in Ihren Amazon S3 S3-Bucket hoch und veröffentlicht eine Benachrichtigung zu Ihrem bidirektionalen Amazon SNS SNS-Thema mit dem S3-Standort und den Dateimetadaten.

Allgemeine Informationen zum Empfang eingehender RCS-Nachrichten (Text, Standort und Antwortvorschläge) finden Sie unter. Empfangen eingehender RCS-Nachrichten Informationen zum Senden von Rich Media an Benutzer finden Sie unter. Senden umfangreicher RCS-Nachrichten

So funktionieren eingehende Medien

Wenn ein Benutzer in einer RCS-Konversation eine Mediendatei sendet, verarbeitet AWS End User Messaging die Nachricht anhand der folgenden Schritte:

Für SUGGESTION Nachrichtentypen LOCATION und -typen findet kein S3-Upload statt. Der Inhalt wird direkt im SNS-Benachrichtigungstext übermittelt. Einzelheiten zu diesen Nachrichtentypen finden Sie unterEmpfangen eingehender RCS-Nachrichten.

Konfiguration des Speichers eingehender Medien

Um eingehende Medien zu empfangen, konfigurieren Sie die folgenden Felder auf Ihrem RCS-Agenten mithilfe der API. UpdateRcsAgent Two-way Messaging muss auf dem Agenten aktiviert sein, bevor Sie den Medienspeicher konfigurieren.

Der S3-Bucket und die IAM-Rolle sind zusammen erforderlich. Wenn Sie einen angeben, müssen Sie beide angeben.

S3-Schlüsselformat

Medienobjekte werden mit dem folgenden Schlüsselformat gespeichert, wobei der ursprüngliche Dateiname nach einem # Trennzeichen angehängt wird:

{prefix}/rcs/{messageId}#{fileName}

Wenn Sie das key prefix beispielsweise auf setzeninbound-media, kann eine Mediendatei wie folgt gespeichert werden:

inbound-media/rcs/msg-abc123def456#photo_2026.jpg

Die IAM-Rolle für eingehende Medien erstellen

Erstellen Sie eine IAM-Rolle, die es dem AWS End User Messaging-Dienst ermöglicht, Mediendateien in Ihren S3-Bucket hochzuladen. Die Rolle erfordert eine Vertrauensrichtlinie, die es dem Dienst ermöglicht, sie zu übernehmen, und eine Berechtigungsrichtlinie, die s3:PutObject Zugriff auf Ihren Bucket gewährt.

Vertrauensrichtlinie

Die folgende Vertrauensrichtlinie ermöglicht es dem Principal des AWS End User Messaging-Dienstes, die Rolle zu übernehmen. 123456789012Ersetzen Sie es durch Ihre AWS Konto-ID.

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

Berechtigungsrichtlinie

Die folgende Berechtigungsrichtlinie gewährt der Rolle Zugriff zum Schreiben von Objekten in Ihren S3-Bucket. my-rcs-media-bucketErsetzen Sie es durch Ihren Bucket-Namen.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "s3:PutObject"
            ],
            "Resource": "arn:aws:s3:::my-rcs-media-bucket/*"
        }
    ]
}

Medienspeicher (CLI) konfigurieren

Der folgende AWS CLI-Befehl konfiguriert den eingehenden Medienspeicher auf einem vorhandenen RCS-Agenten:

aws pinpoint-sms-voice-v2 update-rcs-agent \
    --rcs-agent-id rcs-agent-1234567890abcdef0 \
    --two-way-media-s3-bucket-name my-rcs-media-bucket \
    --two-way-media-s3-key-prefix "inbound-media" \
    --two-way-media-s3-role arn:aws:iam::123456789012:role/RcsInboundMediaRole \
    --region us-east-1

Payload für Benachrichtigungen über eingehende Medien

Wenn AWS End User Messaging eine Mediendatei empfängt, veröffentlicht es eine Benachrichtigung zu Ihrem bidirektionalen SNS-Thema. Die Benachrichtigung ist ein JSON-Objekt mit einem messageBody Feld, das ein stringifiziertes JSON-Dokument mit dem Medienstatus und, falls erfolgreich, dem S3-Speicherort und den Dateimetadaten enthält.

Das folgende Beispiel zeigt eine erfolgreiche eingehende Medienbenachrichtigung:

{
    "originationNumber": "+14255551234",
    "destinationNumber": "rcs-cb1e6e519e9049fabf8c0ae38e4d876b",
    "messageBody": "{\"mediaStatus\":\"SUCCESS\",\"s3Bucket\":\"my-rcs-media-bucket\",\"s3Key\":\"inbound-media/rcs/msg-abc123def456#photo_2026.jpg\",\"mimeType\":\"image/jpeg\",\"fileName\":\"photo_2026.jpg\",\"fileSizeBytes\":1211843}",
    "inboundMessageId": "8821d750-4bc5-4cb1-a8c3-c3d64a38d019"
}

Die Benachrichtigung auf oberster Ebene enthält die folgenden Felder:

Die messageBody JSON-Datei enthält die folgenden Felder:

Behandlung von Fehlern beim Herunterladen von Medien

Wenn AWS End User Messaging keine Medien vom RCS-Anbieter herunterladen oder speichern kann, veröffentlicht der Dienst trotzdem eine Benachrichtigung zu Ihrem bidirektionalen SNS-Thema. Der messageBody enthält einen Fehler mediaStatus (UPLOAD_FAILEDoderROLE_ASSUME_FAILED) und eine mediaStatusMessage Beschreibung der Ursache, ohne S3-Standortfelder.

Ein Fehler bei der Annahme einer IAM-Rolle führt beispielsweise zu folgendem messageBody Inhalt:

{
    "mediaStatus": "ROLE_ASSUME_FAILED",
    "mediaStatusMessage": "Media received but could not assume the configured IAM role",
    "mimeType": "image/heic",
    "fileName": "IMG_7115.heic",
    "fileSizeBytes": 1211843
}

Zu den häufigsten Ursachen für Fehler beim Herunterladen von Medien gehören:

Stellen Sie zur Behebung von Zustellungsfehlern sicher, dass Ihre Vertrauens- und Berechtigungsrichtlinien für IAM-Rollen korrekt konfiguriert sind und dass der S3-Bucket vorhanden ist und vom Service aus darauf zugegriffen werden kann. Überwachen Sie die CloudWatch Metriken Ihres Agenten im Hinblick auf Fehler beim Hochladen von Medien.

Zulässige Medientypen

AWSEnd User Messaging akzeptiert die folgenden MIME-Typen für eingehende Medien:

Bewährte Methoden