View a markdown version of this page

Test dei messaggi RCS - AWS Messaggistica SMS per l'utente finale
Cos'è un agente di test?Aggiungere dispositivi di testFlusso di inviti per i testerVisualizzazione dei dispositivi di testInvio di messaggi di testTest del fallback degli SMSRisoluzione dei problemi relativi ai test RCS

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

Test dei messaggi RCS

Prima di avviare la messaggistica RCS in produzione, puoi testare l'integrazione utilizzando un agente di test. L'agente di test è un RCS for Business ID che viene creato quando invii una registrazione di test per il tuo agente AWS RCS. Fornisce un accesso completo alle API identico a quello di produzione, ma limita la consegna dei messaggi solo ai dispositivi di test registrati. Per i test non è necessaria l'approvazione del corriere.

Questo capitolo si concentra sull'agente di test stesso, incluso come gestire i dispositivi di test e come risolvere i problemi più comuni. Per una procedura dettagliata sulla creazione del primo agente AWS RCS e sull'invio di un messaggio di prova, consulta. Nozioni di base su RCS Per informazioni dettagliate sulla creazione di un agente AWS RCS e sull'invio di una registrazione di prova, consulta. Gestione degli agenti RCS

Importante

I messaggi di test vengono addebitati secondo le tariffe RCS standard. L'agente di test fornisce un ambiente di test per convalidare l'integrazione, ma la consegna dei messaggi ai dispositivi di test comporta gli stessi costi dei messaggi di produzione.

Cos'è un agente di test?

Un agente di test è un ID RCS for Business che AWS End User Messaging crea quando invii una registrazione di test per il tuo agente AWS RCS. L'agente di test consente di:

  • Inviare messaggi RCS ai dispositivi di test registrati senza l'approvazione del corriere

  • Usa l'SendTextMessageAPI per inviare messaggi di test, la stessa API che usi in produzione

  • Configura pool, set di configurazione, elenchi di opt-out, parole chiave e altre funzionalità di messaggistica per gli utenti AWS finali per il tuo flusso di lavoro di test

  • Prova la messaggistica bidirezionale inviando messaggi con parole chiave a risposta automatica

  • Verifica il comportamento alternativo degli SMS con o senza un numero di telefono SMS approvato

I dispositivi di test che registri per un agente di test funzionano in tutti i paesi per quell'agente AWS RCS. Non è necessario registrare i dispositivi di test separatamente per ogni paese. Al contrario, l'addetto al test può inviare messaggi ai dispositivi di test in qualsiasi paese, indipendentemente dal fatto che tu abbia inviato una registrazione di lancio nazionale per quel paese.

Aggiungere dispositivi di test

Prima di poter inviare messaggi RCS di test, è necessario registrare uno o più dispositivi di test come numeri di destinazione verificati. È possibile aggiungere dispositivi di test utilizzando la console di messaggistica per l'utente AWS finale o l'CreateVerifiedDestinationNumberAPI.

Console

Nella console, i dispositivi di test sono gestiti nella sottoscheda di gestione dei tester RBM all'interno della scheda Testing dell'agente AWS RCS. Per istruzioni dettagliate sulla console, consulta. Passaggio 2: aggiungere un dispositivo di test

AWS CLI

Usa il create-verified-destination-number comando con il --rcs-agent-id parametro per registrare un dispositivo di test per il tuo agente AWS RCS:

aws pinpoint-sms-voice-v2 create-verified-destination-number \
    --destination-phone-number +12065550100 \
    --rcs-agent-id rcs-a1b2c3d4
Nota

Il parametro --origination-identity non è obbligatorio. Quando lo specifichi--rcs-agent-id, il comando registra il numero di telefono per il test RCS con quell'agente. Se si omette --rcs-agent-id e si utilizza --origination-identity invece, il comando invia un SMS OTP per la verifica tramite SMS. I due parametri si escludono a vicenda.

Flusso di inviti per i tester

Dopo aver aggiunto un dispositivo di test, AWS End User Messaging invia un invito al tester da un agente RCS chiamato RBM Tester Management. L'invito contiene i pulsanti per accettare o rifiutare. Per i dettagli sul flusso di inviti del tester, inclusi i requisiti di attesa di 120 secondi e il OS-specific comportamento dei tester, consulta. Passaggio 2: aggiungere un dispositivo di test

Visualizzazione dei dispositivi di test

Puoi visualizzare i dispositivi di test registrati per il tuo agente AWS RCS utilizzando la console di messaggistica per gli utenti AWS finali o l'DescribeVerifiedDestinationNumbersAPI.

Console

Per visualizzare i dispositivi di test registrati nella console, vai alla pagina dei dettagli del tuo agente AWS RCS e scegli la scheda Test. Scegli la sottoscheda RBM tester management per visualizzare tutti i numeri di destinazione verificati associati all'agente, inclusi lo stato di verifica e il numero di telefono.

AWS CLI

