View a markdown version of this page

RCS-Karussells senden - AWS SMS-Nachrichten für Endbenutzer

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-Karussells senden

In einer Karussellnachricht in AWS End User Messaging werden 2 bis 10 Rich-Karten in einem horizontal scrollbaren Streifen angezeigt. Die Empfänger können durch die Karten blättern und Vorschläge für einzelne Karten auswählen, um Maßnahmen zu ergreifen. Mit Karussells können Sie interaktive und interaktive Erlebnisse wie Produktkataloge, Servicemenüs, Tarifvergleiche und Standortlisten schaffen.

Karussells haben dasselbe Karteninhaltsmodell wie eigenständige Rich Cards (sieheRCS-Rich Cards versenden), aber Karussellkarten verwenden immer ein vertikales Layout und unterstützen die Medienhöhe nicht. TALL

Wichtig

Sie können RCS-Karussellnachrichten in allen Ländern versenden, in denen RCS unterstützt wird.

Wann sollte ein Karussell verwendet werden

Verwenden Sie ein Karussell, wenn die Empfänger mehrere Artikel desselben Typs durchsuchen und vergleichen sollen. Häufige Anwendungsfälle umfassen:

  • Produktkataloge: Zeigen Sie mehrere Artikel mit Bildern, Beschreibungen und Kaufschaltflächen an.

  • Servicemenüs: Präsentieren Sie Servicestufen oder Optionen zum Vergleich nebeneinander.

  • Tarifvergleiche: Lassen Sie die Empfänger die Funktionen verschiedener Tarife vergleichen und eine auswählen.

  • Standortlisten: Zeigen Sie Geschäfte oder Büros in der Nähe mit Adressen und Kartenaktionen an.

Wenn Sie ein einzelnes Element mit reichhaltigem Inhalt anzeigen möchten, verwenden Sie stattdessen eine eigenständige Rich Card. Details hierzu finden Sie unter RCS-Rich Cards versenden.

Struktur des Karussells

Sie definieren ein Karussell im Content.Carousel Objekt innerhalb des RcsMessageContent Parameters einer Anfrage. SendRcsMessage Das Karussell-Objekt enthält zwei Pflichtfelder:

CardWidth (Erforderlich)

Die Anzeigebreite aller Karten im Karussell. Alle Karten haben dieselbe Breite. Gültige Werte: SMALL oder MEDIUM.

CardContents (Erforderlich)

Eine Reihe von 2 bis 10 Kartenobjekten. Jede Karte kann einen Titel, eine Beschreibung, Medien und bis zu 4 Vorschläge enthalten.

Werte für die Kartenbreite

Breiten von Karussellkarten
Wert Width Am besten geeignet für
SMALL 180 DP Kompakte Listen, Miniaturansichten, Funktionen zum schnellen Durchsuchen
MEDIUM 296 DP Detaillierte Karten mit längeren Beschreibungen und größeren Bildern

Felder mit Karteninhalt

Jedes Kartenobjekt im CardContents Array unterstützt die folgenden Felder:

Title

Der Kartentitel. Maximal 200 Zeichen.

Description

Der Text der Kartenbeschreibung. Maximal 2.000 Zeichen.

Media

