Appareils de test

Tant que vous n'avez pas lancé votre agent, il ne peut communiquer qu'avec les appareils de test désignés. Cela vous permet de tester votre agent en interne tout en évitant un accès anticipé accidentel aux utilisateurs finaux.

Pour communiquer avec un agent RBM, un appareil de test doit être compatible RCS. Notez que RCS n'est pas activé par défaut sur certains appareils Android. Vous pouvez vérifier l'état RCS de votre appareil et, si nécessaire, l'activer en configurant les versions préliminaires des applications Messages et Carrier Services.

Lorsque votre appareil est compatible avec RCS, vous pouvez envoyer une requête de test pour l'inviter à tester votre agent. Une fois que l'appareil a accepté la requête, il peut recevoir les messages de votre agent non activé et y répondre.

Un agent peut envoyer 20 requêtes de testeur par jour, avec un total de 200 requêtes de testeur au maximum. Si vous ajoutez des testeurs via l'API RBM et que vous envoyez plus de 200 requêtes, la plate-forme RBM renvoie une réponse 429 RESOURCE_EXHAUSTED.

Vérifier l'état RCS de votre appareil

  1. Dans l'application Messages, accédez aux paramètres de Messages.
  2. Appuyez sur Chats RCS. Si vous ne trouvez pas l'option "Chats RCS", appuyez sur Fonctionnalités de chat.

  3. Recherchez la valeur État.

    Si l'état est Connecté, RCS est actif sur votre appareil.

Étapes suivantes

Si RCS est actif sur votre appareil, vous êtes prêt à envoyer une requête de testeur. Si RCS est inactif sur votre appareil, vous devez activer RCS sur votre appareil avant de pouvoir commencer à tester votre agent RBM.

Activer RCS sur votre appareil

Pour activer RCS sur un appareil Android, activez les chats RCS dans l'application Messages.

Étapes suivantes

Une fois RCS actif sur votre appareil, vous êtes prêt à envoyer une requête de test.

Envoyer une demande de testeur

Pour inviter un appareil compatible RCS à devenir testeur, envoyez une demande de testeur. Si l'appareil accepte la requête, votre agent peut lui envoyer des messages, des événements et des requêtes.

Si l'appareil n'est pas compatible RCS, n'a pas répondu à la requête de testeur ou la refuse, votre agent reçoit une erreur 403 PERMISSION_DENIED lorsqu'il tente de communiquer avec l'appareil.

Option 1: Envoyer une demande de testeur avec la console pour les développeurs Business Communications

  1. Ouvrez la Console pour les développeurs Business Communications, connectez-vous avec votre compte Google RBM et cliquez sur votre agent.
  2. Dans le panneau de navigation de gauche, cliquez sur Appareils.
  3. Pour Ajouter des appareils de test, saisissez le numéro de téléphone de votre appareil, puis cliquez sur Ajouter.

La liste des appareils de test détaille l'état de la demande de testeur pour chaque appareil que vous invitez à tester votre agent.

Option 2: Envoyer une requête de testeur avec l'API RBM

Le code suivant envoie une requête de testeur. Pour connaître les options de mise en forme et de valeur, consultez 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);
});
Ce code provient d'un exemple d'agent 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();
}
Ce code provient d'un exemple d'agent 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')
Ce code provient d'un exemple d'agent 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");
Ce code provient d'un exemple d'agent RBM.

Étapes suivantes

Une fois que l'appareil a accepté la requête de testeur, il s'agit d'un appareil de test désigné pour votre agent. Vous pouvez envoyer des messages, des événements et des vérifications de fonctionnalités à votre appareil pour tester les fonctionnalités et les workflows de votre agent.

Supprimer un appareil de test

Lorsque vous supprimez un appareil de test, il ne peut plus recevoir de messages de votre agent non lancé. La plate-forme RBM ne supprime pas les messages envoyés par votre agent en transit ou stockés sur l'appareil de test.

  1. Ouvrez la Console pour les développeurs Business Communications, connectez-vous avec votre compte Google RBM et cliquez sur votre agent.
  2. Dans le panneau de navigation de gauche, cliquez sur Appareils.
  3. Recherchez l'appareil dans la liste des appareils de test et cliquez sur le menu pour cet élément.
  4. Cliquez sur Supprimer l'appareil.