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à.

Invio di messaggi RCS complessi

Con l'azione SendRcsMessage API in AWS End User Messaging, puoi inviare contenuti ricchi e interattivi ai destinatari tramite RCS (Rich Communication Services). I messaggi RCS complessi vanno oltre il semplice testo e includono rich card, caroselli, file multimediali e suggerimenti che i destinatari scelgono di intraprendere. Questi elementi interattivi trasformano le notifiche unidirezionali in esperienze di conversazione bidirezionali, come consentire al destinatario di confermare un appuntamento, sfogliare un catalogo di prodotti o condividere la propria posizione senza abbandonare la conversazione.

Utilizzale SendRcsMessage quando devi fornire contenuti interattivi e visivamente ricchi, come schede prodotto con immagini e pulsanti di azione, conferme di appuntamenti con un suggerimento di calendario, file allegati o caroselli di più elementi che i destinatari possono scorrere. Ogni SendRcsMessage richiesta include un corpo di testo separato per qualsiasi contenuto di testo e può includere un fallback SMS o MMS opzionale per i destinatari i cui dispositivi non supportano RCS.

Per i messaggi di testo semplice che non richiedono una formattazione avanzata, utilizza invece l'azione API. SendTextMessage SendTextMessageaccetta solo contenuti di testo, il che semplifica la richiesta, e funziona con pool di messaggistica che selezionano automaticamente tra RCS e SMS in base alla capacità del destinatario. Per informazioni dettagliate, vedi Invio di messaggi RCS.

Prerequisiti

Prima di inviare messaggi RCS complessi, completa la procedura di configurazione RCS riportata di seguito. Nozioni di base su RCS Oltre a un agente AWS RCS registrato nello stato Attivo, conferma quanto segue:

Scegliendo tra e SendTextMessage SendRcsMessage

Entrambe le azioni API possono recapitare messaggi tramite RCS, ma hanno scopi diversi. SendTextMessagepresuppone che ogni messaggio sia recapitabile come SMS e possa essere recapitato anche tramite RCS, il che gli conferisce un contratto di richiesta più semplice. SendRcsMessagepresuppone contenuti RCS avanzati e aggiunge funzionalità che SendTextMessage non sono disponibili, tra cui tipi di contenuti multimediali e strutturati, scadenza dei messaggi con time-to-live (TTL) e fallback SMS o MMS per messaggio.

Scegliete SendTextMessage le notifiche in testo semplice, quando desiderate una selezione automatica dei canali basata sul pool o quando state migrando i flussi di lavoro SMS esistenti con modifiche minime al codice. Scegli SendRcsMessage quando hai bisogno di rich card, caroselli, file multimediali o suggerimenti, quando desideri un fallback definito per messaggio o quando hai bisogno di una scadenza per i contenuti sensibili al fattore tempo. TTL-based

Tipi di contenuto

Il RcsMessageContent parametro contiene un Content oggetto con esattamente un tipo di contenuto e un elenco opzionale a livello di messaggioSuggestions. Non è possibile combinare più tipi di contenuto in un'unica richiesta.

Suggerimenti

I suggerimenti sono chip interattivi che i destinatari scelgono per eseguire un'azione. Puoi aggiungere suggerimenti a qualsiasi tipo di contenuto: i suggerimenti a livello di messaggio si applicano all'intero messaggio (fino a 11), mentre i suggerimenti a livello di scheda si applicano a una singola rich card o carousel card (fino a 4). AWSLa messaggistica per l'utente finale supporta sei tipi di suggerimenti, tra cui risposte, link e azioni come la chiamata di un numero di telefono o la condivisione di una posizione. Per l'elenco completo dei tipi di suggerimento, i relativi parametri e come ricevere suggerimenti, consulta. Configurazione dei suggerimenti RCS

SendRcsMessage richiedi una panoramica

La SendRcsMessage richiesta utilizza i seguenti parametri chiave.

Una risposta corretta restituisce un messaggio MessageId che viene utilizzato per correlare gli eventi relativi allo stato del recapito.

Limiti di dimensione e numero dei messaggi

Per i limiti e le restrizioni RCS per tutti i tipi di contenuto, consulta. Limiti e restrizioni relative alla messaggistica

Eventi di consegna e azioni dei destinatari

AWSEnd User Messaging genera eventi che segnalano lo stato di recapito dei messaggi e le azioni dei destinatari, tra cui eventi di consegna, lettura, errori, scaduti e postback. Un evento di postback viene generato quando un destinatario sceglie un suggerimento e include il valore. PostbackData Indirizza questi eventi a un argomento di Amazon SNS, a un flusso di distribuzione di Amazon Data Firehose o ad Amazon Logs. CloudWatch Per informazioni dettagliate, vedi Eventi dei messaggi RCS.

Best practice

Progetta messaggi RCS complessi come esperienze conversazionali e interattive. Imposta una soluzione TimeToLive per i contenuti urgenti, come le password monouso, configura una soluzione alternativa via SMS o MMS per i messaggi che devono pervenire al destinatario anche quando il dispositivo non supporta RCS, mantieni le etichette dei suggerimenti brevi (il limite è di 25 caratteri) e includi identificatori strutturati in modo che l'applicazione possa indirizzare le risposte senza ulteriori ricerche. PostbackData Per Le migliori pratiche RCS una guida dettagliata, consulta.