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.

RCS-Dateinachrichten senden

Sie können den FileMessage Inhaltstyp in der SendRcsMessage API verwenden, um Bilder, Videos, Audiodateien und PDFs als eigenständige Nachrichten an Ihre Empfänger zu senden. Dateinachrichten werden in der Messaging-App des Empfängers als Inline-Medien angezeigt.

Dateinachrichten unterscheiden sich von Rich-Card-Medien. Bei einer Dateinachricht wird ein einzelnes Medium als der gesamte Nachrichteninhalt bereitgestellt, während Rich Cards Medien mit Text und Aktionsvorschlägen kombinieren. Informationen zu Rich Cards finden Sie unterRCS-Rich Cards versenden.

Sie können Vorschläge auf Nachrichtenebene (wie Antwortchips oder Aktionsschaltflächen) an Dateinachrichten anhängen. Einzelheiten zu Vorschlägen finden Sie unter. Konfiguration von RCS-Vorschlägen

FileMessage Struktur

Das FileMessage Objekt ist im Content Feld des RcsMessageContent Parameters verschachtelt. Message-levelSuggestionssind ein Geschwister von Content (nicht darin verschachtelt).

{
    "Content": {
        "FileMessage": {
            "FileUrl": "s3://my-media-bucket/campaigns/welcome-image.png",
            "ThumbnailUrl": "s3://my-media-bucket/thumbnails/welcome-thumb.jpg"
        }
    },
    "Suggestions": []
}

Datei-URL-Quellen

Der FileUrl Parameter akzeptiert zwei URL-Formate:

S3-Bucket-Richtlinie für die Dateizustellung

Damit AWS End User Messaging Dateien aus Ihrem Amazon S3 S3-Bucket abrufen kann, fügen Sie dem Bucket die folgende ressourcenbasierte Richtlinie hinzu:

{
    "Version": "2012-10-17", 
    "Statement": [
        {
            "Effect": "Allow",
            "Principal": {
                "Service": "sms-voice.amazonaws.com"
            },
            "Action": "s3:GetObject",
            "Resource": "arn:aws:s3:::YOUR-BUCKET/*"
        }
    ]
}

Ersetzen Sie es YOUR-BUCKET durch Ihren Bucket-Namen. Um den Zugriff auf ein bestimmtes Präfix einzuschränken, /* ersetzen Sie es durch den gewünschten Pfad (z. B.arn:aws:s3:::YOUR-BUCKET/rcs-media/*).

Unterstützte Medientypen und Größenbeschränkungen

In der folgenden Tabelle sind die Medientypen aufgeführt, die von unterstützt werdenFileMessage.

Miniaturansichten

Mithilfe des ThumbnailUrl Parameters können Sie ein Miniaturbild für Video- und PDF-Nachrichten bereitstellen. Die Miniaturansicht wird in der Konversation als Vorschau angezeigt, bevor der Empfänger die vollständige Datei öffnet oder herunterlädt.

Eine Dateinachricht senden

Um eine Dateinachricht zu senden, rufen Sie die SendRcsMessage API mit einem FileMessage Objekt innerhalb des RcsMessageContent Parameters auf. Sie geben die Originationsidentität (ein Pool oder ein AWS RCS-Agent) mithilfe des --origination-identity Parameters an.

Die folgende JSON-Datei zeigt den RcsMessageContent Wert für eine Dateimeldung mit Vorschlägen:

{
    "Content": {
        "FileMessage": {
            "FileUrl": "s3://my-media-bucket/documents/invoice.pdf",
            "ThumbnailUrl": "s3://my-media-bucket/thumbnails/invoice-thumb.jpg"
        }
    },
    "Suggestions": [
        {
            "Reply": {
                "Text": "Download receipt",
                "PostbackData": "action=download_receipt"
            }
        }
    ]
}

Lieferung und Fallback

Wenn Sie eine Dateinachricht senden, versucht AWS End User Messaging, sie über den RCS-Kanal zuzustellen. Wenn das Gerät des Empfängers RCS nicht unterstützt oder wenn die Nachricht vor der Zustellung abläuft (basierend auf dem TimeToLive Wert), kann der Dienst je nach Ihrer Fallback-Konfiguration auf SMS oder MMS zurückgreifen.

Sie können den SMS- oder MMS-Fallback auf Poolebene oder pro Nachricht konfigurieren. Einzelheiten zum Fallback-Verhalten finden Sie unter. Senden umfangreicher RCS-Nachrichten