Dispositivi di test

Finché lanci l'agente, può comunicare solo con i dispositivi di test designati. In questo modo puoi testare l'agente internamente, evitando al contempo l'accesso accidentale in anteprima agli utenti finali.

Per comunicare con un agente RBM, un dispositivo di test deve essere abilitato per RCS. Tieni presente che su alcuni dispositivi Android non è abilitato RCS per impostazione predefinita. Puoi controllare lo stato RCS del tuo dispositivo e, se necessario, attivare RCS configurando il dispositivo con le versioni pre-release delle app Messaggi e Servizi operatore.

Se il tuo dispositivo supporta RCS, puoi inviare una richiesta di tester per invitarlo a testare il tuo agente. Una volta che il dispositivo accetta la richiesta, può ricevere e rispondere ai messaggi dall'agente non lanciato.

Un agente può inviare 20 richieste di tester ogni giorno per un totale massimo di 200 richieste di tester. Se aggiungi tester tramite l'API RBM e invii più di 200 richieste, la piattaforma RBM restituisce una risposta 429 RESOURCE_EXHAUSTED.

Nota: dopo il lancio, l'agente può comunicare con qualsiasi dispositivo abilitato al servizio RCS, non solo con i dispositivi di test.

Controllare lo stato RCS del dispositivo

1. Nell'app Messaggi, vai a Impostazioni di Messaggi.
2. Tocca Chat RCS. Se non riesci a trovare "Chat RCS", tocca Funzionalità di chat.

3. Trova il valore Status.

   Se lo stato è Connesso, significa che RCS è attivo sul tuo dispositivo.

Passaggi successivi

Se RCS è attivo sul tuo dispositivo, puoi inviare una richiesta di accesso come beta tester. Se RCS non è attivo sul tuo dispositivo, devi attivarlo prima di poter iniziare a testare l'agente RBM.

Attivare RCS sul dispositivo

Per attivare RCS su un dispositivo Android, attiva le chat RCS nell'app Messaggi.

Passaggi successivi

Una volta attivato RCS sul tuo dispositivo, puoi inviare una richiesta di tester.

Inviare una richiesta di tester

Per invitare un dispositivo con RCS abilitato a diventare un tester, invia una richiesta di tester. Se il dispositivo accetta la richiesta, l'agente può inviare messaggi, eventi e richieste al dispositivo.

Se il dispositivo non è compatibile con RCS, non ha risposto alla richiesta del tester o decline la richiesta, l'agente riceve un messaggio di errore 403 PERMISSION_DENIED quando tenta di comunicare con il dispositivo.

Opzione 1: invia una richiesta di tester con la Developer Console di Business Communications

1. Apri la Console per gli sviluppatori di Business Communications, accedi con il tuo Account Google RBM e fai clic sul tuo agente.
2. Nel riquadro di navigazione a sinistra, fai clic su Dispositivi.
3. Per Aggiungi dispositivi di test, inserisci il numero di telefono del dispositivo e fai clic su Aggiungi.

L'elenco dei dispositivi di test indica lo stato della richiesta del tester per ogni dispositivo invitato a testare l'agente.

Opzione 2: invia una richiesta di tester con l'API RBM

Il codice seguente invia una richiesta di tester. Per le opzioni di formattazione e valore, consulta phones.testers.

cURL

curl -X POST "https://REGION-rcsbusinessmessaging.googleapis.com/v1/phones/PHONE_NUMBER/testers" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/rcs-business-messaging" \
-H "`oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY rcsbusinessmessaging`"

Node.js

// Reference to RBM API helper
const rbmApiHelper = require('@google/rcsbusinessmessaging');

// Send the tester invite to the device
rbmApiHelper.sendTesterInvite('[phone]', function(response) {
   console.log(response);
});

Questo codice è un estratto di un agente di esempio RBM.

Java

import com.google.rbm.RbmApiHelper;
…

try {
   // Create an instance of the RBM API helper
   RbmApiHelper rbmApiHelper = new RbmApiHelper();

   // Register the device as a tester
   rbmApiHelper.registerTester("[phone]");
} catch(Exception e) {
   e.printStackTrace();
}

Questo codice è un estratto di un agente RBM di esempio.

Python

# Reference to RBM Python client helper
from rcs_business_messaging import rbm_service

# Send the tester invite to a device
rbm_service.invite_tester('[phone]')

Questo codice è un estratto di un agente di esempio RBM.

C#

using RCSBusinessMessaging;
…

// Create an instance of the RBM API helper
RbmApiHelper rbmApiHelper = new RbmApiHelper(credentialsFileLocation,
                                             projectId);

// Register the device as a tester
rbmApiHelper.RegisterTester("[phone]");

Questo codice è un estratto di un agente di esempio RBM.

Passaggi successivi

Dopo che il dispositivo ha accettato la richiesta del tester, diventa un dispositivo di test designato per il tuo agente. Puoi inviare messaggi, eventi e controlli delle funzionalità al tuo dispositivo per testare le funzionalità e i flussi di lavoro dell'agente.

Rimuovere un dispositivo di test

Quando rimuovi un dispositivo di test, quest'ultimo non può più ricevere messaggi dal tuo agente non lanciato. La piattaforma RBM non elimina i messaggi inviati dall'agente in transito verso o archiviati sul dispositivo di test.

1. Apri la console per gli sviluppatori di Business Communications, accedi con il tuo Account Google RBM e fai clic sul tuo agente.
2. Nel riquadro di navigazione a sinistra, fai clic su Dispositivi.
3. Individua il dispositivo nell'elenco dei dispositivi di test e fai clic sul menu per l'elemento dell'elenco.
4. Fai clic su Rimuovi dispositivo.