Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Configurazione dei suggerimenti RCS

I suggerimenti sono chip interattivi che appaiono sotto o all'interno di un messaggio RCS. Guidano i destinatari durante una conversazione presentando risposte e azioni predefinite, come aprire un URL, chiamare un numero di telefono o condividere una posizione, senza richiedere al destinatario di digitare. I suggerimenti sono il modo in cui crei esperienze interattive e conversazionali con. SendRcsMessage

Puoi aggiungere suggerimenti a qualsiasi tipo di contenuto (testo, file, rich card e carosello) a due livelli:

AWSLa messaggistica per l'utente finale supporta sei tipi di suggerimenti: ReplyOpenUrl,DialPhone,, ShowLocationRequestLocation, eCreateCalendarEvent. Ogni suggerimento richiede un'Textetichetta (fino a 25 caratteri) e PostbackData (fino a 2.048 caratteri).

Come funzionano i dati di postback

Ogni suggerimento include una PostbackData stringa di massimo 2.048 caratteri che AWS End User Messaging invia all'applicazione quando il destinatario sceglie il suggerimento. I dati di postback non sono visibili al destinatario. Utilizzateli per codificare le informazioni di routing, gli identificatori di intento, il contesto della sessione o qualsiasi metadato necessario al backend per elaborare la selezione.

Quando un destinatario sceglie un suggerimento, AWS End User Messaging invia un messaggio in entrata all'argomento Amazon SNS che configuri per la messaggistica bidirezionale. Indirizza la logica sul testo visualizzato postbackData anziché sul testo visualizzato. Per informazioni dettagliate sugli eventi in entrata, consultaEventi dei messaggi RCS.

Visualizzazione dei suggerimenti

Reply

Un Reply suggerimento invia una risposta testuale predefinita al tuo agente. Il testo visualizzato viene visualizzato come messaggio inviato nella conversazione e PostbackData viene recapitato all'applicazione.

{ "Reply": { "Text": "Yes, confirm", "PostbackData": "confirm_order_12345" } }

OpenUrl

Un OpenUrl suggerimento apre un URL. Per impostazione predefinita, l'URL si apre nel browser del dispositivo. Per aprire l'URL in una visualizzazione Web che mantiene il destinatario all'interno dell'app di messaggistica, imposta WEBVIEW e specifica Application aWebviewViewMode.

{
  "OpenUrl": {
    "Text": "Complete payment",
    "PostbackData": "pay_12345",
    "Url": "https://example.com/pay",
    "Application": "WEBVIEW",
    "WebviewViewMode": "TALL"
  }
}

DialPhone

Un DialPhone suggerimento avvia una telefonata al numero specificato.

{ "DialPhone": { "Text": "Call support", "PostbackData": "dial_support", "PhoneNumber": "+18005551234" } }

ShowLocation

Un ShowLocation suggerimento apre una mappa alle coordinate specificate.

{
  "ShowLocation": {
    "Text": "View on map",
    "PostbackData": "show_store_loc",
    "Latitude": 47.6062,
    "Longitude": -122.3321,
    "Label": "Seattle store"
  }
}

RequestLocation

Un RequestLocation suggerimento richiede al destinatario di condividere la sua posizione attuale. Le coordinate condivise arrivano come evento di ubicazione in entrata separato.

{ "RequestLocation": { "Text": "Share location", "PostbackData": "request_user_location" } }

CreateCalendarEvent

Un CreateCalendarEvent suggerimento crea un evento del calendario sul dispositivo del destinatario con i dettagli specificati.

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

Ricezione di suggerimenti, tocchi

Quando un destinatario sceglie un suggerimento, AWS End User Messaging pubblica un messaggio in entrata sull'argomento SNS bidirezionale. messageBodyContiene un oggetto JSON con il tipo di suggerimento, il testo visualizzato e i parametri impostati. postbackData Attiva la tua logica. postbackData

{
  "originationNumber": "+12065551234",
  "destinationNumber": "rcs-a1b2c3d4",
  "messageBody": "{\"type\":\"SUGGESTION\",\"text\":\"Yes, confirm\",\"postbackData\":\"confirm_order_12345\"}",
  "inboundMessageId": "msg-abc123def456"
}

Con un RequestLocation tocco, le coordinate del destinatario arrivano in un altro luogo di arrivo. Per il riferimento completo all'evento in entrata, consulta. Eventi dei messaggi RCS

Limiti dei suggerimenti

Best practice

Per una guida più approfondita, consultaLe migliori pratiche RCS.

Argomenti correlati