View a markdown version of this page

Konfiguration von RCS-Vorschlägen - 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.

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 vonRcsMessageContent, nebenanContent. 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: ReplyOpenUrl,DialPhone,ShowLocation,RequestLocation, undCreateCalendarEvent. Jeder Vorschlag erfordert eine Text Bezeichnung (bis zu 25 Zeichen) und PostbackData (bis zu 2.048 Zeichen).

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 unterRCS-Meldungsereignisse.

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" } }
FeldErforderlichEinschränkung
TextJaBis zu 25 Zeichen
PostbackDataJaBis 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" } }
FeldErforderlichEinschränkung
TextJaBis zu 25 Zeichen
PostbackDataJaBis zu 2.048 Zeichen
UrlJaMuss mit beginnen. https:// Bis zu 2.048 Zeichen
ApplicationNeinWEBVIEWzum Öffnen in einer In-App-Webansicht
WebviewViewModeBedingtErforderlich, 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" } }
FeldErforderlichEinschränkung
TextJaBis zu 25 Zeichen
PostbackDataJaBis zu 2.048 Zeichen
PhoneNumberJaE.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" } }
FeldErforderlichEinschränkung
TextJaBis zu 25 Zeichen
PostbackDataJaBis zu 2.048 Zeichen
LatitudeJa-90,0 bis 90,0
LongitudeJa-180,0 bis 180,0
LabelNeinZeigt 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" } }
FeldErforderlichEinschränkung
TextJaBis zu 25 Zeichen
PostbackDataJaBis 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." } }
FeldErforderlichEinschränkung
TextJaBis zu 25 Zeichen
PostbackDataJaBis zu 2.048 Zeichen
TitleJaBis zu 100 Zeichen
StartTimeJaStartzeit des Ereignisses
EndTimeJaEndzeit des Ereignisses
DescriptionNeinBis 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 weiterpostbackData.

{ "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

Grenzwerte für Vorschläge

EinschränkungLimit
TextLänge des Vorschlags25 Zeichen
PostbackDataLänge2,048 Zeichen
Vorschläge pro Nachricht11
Vorschläge pro Karte4
CreateCalendarEventTitel100 Zeichen
CreateCalendarEventBeschreibung500 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 aktiviertPostbackData, 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 ReplyOpenUrl, an und a. DialPhone

Eine ausführlichere Anleitung finden Sie unterBewährte Methoden von RCS.