Usa il describe-verified-destination-numbers comando per elencare i dispositivi di test per il tuo agente AWS RCS. Usa il --filters parametro with rcs-agent-id per mostrare solo i dispositivi di test RCS:

aws pinpoint-sms-voice-v2 describe-verified-destination-numbers \
    --filters Name=rcs-agent-id,Values=rcs-a1b2c3d4

I dispositivi di test che registri per un agente di test funzionano a livello globale per quell'agente AWS RCS. Un dispositivo di test registrato in una AWS regione può ricevere messaggi di test inviati da qualsiasi AWS regione in cui è disponibile l'agente AWS RCS.

Invio di messaggi di test

Dopo che un dispositivo di test ha accettato l'invito al tester, è possibile inviargli messaggi RCS. È possibile inviare messaggi di test utilizzando la console di messaggistica per l'utente AWS finale o l'SendTextMessageAPI.

Console
Per inviare un messaggio di prova utilizzando la console

  1. Aprire la console di messaggistica per l'utente AWS finale.

  2. Nel pannello di navigazione, in Configurazioni, scegli Agenti RCS.

  3. Scegli l'agente AWS RCS che desideri testare.

  4. Scegli la scheda Test.

  5. Nella sezione Invia messaggio di prova, scegli un dispositivo di test verificato dall'elenco.

  6. Inserisci il testo del messaggio.

  7. Scegli Invia messaggio di prova.

AWS CLI

Utilizzate il send-text-message comando per inviare un messaggio di prova a un numero di destinazione verificato. Specifica l'AWS RCS Agent ARN come identità di origine:

aws pinpoint-sms-voice-v2 send-text-message \
    --destination-phone-number +12065550100 \
    --origination-identity arn:aws:sms-voice:us-east-1:123456789012:rcs-agent/rcs-a1b2c3d4 \
    --message-body "Hello from RCS testing!"

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. Per istruzioni complete su come testare il fallback degli SMS, compresi i test senza un numero SMS approvato e il flusso completo end-to-end, consulta. Test del fallback degli SMS

Risoluzione dei problemi relativi ai test RCS

Le sezioni seguenti descrivono i problemi più comuni che potrebbero verificarsi durante il test dei messaggi RCS e come risolverli.

Il dispositivo di test non riceve messaggi RCS

Se il dispositivo di test non riceve messaggi RCS, controlla quanto segue:

  • Verifica che il dispositivo di test abbia accettato l'invito del tester. Utilizza l'DescribeVerifiedDestinationNumbersAPI con il rcs-agent-id filtro per verificare lo stato di verifica del dispositivo.

  • Verifica che il dispositivo di test abbia l'RCS abilitato. Su Android, controlla le impostazioni dell'app di messaggistica per le funzionalità RCS o Chat. Su iPhone, RCS richiede iOS 18 o versioni successive.

  • Verifica che il dispositivo di test abbia una connessione dati attiva. I messaggi RCS vengono recapitati tramite dati, non tramite canale SMS.

  • Verifica di inviare al numero di telefono corretto nel E.164 formato.

Messaggio recapitato come SMS anziché RCS

Se il messaggio di prova viene recapitato come SMS anziché RCS, controlla quanto segue:

  • Verifica di inviare il messaggio utilizzando l'AWS RCS Agent ARN o un pool che contiene l'agente AWS RCS come identità di origine. Se si specifica solo un numero di telefono SMS, il messaggio viene inviato tramite SMS.

  • Verifica che il dispositivo di test abbia accettato l'invito del tester e sia registrato come numero di destinazione verificato per l'agente AWS RCS corretto.

  • Controlla l'evento di consegna per determinare se il messaggio è stato inizialmente tentato tramite RCS ed è tornato al formato SMS o se è stato inviato direttamente tramite SMS.

Invito al tester non ricevuto

Se un dispositivo di test non riceve l'invito al tester, controlla quanto segue:

  • L'arrivo dell'invito al tester può richiedere fino a 20 minuti dopo l'aggiunta di un dispositivo di test. Se l'invito non è arrivato dopo 20 minuti, rimuovi il dispositivo di test e aggiungilo nuovamente.

  • Verifica che il numero di telefono sia nel E.164 formato corretto e sia un numero di cellulare valido.

  • Verifica che il dispositivo di test abbia una connessione dati attiva e che RCS sia abilitato.

iOS: invito al tester in mittenti sconosciuti

Sui dispositivi iOS (iPhone con iOS 18 o versioni successive), l'invito al tester di RBM Tester Management può essere filtrato nella cartella Unknown Senders nell'app Messaggi. Si tratta di un comportamento iOS predefinito per i messaggi provenienti da contatti sconosciuti.

Per trovare l'invito:

Per trovare l'invito al tester su iOS

  1. Apri l'app Messaggi sull'iPhone.

  2. Tocca Filtri nell'angolo in alto a sinistra (o scorri verso destra dall'elenco dei messaggi).

  3. Tocca Mittenti sconosciuti.

  4. Cerca il messaggio RBM Tester Management e tocca Rendimi un tester per accettare l'invito.