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à.
Fallback da RCS a SMS utilizzando pool di telefoni
Un pool telefonico è un contenitore di identità di messaggistica, come agenti AWS RCS e numeri di telefono SMS, che fornisce un livello di astrazione tra le richieste API e le identità di origine sottostanti. I pool semplificano le modifiche alla configurazione, la migrazione dei tipi di numeri e il fallback. RCS-to-SMS Invii una singola chiamata API al pool e AWS End User Messaging gestisce la selezione dei canali per te.
Questo capitolo spiega in che modo la consegna RCS può fallire, cosa rende possibile il fallback degli SMS, la logica di fallback e l'ordine di priorità e le implicazioni di fatturazione. Descrive inoltre le best practice relative ai pool per caso d'uso e come aggiungere e rimuovere gli agenti AWS RCS dai pool. Per informazioni generali sui pool telefonici, consulta. Pool telefonici in AWS Messaggistica SMS per l'utente finale Per informazioni sulla gestione degli agenti AWS RCS, consultaGestione degli agenti RCS.
Argomenti
In che modo la consegna di RCS può fallire
La consegna RCS può fallire per diversi motivi. La comprensione di queste modalità di errore ti aiuta a pianificare la tua strategia di riserva:
-
L'operatore non supporta l'RCS: il gestore di telefonia mobile del destinatario non ha abilitato la messaggistica RCS sulla propria rete.
-
Il dispositivo non supporta RCS: il dispositivo del destinatario non dispone della funzionalità RCS (ad esempio, un vecchio dispositivo Android o un iPhone con iOS precedente alla versione 18).
-
Agente non attivo con l'operatore: il tuo agente AWS RCS non è stato ancora approvato dal corriere del destinatario oppure l'agente è in stato PARZIALE per quel paese.
-
Dispositivo temporaneamente irraggiungibile: il dispositivo del destinatario supporta RCS ma è temporaneamente offline o non dispone di una connessione dati. I messaggi RCS richiedono una connessione dati per la consegna.
Quando si verifica una di queste condizioni e si utilizza l'invio basato su pool o a livello di account, la messaggistica per gli utenti AWS finali ritorna automaticamente alla consegna degli SMS utilizzando un numero di telefono o un ID mittente dedicato dello stesso pool o account. I percorsi SMS condivisi non sono supportati come riserva per l'invio RCS. Se il pool o l'account non contiene un mittente dedicato (numero di telefono o ID mittente) valido per il paese di destinazione, il messaggio non viene visualizzato.
Cosa rende possibile il fallback degli SMS
Il fallback SMS richiede sia un agente AWS RCS che almeno un numero di telefono SMS dedicato o un ID mittente nello stesso pool. Quando si invia un messaggio al pool, AWS End User Messaging tenta innanzitutto la consegna RCS. Se la consegna RCS non riesce, il servizio riprova il messaggio tramite SMS utilizzando un numero di telefono dedicato dello stesso pool. I percorsi SMS condivisi non sono supportati per il fallback RCS. Un pool con solo un agente AWS RCS (e nessun numero di telefono o ID mittente dedicati) non supporta il fallback SMS. Se RCS non riesce in quella configurazione, il messaggio non viene recapitato.
Importante
Affinché il fallback SMS funzioni, il pool deve contenere sia un agente AWS RCS che uno o più numeri di telefono SMS o ID mittente dedicati. Un pool con un solo tipo di identità non fornisce un fallback su più canali. Le route condivise non vengono utilizzate per il RCS-to-SMS fallback, anche se le route condivise sono abilitate nel pool.
Perché usare i pool
Consigliamo di utilizzare un pool di telefoni per tutti i casi d'uso della messaggistica, non solo RCS. I pool offrono i seguenti vantaggi:
-
Fallback automatico degli SMS: quando un pool contiene sia un agente AWS RCS che numeri di telefono SMS, la messaggistica per gli utenti AWS finali tenta prima la consegna RCS. Se la consegna RCS non riesce (ad esempio, il dispositivo o l'operatore del destinatario non supporta RCS), il servizio riprova automaticamente il messaggio via SMS utilizzando un numero di telefono dello stesso pool. Non è necessario implementare la logica di fallback nell'applicazione.
-
Routing intelligente: il servizio seleziona la migliore identità di origine dal pool in base alla destinazione, alla disponibilità del canale e alla cronologia degli invii persistente. Questo routing avviene in modo trasparente ad ogni chiamata.
SendTextMessage -
Chiamata API singola: specifichi l'ID del pool come identità di origine nella richiesta.
SendTextMessageIl servizio determina se effettuare la consegna tramite RCS o SMS senza alcuna logica aggiuntiva da parte dell'utente. -
Flessibilità per modifiche future: puoi aggiungere o rimuovere numeri di telefono e agenti AWS RCS da un pool in qualsiasi momento senza modificare il codice dell'applicazione. Ad esempio, puoi aggiungere un numero verde per il fallback degli SMS o sostituire un numero 10DLC senza modificare l'integrazione di invio.
-
Nessun costo o svantaggio: la creazione di un pool e l'aggiunta delle identità di origine non comporta costi aggiuntivi. Anche con un solo numero di telefono o un singolo agente AWS RCS, l'utilizzo di un pool offre la flessibilità di aggiungere più identità in un secondo momento senza modifiche all'applicazione.
Nota
Ti consigliamo di utilizzare sempre un pool per la messaggistica. L'utilizzo di un pool non comporta costi o svantaggi, anche con un'unica identità di origine. Per il RCS-to-SMS fallback, il pool deve contenere sia un agente AWS RCS che almeno un numero di telefono SMS. Iniziare con un pool dall'inizio significa che puoi aggiungere numeri di riserva SMS o agenti AWS RCS aggiuntivi in un secondo momento senza modificare il codice di invio.
Pool-per-use-case modello
Si consiglia di creare un pool per caso d'uso. Ogni pool deve contenere tutti i numeri di telefono e l'agente AWS RCS che servono a un unico scopo di messaggistica. Ad esempio:
-
Un pool transazionale per codici OTP e notifiche di account, contenente l'agente AWS RCS e un numero 10DLC registrato per la messaggistica transazionale.
-
Un pool di marketing per messaggi promozionali, contenente lo stesso agente AWS RCS (o uno diverso) e un numero verde registrato per il marketing.
-
Un pool di promemoria degli appuntamenti per la pianificazione delle notifiche, contenente l'agente AWS RCS e un numero di telefono dedicato per i messaggi relativi agli appuntamenti.
Questo modello garantisce che quando la consegna RCS fallisce e il servizio ritorna agli SMS, il messaggio di riserva viene inviato da un numero di telefono registrato e approvato per lo stesso caso d'uso. Ciò consente di mantenere la messaggistica conforme ai requisiti del corriere e ai termini di registrazione.
Rischio di conformità con l'invio a livello di account
Quando si inviano messaggi a livello di account (senza specificare un pool o un'identità di origine), AWS End User Messaging seleziona un'identità di origine tra tutte le identità disponibili nell'account. Se il tuo account ha più numeri di telefono registrati per diversi casi d'uso, il servizio potrebbe selezionare un numero di telefono che non corrisponde al contenuto del messaggio.
Importante
Account-level l'invio con casi d'uso misti comporta un rischio di conformità. Ad esempio, se il tuo account ha un numero 10DLC registrato per i messaggi OTP e un numero verde registrato per i promemoria degli appuntamenti, un messaggio OTP che richiama gli SMS potrebbe essere inviato dal numero verde per i promemoria degli appuntamenti. Ciò viola i termini di registrazione per quel numero e può comportare il filtraggio dell'operatore o la sospensione del numero.
Per evitare questo rischio, utilizza l'invio basato su pool con un pool per caso d'uso. Quando si specifica un ID pool nella SendTextMessage richiesta, il servizio seleziona solo le identità di origine da quel pool. Poiché tutte le identità del pool sono registrate per lo stesso caso d'uso, il messaggio di riserva viene sempre inviato da un numero appropriato.
| Approccio di invio | Comportamento alternativo degli SMS | Rischio di conformità |
|---|---|---|
| Pool-based (consigliato) | Richiede un numero di telefono nello stesso pool, registrato per lo stesso caso d'uso | Basso: il numero di riserva corrisponde al caso d'uso del messaggio |
| Account-level | Richiama qualsiasi numero di telefono dedicato o ID mittente disponibile nell'account. Non ricorre a percorsi condivisi. | Alto: il numero di riserva potrebbe non corrispondere al caso d'uso del messaggio se più casi d'uso condividono l'account |
| Diretto (AWS RCS Agent ARN) | Nessun fallback via SMS | Nessuno: il messaggio viene recapitato solo tramite RCS o non viene recapitato affatto |
Logica di fallback e ordine di priorità
Quando AWS End User Messaging seleziona un'identità di origine per un messaggio (da un pool o da tutte le identità degli account), valuta le identità nel seguente ordine di priorità:
-
Identità permanente: se esiste un abbinamento di invio permanente per il numero di telefono di destinazione e l'identità è ancora disponibile, il servizio utilizza tale identità.
-
AWS RCS Agent: se non esiste un abbinamento permanente, il servizio tenta la consegna RCS tramite un agente AWS RCS disponibile.
-
Codice breve SMS: se RCS non è disponibile, il servizio seleziona un codice breve SMS.
-
SMS 10DLC: se non è disponibile alcun codice breve, il servizio seleziona un numero 10DLC.
-
Toll-Free Numero SMS: se non è disponibile alcun numero 10DLC, il servizio seleziona un numero verde.
-
ID mittente SMS: se non è disponibile nessun'altra identità, il servizio seleziona un ID mittente.
Questo ordine di priorità si applica nell'ambito del modello di invio utilizzato. Per l'invio basato su pool, il servizio considera solo le identità nel pool specificato. Per l'invio a livello di account, il servizio considera tutte le identità dell'account.
Fallback automatico degli SMS
Quando si invia un messaggio tramite un pool o a livello di account, la messaggistica per gli utenti AWS finali ritorna automaticamente agli SMS se la consegna RCS non è possibile. Il fallback è asincrono:
Se AWS End User Messaging invia correttamente il messaggio RCS ma non riceve una conferma di consegna o un segnale di errore entro 25 secondi, il servizio ritorna agli SMS. In questo modo vengono gestiti i casi in cui l'infrastruttura RCS accetta il messaggio ma la consegna si blocca (ad esempio, il dispositivo del destinatario è temporaneamente irraggiungibile, il corriere non supporta RCS o il dispositivo non lo è). RCS-capable
Nota
L'invio diretto (specificando un AWS RCS Agent ARN come identità di origine) non supporta il fallback automatico degli SMS. Se hai bisogno del fallback via SMS, utilizza l'invio basato su pool.
Invio permanente
L'invio permanente è un'ottimizzazione del routing che migliora la coerenza delle consegne. Quando AWS End User Messaging recapita correttamente un messaggio a un numero di telefono di destinazione utilizzando un'identità di origine specifica, il servizio ricorda tale associazione per 25 ore. I messaggi successivi verso la stessa destinazione entro la finestra di 25 ore vengono indirizzati attraverso la stessa identità di origine, a condizione che sia ancora disponibile nel pool o nell'account.
L'invio permanente si applica sia alla consegna RCS che agli SMS. Ad esempio, se un messaggio viene recapitato tramite RCS tramite il tuo agente AWS RCS, anche il messaggio successivo verso la stessa destinazione entro 25 ore viene tentato tramite RCS tramite lo stesso agente. Se il messaggio precedente è stato recapitato tramite SMS (dopo il fallback RCS), il messaggio successivo viene tentato tramite SMS utilizzando lo stesso numero di telefono.
Il servizio ritenta periodicamente la consegna RCS anche quando l'identità permanente è un numero di telefono SMS. Ciò garantisce che i destinatari i cui dispositivi ottengono il supporto RCS (ad esempio, dopo l'implementazione dell'operatore o l'aggiornamento del dispositivo) inizino a ricevere messaggi RCS senza intervento manuale.
Caratteristiche principali dell'invio permanente:
-
TTL di 25 ore: lo sticky pairing scade 25 ore dopo l'ultima consegna avvenuta con successo. Dopo la scadenza, il servizio rivaluta l'ordine di priorità dell'identità di origine per il messaggio successivo.
-
Riprova RCS automatica: anche quando l'identità permanente è un numero di telefono SMS, il servizio tenta periodicamente di recapitare RCS per verificare se il destinatario ora supporta RCS.
-
Nessun lavaggio manuale: non è possibile cancellare o reimpostare manualmente gli abbinamenti permanenti di invio. L'abbinamento scade automaticamente dopo il TTL di 25 ore.
Ricevute di consegna durante il fallback
Quando si verifica il fallback degli SMS, la messaggistica per l'utente AWS finale genera un'unica ricevuta di consegna per il canale finale che ha recapitato il messaggio. Se il messaggio viene recapitato tramite SMS dopo il fallback RCS, la ricevuta di recapito indica SMS come canale di consegna. È possibile determinare il canale di consegna ispezionando il originationPhoneNumber campo relativo all'evento. Se il valore è un ID agente RCS, il messaggio è stato recapitato tramite RCS. Se il valore è un numero di E.164 telefono o un codice breve, il messaggio è stato recapitato tramite SMS. Per ulteriori informazioni sui campi degli eventi, vedereEsempio AWS Dati degli eventi SMS di messaggistica per l'utente finale.
In circostanze normali, la messaggistica con l'utente AWS finale revoca il messaggio RCS prima che venga recapitato il messaggio di riserva SMS. Ciò impedisce al destinatario di ricevere lo stesso messaggio due volte. Tuttavia, in rari casi, possono essere recapitati sia il messaggio RCS che il messaggio di riserva SMS. Ciò può verificarsi se il messaggio RCS viene recapitato dopo il timeout di 25 secondi ma prima del completamento della revoca. In questi rari scenari di doppia consegna, potresti ricevere ricevute di consegna per entrambi i canali.
Per informazioni su come la doppia consegna influisce sulla fatturazione, consulta. Modello di fatturazione e prezzo RCS
Implicazioni sulla fatturazione del fallback via SMS
Quando un messaggio ritorna da RCS a SMS, ti viene addebitato il costo dell'invio degli SMS, non il tentativo RCS fallito. I messaggi RCS vengono fatturati solo se recapitati correttamente al dispositivo del destinatario. Se il recapito RCS non va a buon fine e il messaggio ritorna come SMS, paghi la tariffa SMS per quel messaggio.
In rari scenari di doppia consegna (in cui vengono recapitati sia il messaggio RCS che il messaggio di riserva SMS), è possibile che ti vengano addebitati entrambi i recapiti. Per i dettagli di fatturazione completi, consulta. Modello di fatturazione e prezzo RCS
Test del fallback degli SMS
Puoi testare il comportamento di fallback degli SMS per verificare che i tuoi messaggi vengano recapitati tramite SMS quando la consegna RCS non è possibile. Esistono due approcci per testare il fallback degli SMS, a seconda che si disponga di un numero di telefono SMS approvato.
Test senza un numero SMS approvato
È possibile verificare che la messaggistica con l'utente AWS finale attivi correttamente il meccanismo di fallback senza un numero di telefono SMS approvato. Anche senza un numero approvato, è possibile visualizzare gli eventi relativi ai tentativi e agli errori tramite SMS, a conferma del funzionamento del fallback.
Per testare il fallback degli SMS senza un numero SMS approvato
-
Metti offline il tuo dispositivo di test disattivando i dati mobili o Wi-Fi abilitando la modalità aereo.
-
Invia un messaggio RCS al dispositivo di test utilizzando l'
SendTextMessageAPI con il tuo AWS RCS Agent ARN come identità di origine. -
Controlla l'evento del messaggio CloudWatch o la destinazione dell'evento. Dovresti visualizzare un evento di consegna non riuscito che indica che la consegna RCS non è stata possibile e che il servizio ha tentato il fallback degli SMS.
Poiché non è disponibile alcun numero di telefono SMS per il fallback, anche l'invio degli SMS non riesce. Tuttavia, l'evento conferma che la messaggistica con l'utente AWS finale ha attivato correttamente il meccanismo di fallback.
Test con un numero SMS approvato
Per un test fallback completo degli SMS end-to-end, aggiungi un numero di telefono SMS approvato e il tuo agente AWS RCS allo stesso pool di telefoni. Ciò consente di verificare che i messaggi vengano recapitati tramite SMS quando RCS non è disponibile.
Per testare il fallback degli SMS con un numero SMS approvato
-
Crea un pool di telefoni che contenga sia il tuo agente AWS RCS che un numero di telefono SMS approvato (ad esempio un numero 10DLC, gratuito o con codice breve).
-
Metti offline il tuo dispositivo di prova disattivando i dati mobili o abilitando la modalità aereo Wi-Fi.
-
Invia un messaggio utilizzando l'
SendTextMessageAPI con l'ID del pool come identità di origine. -
Verifica che il messaggio venga recapitato tramite SMS al tuo dispositivo di test.
-
Controlla l'evento di recapito per confermare che il messaggio è stato recapitato tramite il canale SMS dopo il fallback RCS.
Gestione degli agenti AWS RCS nei pool
Per istruzioni dettagliate sulla creazione di pool con agenti AWS RCS, sull'aggiunta di agenti ai pool esistenti, sulla comprensione dei requisiti di configurazione dei pool e sulla rimozione di agenti dai pool, consulta. Gestione degli agenti AWS RCS nei pool