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 empêchant l'accès anticipé accidentel aux utilisateurs finaux.
Pour communiquer avec un agent RBM, un appareil de test doit être compatible avec le RCS. Notez que sur certains appareils Android, RCS est activé par défaut. Vous pouvez vérifier l'état du RCS sur votre appareil et, si nécessaire, activer le RCS en configurant votre appareil avec des versions préliminaires des applications Messages et Carrier Services.
Lorsque votre appareil est compatible 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 et répondre aux messages de votre agent non lancé.
Un agent peut envoyer 20 requêtes de testeur par jour, avec un total maximal de 200 requêtes de testeur. 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 du RCS sur votre appareil
- Dans l'application Messages, accédez à Paramètres de Messages.
- Appuyez sur Chats RCS. Si l'option "Chats RCS" ne s'affiche pas, appuyez sur Fonctionnalités de chat.
Recherchez la valeur État.
Si l'état Status (État) indique Connected (Connecté), le RCS est actif sur votre appareil.
Étapes suivantes
Si le RCS est activé sur votre appareil, vous pouvez envoyer une requête de testeur. Si le RCS est inactif sur votre appareil, vous devez l'activer avant de pouvoir commencer à tester votre agent RBM avec celui-ci.
Activer le RCS sur votre appareil
Pour activer le RCS sur un appareil Android, activez les chats RCS dans l'application Messages.
Étapes suivantes
Une fois le RCS activé sur votre appareil, vous pouvez envoyer une requête de test.
Envoyer une requête de testeur
Pour inviter un appareil compatible avec le RCS à devenir testeur, vous devez envoyer 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 avec le RCS, n'a pas répondu à la requête du testeur ou refuse la requête, 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
- Ouvrez la console pour les développeurs de communications d'entreprise, connectez-vous avec votre compte Google RBM, puis cliquez sur votre agent.
- Dans le panneau de navigation de gauche, cliquez sur Appareils.
- 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 indique l'état de la requête du testeur pour chaque appareil que vous invitez à tester votre agent.
Option 2: Envoyer une demande 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 -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 --jsonPATH_TO_SERVICE_ACCOUNT_KEY rcsbusinessmessaging`"
// 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);
});
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();
}
# 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 ')
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 ");
Étapes suivantes
Une fois que l'appareil a accepté la demande du testeur, il devient 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 qui sont en transit vers l'appareil de test ou qui y sont stockés.
- Ouvrez la console pour les développeurs de communications d'entreprise, connectez-vous avec votre compte Google RBM, puis cliquez sur votre agent.
- Dans le panneau de navigation de gauche, cliquez sur Appareils.
- Recherchez l'appareil dans la liste Liste des appareils de test, puis cliquez sur le menu de cet élément de liste.
- Cliquez sur Supprimer l'appareil.