View a markdown version of this page

Test dei messaggi RCS - AWS SMS di messaggistica per l'utente finale
Cos'è un agente di test?Aggiungere dispositivi di testFlusso di invito per i testerVisualizzazione dei dispositivi di testInvio di messaggi di testTest del fallback 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 ID RCS for Business 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 step-by-step procedura dettagliata sulla creazione del primo agente AWS RCS e sull'invio di un messaggio di prova, consulta. Guida introduttiva a RCS Per informazioni dettagliate sulla creazione di un agente AWS RCS e sull'invio di una registrazione di test, 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 l'invio 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 ti consente di:

  • Inviare messaggi RCS ai dispositivi di test registrati senza l'approvazione dell'operatore

  • 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 con l'utente AWS finale per il flusso di lavoro di test

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

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

I dispositivi di test registrati 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'agente addetto al test può inviare messaggi ai dispositivi di test in qualsiasi paese, indipendentemente dal fatto che tu abbia inviato una registrazione al lancio per quel paese.

Aggiungere dispositivi di test

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

Console

Nella console, i dispositivi di test vengono aggiunti come parte del flusso di lavoro di creazione di AWS RCS Agent. Per le istruzioni step-by-step sulla console, consultaFase 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. Quando 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 invito 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 pulsanti da accettare o rifiutare. Per i dettagli sul flusso di invito dei tester, incluso il requisito di attesa di 120 secondi e il comportamento specifico di iOS, consulta. Fase 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 dell'utente AWS finale 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 Testing. La scheda mostra 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 con 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 registrati 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 il tuo agente AWS RCS.

Invio di messaggi di test

Dopo che un dispositivo di test ha accettato l'invito del tester, puoi inviargli messaggi RCS. È possibile inviare messaggi di prova utilizzando la console di messaggistica dell'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 riquadro di navigazione, in Configurazioni, scegli Agenti RCS.

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

  4. Scegli la scheda Testing.

  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

Usa il send-text-message comando per inviare un messaggio di prova a un numero di destinazione verificato. Specificare l'ARN dell'agente AWS RCS 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 SMS

È possibile testare il comportamento di fallback degli SMS per verificare che i messaggi vengano recapitati tramite SMS quando la consegna RCS non è possibile. Per istruzioni complete sul test del fallback degli SMS, compresi i test senza un numero SMS approvato e il end-to-end flusso completo, 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 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 il canale SMS.

  • Verificate di inviare al numero di telefono corretto in formato E.164.

Messaggio inviato come SMS anziché RCS

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

  • Verifica di inviare il messaggio utilizzando l'ARN dell'agente AWS RCS o un pool che contiene l'agente AWS RCS come identità di origine. Se specifichi 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 e poi è passato a SMS o se è stato inviato direttamente tramite SMS.

Invito al tester non ricevuto

Se un dispositivo di test non riceve l'invito del tester, verifica quanto segue:

  • L'invito al tester può impiegare fino a 20 minuti per arrivare dopo aver aggiunto un dispositivo di prova. Se l'invito non è arrivato dopo 20 minuti, rimuovi il dispositivo di prova e aggiungilo di nuovo.

  • Verifica che il numero di telefono sia nel formato E.164 corretto e che 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 Unknown Senders

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 di RBM Tester Management e tocca Fammi un tester per accettare l'invito.