Dispositivi di test

Fino a quando avvia il tuo può comunicare solo con dispositivi di test designati. Questo consente di testare internamente l'agente evitando così l'accesso accidentale in anteprima per gli utenti finali.

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

Quando il dispositivo è abilitato per RCS, puoi inviare un tester richiesta di invitare il dispositivo a testare l'agente. Una volta accetta la richiesta, può ricevere e rispondere ai messaggi inviati non autorizzato.

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

Controllare lo stato RCS del dispositivo

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

    Se Stato è Connesso, RCS è attivo sul dispositivo.

Passaggi successivi

Se RCS è attivo sul tuo dispositivo, puoi inviare un tester richiesta. Se RCS non è attivo sul tuo dispositivo, devi attiva RCS sul tuo dispositivo prima di iniziare a testare il tuo RBM un agente.

Attivare RCS sul dispositivo

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

Passaggi successivi

Una volta che RCS è attivo sul tuo dispositivo, puoi inviare un tester richiesta.

Invia una richiesta di tester

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

Se il dispositivo non è abilitato per RCS, non ha risposto alla richiesta di tester o rifiuta la richiesta, l'agente riceve un 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 lo Sviluppatore di comunicazioni aziendali Console, accedi con il tuo Account Google RBM e fai clic sul tuo agente.
  2. Nel menu di navigazione a sinistra, fai clic su Dispositivi.
  3. In Aggiungi dispositivi di test, inserisci il numero di telefono del tuo dispositivo e fai clic su Aggiungi.

L'elenco dei dispositivi di test mostra in dettaglio lo stato della richiesta di tester per ogni dispositivo che invitato a testare l'agente.

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

Il seguente codice 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('+12223334444', function(response) {
   console.log(response);
});
Questo codice è un estratto di un agente RBM di esempio.

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

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 RBM di esempio.

Passaggi successivi

Dopo che il dispositivo accetta la richiesta di tester, viene definito un dispositivo di test per l'agente. Puoi inviare messaggi, eventi e controlli delle funzionalità al tuo dispositivo per testare la funzionalità e i flussi di lavoro dell'agente.

Rimuovere un dispositivo di test

Se rimuovi un dispositivo di test, quest'ultimo non potrà più ricevere messaggi da l'agente non lanciato. La piattaforma RBM non elimina i messaggi inviati dal tuo agente in transito verso o memorizzato sul dispositivo di test.

  1. Apri lo Sviluppatore di comunicazioni aziendali Console, accedi con il tuo Account Google RBM e fai clic sul tuo agente.
  2. Nel menu di navigazione a sinistra, fai clic su Dispositivi.
  3. Individua il dispositivo in Elenco dispositivi di test e fai clic sul pulsante Menu per l'elemento dell'elenco.
  4. Fai clic su Rimuovi dispositivo.