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.

Senden von RCS-Dateinachrichten

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. Datei-Nachrichten werden als Inline-Medien in der Messaging-App des Empfängers angezeigt.

Datei-Nachrichten unterscheiden sich von Rich Card-Medien. Eine Dateinachricht enthält ein einziges Medium als gesamten Nachrichteninhalt, während Rich Cards Medien mit Text und Aktionsvorschlägen kombinieren. Informationen zu Rich Cards finden Sie unterRCS-Rich Cards versenden.

Sie können Dateinachrichten mit Vorschlägen auf Nachrichtenebene versehen, z. B. Antwortchips oder Aktionsschaltflächen. 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 Geschwisterpaar von Content (nicht darin verschachtelt).

{
    "Content": {
        "FileMessage": {
            "FileUrl": "s3://amzn-s3-demo-bucket/campaigns/welcome-image.png",
            "ThumbnailUrl": "s3://amzn-s3-demo-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 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:::amzn-s3-demo-bucket/*",
            "Condition": {
                "StringEquals": {
                    "aws:SourceAccount": "123456789012"
                }
            }
        }
    ]
}

Ersetzen Sie 123456789012 durch die Konto-ID für Ihre. AWS-Kontoamzn-s3-demo-bucketErsetzen Sie es durch den Namen Ihres S3-Buckets. Um den Zugriff auf ein bestimmtes Präfix im Bucket einzuschränken, /* ersetzen Sie es durch den Pfad — zum Beispiel. arn:aws:s3:::amzn-s3-demo-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 Vorschaubild für Video- und PDF-Dateinachrichten bereitstellen. Das Vorschaubild 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 im RcsMessageContent Parameter auf. Sie geben die Ursprungsidentität (ein Pool oder ein AWS RCS-Agent) mithilfe des --origination-identity Parameters an.

Das folgende JSON-Beispiel zeigt den RcsMessageContent Wert für eine Dateinachricht mit Vorschlägen.

{
    "Content": {
        "FileMessage": {
            "FileUrl": "s3://amzn-s3-demo-bucket/documents/invoice.pdf",
            "ThumbnailUrl": "s3://amzn-s3-demo-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 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