Ein Bild oder Video, das auf der Karte angezeigt werden soll. Enthält die folgenden Felder:

  • FileUrl(erforderlich): Die URL der Mediendatei. Muss dem Muster entsprechen^(https://|s3://).+$. Maximal 2.000 Zeichen. Die maximale Dateigröße beträgt 100 MB.

  • ThumbnailUrl(optional): Eine URL für ein Vorschaubild wird angezeigt, während das gesamte Medium geladen wird.

  • Height: Die Displayhöhe des Mediums. Gültige Werte für Karussellkarten: SHORT oder. MEDIUM Die TALL Höhe wird in Karussells nicht unterstützt.

Suggestions

Eine Reihe von bis zu 4 vorgeschlagenen Antworten oder Aktionen, die unter dem Karteninhalt angezeigt werden. Die vollständige Liste der Vorschlagsarten finden Sie unterKonfiguration von RCS-Vorschlägen.

Kartenvorschläge und äußere Vorschläge

Karussellnachrichten unterstützen zwei Ebenen von Vorschlägen:

Card-level Vorschläge

Jede Karte kann bis zu 4 Vorschläge enthalten. Diese werden direkt unter dem Karteninhalt angezeigt und sind spezifisch für diese Karte (z. B. „Diesen Artikel kaufen“ oder „Details anzeigen“).

Äußere Vorschläge (auf Nachrichtenebene)

Das Suggestions Array der obersten Ebene (ein gleichgeordnetes Element von Content in der RcsMessageContent Struktur) definiert eine Chip-Liste, die unter dem gesamten Karussell angezeigt wird. Sie können bis zu 11 äußere Vorschläge pro Nachricht hinzufügen.

Verwenden Sie äußere Vorschläge für Navigationsaktionen, die sich auf die gesamte Nachricht beziehen, z. B. „Zurück zum Menü“, „Hilfe“ oder „Durchstöbern“. Vermeiden Sie es, Aktionen auf Kartenebene in der äußeren Chip-Liste zu duplizieren.

Höhe und Kürzung der Karte

Alle Karten in einem Karussell werden so skaliert, dass sie der Höhe der höchsten Karte entsprechen. Wenn der Inhalt einer Karte die maximale Anzeigehöhe überschreitet, schneidet der Messaging-Client den Inhalt in der folgenden Reihenfolge ab:

  1. Die Beschreibung wurde auf eine einzige Zeile gekürzt.

  2. Der Titel wurde auf eine einzige Zeile gekürzt.

  3. Vorschläge wurden entfernt.

  4. Beschreibung wurde entfernt.

  5. Der Titel wurde entfernt (nur das Medium bleibt übrig).

Wenn die Kürzung vorgenommen wurde, erscheint die Anzeige „Mehr“, sodass der Empfänger die Karte auf die Vollbildansicht erweitern kann.

Seitenverhältnisse der Medien

Das Seitenverhältnis von Kartenmedien hängt von der Kombination aus Kartenbreite und Medienhöhe ab.

Seitenverhältnisse für Karten mit mittlerer Breite
Höhe Seitenverhältnis
MEDIUM 4:3
SHORT 2:1
Seitenverhältnisse der Karte mit geringer Breite
Höhe Seitenverhältnis
MEDIUM 4:5
SHORT 5:4
Anmerkung

Die TALL Medienhöhe wird auf Karussellkarten nicht unterstützt. Verwenden Sie für große Medien eine eigenständige Rich Card. Siehe RCS-Rich Cards versenden.

Karussell-JSON-Struktur

Die folgende JSON-Datei zeigt die Struktur des RcsMessageContent Parameters für eine Karussellnachricht:

{ "Content": { "Carousel": { "CardWidth": "SMALL | MEDIUM", "CardContents": [ { "Title": "Card title (max 200 chars)", "Description": "Card description (max 2000 chars)", "Media": { "FileUrl": "https://example.com/image.jpg", "ThumbnailUrl": "https://example.com/thumb.jpg", "Height": "SHORT | MEDIUM" }, "Suggestions": [ { "Reply": { "Text": "Button label (max 25 chars)", "PostbackData": "callback_data" } } ] } ] } }, "Suggestions": [ { "Reply": { "Text": "Outer chip label", "PostbackData": "outer_callback" } } ] }

Dieser Wert wird als JSON-Zeichenfolge im --rcs-message-content Parameter (CLI) oder im RcsMessageContent Parameter (SDK) übergeben. Sie geben in der send-rcs-message Anfrage auch --destination-phone-number und --origination-identity (einen Pool- oder RCS-Agenten) an.

Karussell-Limits

Grenzwerte für Karussellnachrichten
Parameter Minimum Maximum
Karten pro Karussell 2 10
Vorschläge pro Karte 0 4
Äußere Vorschläge pro Nachricht 0 11
Länge des Titels - 200 Zeichen
Länge der Beschreibung - 2 000 Zeichen
Größe der Mediendatei - 100 MB
Gesamtgröße der Nutzlast - 250 KB

Einzelheiten zum Medienformat und zur Lieferung finden Sie unterRCS-Dateinachrichten senden.