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
SuggestionsListe vonRcsMessageContent, nebenanContent. Sie können bis zu 11 Vorschläge pro Nachricht hinzufügen. -
Card-level. Steht in der
SuggestionsListe 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).
Topics
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" } }
| 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 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ä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:valuePaare 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.