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. # Konfiguration von RCS-Vorschlägen Vorschläge sind interaktive Chips, die unter oder in einer RCS-Nachricht erscheinen. Sie leiten die Empfänger durch eine Konversation, indem sie vordefinierte Antworten und Aktionen präsentieren, z. B. das Öffnen einer URL, das Anrufen einer Telefonnummer oder das Teilen eines Standorts, ohne dass der Empfänger etwas eingeben muss. Vorschläge sind die Art und Weise, wie Sie interaktive Konversationserlebnisse mit `SendRcsMessage` gestalten können. Sie können jedem Inhaltstyp (Text, Datei, Rich Card und Karussell) Vorschläge auf zwei Ebenen hinzufügen: + **Message-level**. Steht in der obersten `Suggestions` Liste von`RcsMessageContent`, nebenan`Content`. Sie können bis zu 11 Vorschläge pro Nachricht hinzufügen. + **Card-level**. Steht in der `Suggestions` Liste einer einzelnen Rich Card oder Carousel Card. Sie können bis zu 4 Vorschläge pro Karte hinzufügen. AWSEnd User Messaging unterstützt sechs Arten von Vorschlägen: `Reply``OpenUrl`,`DialPhone`,`ShowLocation`,`RequestLocation`, und`CreateCalendarEvent`. Jeder Vorschlag erfordert eine `Text` Bezeichnung (bis zu 25 Zeichen) und `PostbackData` (bis zu 2.048 Zeichen). **Topics** + [Wie funktionieren Postback-Daten](#rcs-suggestions-postback) + [Anzeige der Vorschläge](#rcs-suggestions-display) + [Antworten](#rcs-suggestions-reply) + [OpenUrl](#rcs-suggestions-openurl) + [DialPhone](#rcs-suggestions-dialphone) + [ShowLocation](#rcs-suggestions-showlocation) + [RequestLocation](#rcs-suggestions-requestlocation) + [CreateCalendarEvent](#rcs-suggestions-calendar) + [Tippen Sie auf Vorschläge, die Sie erhalten](#rcs-suggestions-receiving) + [Grenzwerte für Vorschläge](#rcs-suggestions-limits) + [Bewährte Methoden](#rcs-suggestions-best-practices) + [Verwandte Themen](#rcs-suggestions-related) ## Wie funktionieren Postback-Daten Jeder Vorschlag enthält eine `PostbackData` Zeichenfolge mit bis zu 2.048 Zeichen, die AWS End User Messaging an Ihre Anwendung zurücksendet, wenn der Empfänger den Vorschlag auswählt. Postback-Daten sind für den Empfänger nicht sichtbar. Verwenden Sie es, um Routing-Informationen, Absichtskennungen, Sitzungskontext oder andere Metadaten zu verschlüsseln, die Ihr Backend zur Verarbeitung der Auswahl benötigt. Wenn ein Empfänger einen Vorschlag auswählt, sendet AWS End User Messaging ein Ereignis für eingehende Nachrichten an das Amazon SNS SNS-Thema, das Sie für bidirektionales Messaging konfigurieren. Leiten Sie Ihre Logik an und `postbackData` nicht an den Anzeigetext weiter. Einzelheiten zu eingehenden Ereignissen finden Sie unter[RCS-Meldungsereignisse](rcs-events.md). ## Anzeige der Vorschläge Vorübergehende Vorschläge (Standard) Vorübergehende Vorschläge werden außerhalb der Nachrichtenblase unter der neuesten Nachricht angezeigt. Sie verschwinden, nachdem der Empfänger eine Nachricht ausgewählt oder eine Nachricht gesendet hat. Anhaltende Vorschläge Dauerhafte Vorschläge werden in der Nachrichtenblase angezeigt und bleiben sichtbar, nachdem der Empfänger an einer Nachricht vorbeigescrollt oder mit späteren Nachrichten interagiert hat. Die dauerhafte Anzeige hängt von der Position des Vorschlags auf einer Rich-Card ab. Vorschläge, die an eigenständige Rich Cards angehängt sind, werden auf unterstützten Clients dauerhaft wiedergegeben. ## Antworten Bei einem `Reply` Vorschlag wird eine vordefinierte Textantwort an Ihren Agenten zurückgesendet. Der angezeigte Text wird in der Konversation als gesendete Nachricht angezeigt und an Ihre Anwendung übermittelt. `PostbackData` ``` { "Reply": { "Text": "Yes, confirm", "PostbackData": "confirm_order_12345" } } ``` | Feld | Erforderlich | Einschränkung | | --- | --- | --- | | Text | Ja | Bis zu 25 Zeichen | | PostbackData | Ja | Bis zu 2.048 Zeichen | ## OpenUrl Ein `OpenUrl` Vorschlag öffnet eine URL. Standardmäßig wird die URL im Gerätebrowser geöffnet. Um die URL in einer Webansicht zu öffnen, bei der der Empfänger in der Messaging-App bleibt, setzen Sie `Application` auf `WEBVIEW` und geben Sie a `WebviewViewMode` an. ``` { "OpenUrl": { "Text": "Complete payment", "PostbackData": "pay_12345", "Url": "https://example.com/pay", "Application": "WEBVIEW", "WebviewViewMode": "TALL" } } ``` | Feld | Erforderlich | Einschränkung | | --- | --- | --- | | Text | Ja | Bis zu 25 Zeichen | | PostbackData | Ja | Bis zu 2.048 Zeichen | | Url | Ja | Muss mit beginnen. https:// Bis zu 2.048 Zeichen | | Application | Nein | WEBVIEWzum Öffnen in einer In-App-Webansicht | | WebviewViewMode | Bedingt | Erforderlich, wenn Application istWEBVIEW:FULL,, oder HALF TALL | **Anmerkung** Sie `Url` müssen das `https://` Protokoll verwenden. Eine `s3://` URL wird abgelehnt. Im Gegensatz zu einem geöffneten Standardbrowser hält eine Webansicht den Empfänger innerhalb der Konversation, was bei kurzen Abläufen wie Zahlungen oder Formularen nützlich ist. ## DialPhone Mit einem `DialPhone` Vorschlag wird ein Telefonanruf an die von Ihnen angegebene Nummer gestartet. ``` { "DialPhone": { "Text": "Call support", "PostbackData": "dial_support", "PhoneNumber": "+18005551234" } } ``` | Feld | Erforderlich | Einschränkung | | --- | --- | --- | | Text | Ja | Bis zu 25 Zeichen | | PostbackData | Ja | Bis zu 2.048 Zeichen | | PhoneNumber | Ja | E.164 Format, zum Beispiel \+18005551234 | ## ShowLocation Ein `ShowLocation` Vorschlag öffnet eine Karte an den von Ihnen angegebenen Koordinaten. ``` { "ShowLocation": { "Text": "View on map", "PostbackData": "show_store_loc", "Latitude": 47.6062, "Longitude": -122.3321, "Label": "Seattle store" } } ``` | Feld | Erforderlich | Einschränkung | | --- | --- | --- | | Text | Ja | Bis zu 25 Zeichen | | PostbackData | Ja | Bis zu 2.048 Zeichen | | Latitude | Ja | -90,0 bis 90,0 | | Longitude | Ja | -180,0 bis 180,0 | | Label | Nein | Zeigt die Bezeichnung für den Karten-Pin an | ## RequestLocation Ein `RequestLocation` Vorschlag fordert den Empfänger auf, seinen aktuellen Standort mitzuteilen. Die gemeinsam genutzten Koordinaten werden als separates eingehendes Standortereignis empfangen. ``` { "RequestLocation": { "Text": "Share location", "PostbackData": "request_user_location" } } ``` | Feld | Erforderlich | Einschränkung | | --- | --- | --- | | Text | Ja | Bis zu 25 Zeichen | | PostbackData | Ja | Bis zu 2.048 Zeichen | ## CreateCalendarEvent Ein `CreateCalendarEvent` Vorschlag erstellt auf dem Gerät des Empfängers ein Kalenderereignis mit den von Ihnen angegebenen Details. ``` { "CreateCalendarEvent": { "Text": "Add to calendar", "PostbackData": "calendar_appt_5678", "Title": "Service appointment", "StartTime": "2026-05-28T14:00:00Z", "EndTime": "2026-05-28T15:00:00Z", "Description": "Downtown location. Arrive 10 minutes early." } } ``` | Feld | Erforderlich | Einschränkung | | --- | --- | --- | | Text | Ja | Bis zu 25 Zeichen | | PostbackData | Ja | Bis zu 2.048 Zeichen | | Title | Ja | Bis zu 100 Zeichen | | StartTime | Ja | Startzeit des Ereignisses | | EndTime | Ja | Endzeit des Ereignisses | | Description | Nein | Bis zu 500 Zeichen | ## Tippen Sie auf Vorschläge, die Sie erhalten Wenn ein Empfänger einen Vorschlag auswählt, veröffentlicht AWS End User Messaging eine eingehende Nachricht zu Ihrem bidirektionalen SNS-Thema. Das `messageBody` enthält ein JSON-Objekt mit dem Vorschlagstyp, dem Anzeigetext und dem `postbackData` von Ihnen festgelegten. Leiten Sie Ihre Logik weiter`postbackData`. ``` { "originationNumber": "+12065551234", "destinationNumber": "rcs-a1b2c3d4", "messageBody": "{\"type\":\"SUGGESTION\",\"text\":\"Yes, confirm\",\"postbackData\":\"confirm_order_12345\"}", "inboundMessageId": "msg-abc123def456" } ``` Mit einem `RequestLocation` Fingertipp werden die Koordinaten des Empfängers in einem separaten Ereignis mit eingehender Ortung empfangen. Die vollständige Referenz zu eingehenden Ereignissen finden Sie unter. [RCS-Meldungsereignisse](rcs-events.md) ## Grenzwerte für Vorschläge | Einschränkung | Limit | | --- | --- | | TextLänge des Vorschlags | 25 Zeichen | | PostbackDataLänge | 2,048 Zeichen | | Vorschläge pro Nachricht | 11 | | Vorschläge pro Karte | 4 | | CreateCalendarEventTitel | 100 Zeichen | | CreateCalendarEventBeschreibung | 500 Zeichen | ## Bewährte Methoden + Halten Sie den Text aktionsorientiert. *Verwenden Sie Verben wie *Bestellung verfolgen*, *Support anrufen* oder Menü anzeigen.* + Bieten Sie 3 bis 5 Optionen an. Mehr als 5 können die Empfänger überfordern. + Route aktiviert`PostbackData`, Text nicht anzeigen. Text ist für Personen, Postback-Daten für Ihre Anwendung. + Strukturieren Sie Postback-Daten konsistent, zum Beispiel als `action:value` Paare oder JSON. + Behandeln Sie den Fall, dass ein Empfänger freien Text eingibt, anstatt auf einen Vorschlag zu tippen. + Kombinieren Sie Vorschlagstypen in einer einzigen Nachricht, z. B. a `Reply``OpenUrl`, an und a. `DialPhone` Eine ausführlichere Anleitung finden Sie unter[Bewährte Methoden von RCS](rcs-best-practices.md). ## Verwandte Themen + [Senden von RCS-Textnachrichten](rcs-text-messages.md) + [RCS-Rich Cards versenden](rcs-rich-cards.md) + [RCS-Meldungsereignisse](rcs-events.md)