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 del fallback SMS o MMS per messaggio
Quando si invia un messaggio RCS, il dispositivo del destinatario potrebbe non supportare RCS o il messaggio potrebbe scadere prima del recapito. Con il fallback per messaggio, è possibile specificare contenuti SMS o MMS alternativi che AWS End User Messaging invia automaticamente quando il messaggio RCS non riesce a raggiungere il destinatario. È possibile configurare il fallback su ogni SendRcsMessage richiesta includendo il parametro. FallbackConfiguration
Quando si attiva il fallback
AWSEnd User Messaging attiva il messaggio di fallback in due situazioni:
-
Errore RCS immediato: il dispositivo o l'operatore del destinatario non supporta RCS oppure il canale RCS rifiuta il messaggio.
-
Scadenza TTL: è stato impostato un
TimeToLivevalore e il messaggio non viene recapitato prima della scadenza del timer. Per ulteriori informazioni sulla scadenza dei messaggi, vedere. Configurazione della scadenza dei messaggi RCS
Se non lo si include FallbackConfiguration nella richiesta e il messaggio RCS ha esito negativo o scade, non viene inviato alcun messaggio di fallback.
Per-message fallback rispetto al fallback basato sul pool
Per-message il fallback on è SendRcsMessage diverso dal fallback automatico basato sul pool disponibile con. SendTextMessage Per i dettagli sul fallback basato sul pool, vedi. Fallback da RCS a SMS utilizzando pool di telefoni
| Funzionalità | Pool-based fallback () SendTextMessage |
Per-message riserva () SendRcsMessage |
|---|---|---|
| Configurazione | Automatico quando un pool contiene sia un agente RCS che identità SMS | Esplicito: lo includi in ogni richiesta FallbackConfiguration |
| Canale di fallback | SMS (selezionato dal pool) | SMS o MMS (a scelta) Channel |
| Contenuti di riserva | Stesso corpo del messaggio | Fornisci contenuti separati personalizzati per SMS o MMS |
| Selezione dell'identità | Pool seleziona l'identità di origine | Specificate un numero di telefono o un ID mittente |
| Trigger | RCS non supportato (basato sul timeout) | Errore RCS immediato o scadenza TTL |
FallbackConfiguration struttura
Il FallbackConfiguration parametro è un singolo oggetto sulla SendRcsMessage richiesta. Si imposta il Channel campo per indicare se il fallback è SMS o MMS, quindi si forniscono i campi di contenuto corrispondenti.
| Campo | Tipo | Campo obbligatorio | Descrizione |
|---|---|---|---|
Channel |
Stringa | Sì | Il canale di riserva. Valori validi: SMS o MMS. |
MessageBody |
Stringa | Condizionale | Il corpo del testo del messaggio di fallback. Massimo 1.600 caratteri. Richiesto quando èChannel. SMS PerchéMMS, deve essere fornito almeno uno dei MessageBody o MediaUrls deve essere fornito. |
MediaUrls |
Elenco di stringhe | Condizionale | Uno o più URL multimediali per un fallback MMS. PerchéMMS, MediaUrls deve essere fornito almeno uno MessageBody di questi. |
OriginationIdentity |
Stringa | Condizionale | L'identità di origine del messaggio di fallback. Accetta un numero di telefono o un ID mittente (per valore, ID o ARN); non è possibile specificare un pool o un agente RCS. Se si omette questo campo e il messaggio originale è stato inviato tramite un pool, il servizio seleziona un numero adatto da quel pool. |
Importante
Il MessageBody limite di fallback è di 1.600 caratteri. È inferiore al limite di 3.072 caratteri per il corpo RCS. TextMessage Crea i tuoi contenuti di riserva in modo che rientrino nei limiti dei caratteri degli SMS o MMS.
Il seguente codice JSON mostra la struttura di un FallbackConfiguration oggetto per un fallback SMS:
{ "Channel": "SMS", "MessageBody": "Your order has shipped. Track at https://example.com/track/12345", "OriginationIdentity": "+18005550199" }
Il seguente codice JSON mostra la struttura di un fallback MMS:
{ "Channel": "MMS", "MessageBody": "Your order has shipped.", "MediaUrls": ["https://cdn.example.com/shipping-confirmation.jpg"], "OriginationIdentity": "+18005550199" }
Configurazione del fallback via SMS
Per tornare agli SMS, imposta Channel SMS e fornisci un. MessageBody Poiché gli SMS non supportano i chip di suggerimento o le rich card, includi tutti gli URL importanti come testo semplice nel corpo del messaggio.
Configurazione del fallback MMS
Per tornare agli MMS, imposta Channel MMS e inserisci uno o più URL multimediali. MediaUrls Utilizza MMS fallback quando il messaggio RCS contiene contenuti visivi (ad esempio una rich card con un'immagine) e desideri preservare l'esperienza visiva dei destinatari che non supportano RCS.
Combinazione del fallback con la scadenza del messaggio
Quando si impostano entrambi TimeToLive e FallbackConfiguration su richiesta, AWS End User Messaging tenta la consegna RCS per la durata del TTL. Se il messaggio non viene recapitato prima della scadenza del timer, il servizio invia il messaggio di fallback. Questo modello è utile per contenuti urgenti come password monouso o promemoria di appuntamenti.
Per ulteriori informazioni sulla configurazione della scadenza dei messaggi, consulta. Configurazione della scadenza dei messaggi RCS
L'esempio seguente imposta un TTL di 60 secondi con fallback via SMS:
{ "DestinationPhoneNumber": "+12065550100", "OriginationIdentity": "rcs-agent-1234567890", "RcsMessageContent": "{\"Content\":{\"TextMessage\":{\"Body\":\"Your verification code is 483291.\"}}}", "TimeToLive": 60, "FallbackConfiguration": { "Channel": "SMS", "MessageBody": "Your verification code is 483291.", "OriginationIdentity": "+18005550199" } }
Best practice
-
Scrivi i contenuti di fallback separatamente. I contenuti RCS avanzati (chip di suggerimenti, rich card, caroselli) non vengono tradotti direttamente in SMS o MMS. Scrivi un messaggio di riserva conciso e autonomo anziché riutilizzare il corpo RCS alla lettera.
-
Includi gli URL come testo semplice nel fallback degli SMS. Sostituisci i chip di suggerimento interattivi (come
OpenUrlle azioni) con URL in linea in.MessageBody -
Usa il fallback MMS per i contenuti visivi. Se il messaggio RCS contiene una rich card o un carosello con immagini, MMS fallback preserva il contesto visivo per i destinatari senza supporto RCS.
-
Imposta un TTL ragionevole. Quando combini il fallback con
TimeToLive, scegli un TTL che bilanci i tentativi di consegna con la tempestività. Per i messaggi urgenti, un TTL da 30 a 60 secondi offre una breve finestra di consegna RCS prima di tornare indietro. Per i messaggi generici, una finestra più lunga (da minuti a ore) offre al canale RCS maggiori opportunità di successo. -
Verifica la tua identità di origine. La
OriginationIdentityconfigurazione di riserva deve includere un numero di telefono o un ID mittente registrato nell'account di messaggistica dell'utente AWS finale e in grado di inviare SMS o MMS al paese di destinazione.
Risorse correlate
-
Fallback da RCS a SMS utilizzando pool di telefoniper informazioni sul fallback automatico basato sul pool con.
SendTextMessage -
Configurazione della scadenza dei messaggi RCSper informazioni sulla configurazione del TTL e sul comportamento di scadenza.
-
Invio di messaggi RCS complessiper una panoramica dei tipi di rich message RCS e dell'API.
SendRcsMessage