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-Rich Cards versenden

Eine umfangreiche Karte kombiniert Medien, Text und Aktionsvorschläge zu einer einzigen strukturierten Nachricht. Die Empfänger sehen die Karte als systemeigenes Benutzeroberflächenelement in ihrem Messaging-Client und bieten so ein App-ähnliches Erlebnis. Verwenden Sie umfangreiche Karten, um Informationen zu präsentieren, die zur Interaktion anregen, z. B. Produktdetails, Buchungsbestätigungen oder Werbeangebote.

Informationen zum Gruppieren mehrerer Karten zu einem scrollbaren Satz finden Sie unter. RCS-Karussells senden

Wann sollte eine Rich-Karte verwendet werden

Rich Cards eignen sich gut für Nachrichten, die von einem visuellen Layout mit interaktiven Elementen profitieren. Häufige Anwendungsfälle umfassen:

Wenn Ihre Nachricht nur Text mit optionalen Vorschlägen erfordert, verwenden Sie Senden von RCS-Textnachrichten stattdessen einen. Wenn Sie eine Datei ohne zusätzliche Kartenstruktur senden müssen, finden Sie weitere Informationen unterRCS-Dateinachrichten senden.

Umfangreiche Kartenkomponenten

Eine eigenständige Rich Card besteht aus den folgenden Komponenten. Mindestens einer von MediaTitle, oder Description ist in erforderlichCardContent.

Ausrichtung der Karte

Das CardOrientation Feld steuert die Layout-Beziehung zwischen Medien und Textinhalt. Dies ist ein Pflichtfeld.

Medien und Höhen

Das Media Objekt enthält einen FileUrl (erforderlichen), einen optionalen ThumbnailUrl und einen optionalen Height Wert. Der FileUrl muss dem Muster entsprechen ^(https://|s3://).+$ und darf maximal 2.000 Zeichen lang sein. Die maximale Größe der Mediendatei beträgt 100 MB.

Einzelheiten zu unterstützten Medienformaten, Bereitstellungsoptionen und vorsignierten S3-URLs finden Sie unterRCS-Dateinachrichten senden.

Card-level Vorschläge

Sie können einer Rich Card bis zu 4 Vorschläge hinzufügen, indem Sie sie in das CardContent.Suggestions Array aufnehmen. Card-level Vorschläge werden direkt unter dem Karteninhalt angezeigt.

Zusätzlich zu Vorschlägen auf Kartenebene können Sie bis zu 11 Vorschläge auf Nachrichtenebene in die oberste Ebene Suggestions der Struktur aufnehmen. RcsMessageContent Message-level Vorschläge werden als persistente Chips unter der gesamten Nachricht angezeigt.

Die vollständige Liste der Vorschlagstypen (einschließlichReply,OpenUrl,DialPhone, ShowLocationRequestLocation, undCreateCalendarEvent) finden Sie unterKonfiguration von RCS-Vorschlägen.

RcsMessageContent Struktur

Die folgende JSON-Datei zeigt die Struktur des RcsMessageContent Parameters für eine eigenständige Rich Card. Übergeben Sie dieses JSON als Zeichenfolge an den --rcs-message-content Parameter in der AWS CLI oder als RcsMessageContent Parameter im SDK.

{
  "Content": {
    "RichCard": {
      "StandaloneCard": {
        "CardOrientation": "VERTICAL",
        "CardContent": {
          "Title": "Your card title",
          "Description": "Additional details about the card content.",
          "Media": {
            "FileUrl": "https://example.com/image.jpg",
            "ThumbnailUrl": "https://example.com/thumb.jpg",
            "Height": "MEDIUM"
          },
          "Suggestions": [
            {
              "Reply": {
                "Text": "Confirm",
                "PostbackData": "confirm_action"
              }
            },
            {
              "OpenUrl": {
                "Text": "View details",
                "PostbackData": "view_details",
                "Url": "https://www.example.com/details"
              }
            }
          ]
        }
      }
    }
  },
  "Suggestions": [
    {
      "Reply": {
        "Text": "Help",
        "PostbackData": "help_menu"
      }
    }
  ]
}

In dieser Struktur:

Eine reichhaltige Karte senden

Verwenden Sie die SendRcsMessage API-Aktion, um eine Rich-Card zu senden. Geben Sie Ihren Pool oder AWS RCS-Agenten als Parameter an --origination-identity und übergeben Sie die Rich-Card-JSON-Struktur als --rcs-message-content Parameter.

Cross-platform Rendern

Das Rendern von reichhaltigen Karten variiert zwischen Android- und iOS-Geräten. Folgen Sie diesen Empfehlungen, um konsistente Ergebnisse zu erzielen:

Umfangreiche Kartenlimits