Configura un dispositivo di prova

Finché non avvii il tuo agente, quest'ultimo può comunicare solo con i dispositivi di test designati. In questo modo puoi testare il tuo agente internamente per impedire l'accesso anticipato accidentale agli utenti finali.

Per comunicare con un agente RBM, un dispositivo di test deve essere abilitato a RCS. Tieni presente che su alcuni dispositivi Android RCS non è attivo per impostazione predefinita. Per controllare lo stato di RCS del tuo dispositivo, consulta Controllare lo stato di RCS del dispositivo.

Gli agenti possono inviare un massimo di 20 inviti ai tester al giorno, con un limite totale di 200 inviti.

Controllare lo stato di RCS del dispositivo

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

Se il tuo dispositivo non supporta RCS, attiva RCS configurando il tuo dispositivo con le versioni pre-release delle app Messaggi e Servizi operatore.

Se il tuo dispositivo supporta RCS, puoi inviare un invito per i test. Quando il dispositivo accetta l'invito, può iniziare a inviare messaggi al tuo agente non ancora lanciato.

Attivare RCS sul dispositivo

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

Quando RCS è attivo sul tuo dispositivo, puoi inviare un invito ai tester.

Inviare un invito ai tester

Per invitare un dispositivo compatibile con RCS a diventare tester, invia un invito. Quando il dispositivo accetta l'invito, l'agente può inviare messaggi, eventi e richieste al dispositivo.

Se il dispositivo non è abilitato a RCS, non ha risposto all'invito del tester o rifiuta l'invito, l'agente riceverà un errore 403 PERMISSION_DENIED quando tenta di comunicare con il dispositivo.

Console

Per inviare un invito ai tester con la Developer Console di Business Communications:

  1. Apri Business Communications Developer Console, accedi con il tuo Account Google RBM e fai clic sul tuo agente.
  2. Nel menu a sinistra, seleziona Dispositivi.
  3. Aggiungi un dispositivo di test all'elenco dei dispositivi di test inserendo il numero di telefono del dispositivo, inclusi il codice paese e il prefisso. Per aggiungere più numeri di telefono, separali con delle virgole.

Quando un dispositivo viene aggiunto all'elenco, viene inviato un invito. L'utente vede il messaggio di invito sul proprio dispositivo e ha la possibilità di accettarlo o rifiutarlo.

L'elenco dei dispositivi di test mostra lo stato dell'invito per ogni dispositivo che inviti a testare il tuo agente.

API

Per inviare un invito ai tester con l'API RBM Management:

  • Utilizza il seguente codice. Per le opzioni di formattazione e valore, vedi testers.

cURL

curl -X POST "https://businesscommunications.googleapis.com/v1/testers" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/rcs-business-messaging" \
-H "`oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY businesscommunications`" \
-d '{"phone_number": "PHONE_NUMBER", "agentId": "AGENT_ID"}'

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 campione 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("+12223334444");
} catch(Exception e) {
   e.printStackTrace();
}
 Questo codice è un estratto di un agente campione 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 campione 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 campione RBM.

Se invii più di 200 inviti, la piattaforma RBM restituisce il codice di errore 429 RESOURCE_EXHAUSTED in risposta.

Inviare di nuovo un invito per i tester

Se necessario, puoi inviare nuovamente un invito ai tester. Il risultato dipende dallo stato dell'invito attuale del dispositivo.

Stato del dispositivo Risultato
PENDING L'invito al test viene inviato al dispositivo.
ACCEPTED L'invito al test non viene inviato al dispositivo, che mantiene lo stato ACCEPTED.
DECLINED L'invito al test è stato rifiutato. Prima di inviare nuovamente un invito, devi rimuovere il dispositivo di test. In caso contrario, la richiesta non va a buon fine.

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

Recuperare lo stato dell'invito di un dispositivo di test

Quando inviti un tester, quest'ultimo può accettare o rifiutare l'invito sul proprio dispositivo. Puoi eseguire una query sull'API per lo stato dell'invito del dispositivo.

Console

Per ottenere lo stato dell'invito di un dispositivo di test con la console per sviluppatori di Business Communications:

  1. Apri Business Communications Developer Console, accedi con il tuo Account Google RBM e fai clic sul tuo agente.
  2. Nel menu a sinistra, seleziona Dispositivi.
  3. Aggiungi un dispositivo di test all'elenco dei dispositivi di test inserendo il numero di telefono del dispositivo, inclusi il codice paese e il prefisso. Per aggiungere più numeri di telefono, separali con delle virgole.

Quando un dispositivo di test viene aggiunto all'elenco, puoi controllarne lo stato nella colonna Stato.

API

Per ottenere lo stato dell'invito di un dispositivo di test con l'API RBM Management:

  • Utilizza il seguente codice. Per le opzioni di formattazione e valore, vedi testers.

cURL

curl -X GET "https://businesscommunications.googleapis.com/v1/testers/PHONE_NUMBER?agentId=AGENT_ID" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/rcs-business-messaging" \
-H "`oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY businesscommunications`"

Visualizzare lo stato di tutti i dispositivi di test

Puoi eseguire query sullo stato dell'invito di tutti i dispositivi che hai invitato a diventare tester.

Console

Per controllare lo stato dell'invito di tutti i dispositivi di test con la Business Communications Developer Console:

  1. Apri Business Communications Developer Console, accedi con il tuo Account Google RBM e fai clic sul tuo agente.
  2. Nel menu a sinistra, seleziona Dispositivi.
  3. Aggiungi un dispositivo di test all'elenco dei dispositivi di test inserendo il numero di telefono del dispositivo, inclusi il codice paese e il prefisso. Per aggiungere più numeri di telefono, separali con delle virgole.

Quando un dispositivo di test viene aggiunto all'elenco, puoi controllarne lo stato nella colonna Stato.

API

Per controllare lo stato dell'invito di tutti i dispositivi di test con l'API RBM Management:

  • Utilizza il seguente codice. Per le opzioni di formattazione e valore, vedi testers.

cURL

curl -X GET "https://businesscommunications.googleapis.com/v1/testers?agentId=AGENT_ID" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/rcs-business-messaging" \
-H "`oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY businesscommunications`"

Rimuovere un dispositivo di prova

Quando rimuovi un dispositivo di test, questo non può più ricevere messaggi dal tuo agente non lanciato. La piattaforma RBM non elimina i messaggi inviati dal tuo agente che sono in transito o archiviati sul dispositivo di test.

Console

Per rimuovere un dispositivo di test con la Business Communications Developer Console:

  1. Apri Business Communications Developer Console, accedi con il tuo Account Google RBM e fai clic sul tuo agente.
  2. Nel menu a sinistra, seleziona Dispositivi.
  3. Seleziona il dispositivo nell'elenco dei dispositivi di test e fai clic sul menu .
  4. Fai clic su Rimuovi dispositivo.

API

Per rimuovere un dispositivo di test con l'API RBM Management:

  • Utilizza il seguente codice. Per le opzioni di formattazione e valore, vedi testers.

cURL

curl -X DELETE "https://businesscommunications.googleapis.com/v1/testers/PHONE_NUMBER?agentId=AGENT_ID" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/rcs-business-messaging" \
-H "`oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY businesscommunications`"
Indietro
Modifica informazioni agente
Avanti
Link diretti