Dispositivi di test

Finché non viene lanciato, l'agente può comunicare solo con i dispositivi di test designati. Ciò consente di testare internamente l'agente evitando l'accesso accidentale in anteprima agli utenti finali.

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

Quando il tuo dispositivo è abilitato per RCS, puoi inviare una richiesta di test per invitare il dispositivo a testare l'agente. Una volta che il dispositivo accetta la richiesta, potrà ricevere e rispondere ai messaggi dal tuo agente senza autorizzazioni.

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

Controlla lo stato RCS del tuo 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 (Stato).

    Se lo Stato è Connesso, RCS è attivo sul tuo dispositivo.

Passaggi successivi

Se RCS è attivo sul tuo dispositivo, puoi inviare una richiesta di test. Se RCS non è attivo sul tuo dispositivo, devi abilitarlo sul dispositivo prima di poter iniziare a testare l'agente RBM.

Attiva RCS sul tuo dispositivo

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

Passaggi successivi

Dopo aver attivato RCS sul tuo dispositivo, puoi inviare una richiesta di test.

Invia una richiesta di verifica

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

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

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

  1. Apri la Console per gli sviluppatori Business Communications, accedi con il tuo Account Google RBM e fai clic sull'agente.
  2. Nel menu di navigazione a sinistra, fai clic su Dispositivi.
  3. In 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 che inviti a testare il tuo agente.

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

Il codice seguente invia una richiesta di verifica. 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('../libs/rbm_api_helper');

// Send the tester invite to the device
rbmApiHelper.sendTesterInvite('+12223334444', function(response) {
   console.log(response);
});
Questo codice è un estratto di un agente di esempio RBM.

Java

import com.google.rbm.samples.lib.RbmApiHelper;
…

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

   // Register the device as a tester
   rbmApiHelper.registerTester("+12223334444");
} catch(Exception e) {
   e.printStackTrace();
}
Questo codice è un estratto di un agente di esempio RBM.

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('+12223334444')
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("+12223334444");
Questo codice è un estratto di un agente di esempio RBM.

Passaggi successivi

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

Rimuovere un dispositivo di test

Un dispositivo di test rimosso non può più ricevere messaggi dall'agente non avviato. La piattaforma RBM non elimina i messaggi inviati dall'agente in transito o archiviati sul dispositivo di test.

  1. Apri la Console per gli sviluppatori Business Communications, accedi con il tuo Account Google RBM e fai clic sull'agente.
  2. Nel menu di navigazione a sinistra, fai clic su Dispositivi.
  3. Individua il dispositivo in Testa elenco dispositivi e fai clic sul menu per l'elemento in questione.
  4. Fai clic su Rimuovi dispositivo.