Configurer un appareil 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 pour éviter tout 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 le protocole RCS n'est pas activé par défaut sur certains appareils Android. Pour vérifier l'état du protocole RCS sur votre appareil, consultez Vérifier l'état du protocole RCS sur votre appareil.

Les agents peuvent envoyer un maximum de 20 invitations de testeurs par jour, avec une limite totale de 200 invitations.

Vérifier l'état du RCS sur votre appareil

  1. Dans l'application Messages, accédez à Paramètres des messages.
  2. Appuyez sur Chats RCS. Si l'option "Chats RCS" ne s'affiche pas, appuyez sur Fonctionnalités de chat.
  3. Recherchez la valeur État.

Si votre appareil n'est pas compatible avec le RCS, activez le RCS en configurant votre appareil avec les versions préliminaires des applications Messages et Carrier Services.

Si votre appareil est compatible avec le RCS, vous pouvez envoyer une invitation à tester. Lorsque l'appareil accepte l'invitation, il peut commencer à échanger des messages avec votre agent non lancé.

Activer le protocole RCS sur votre appareil

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

Lorsque le protocole RCS est actif sur votre appareil, vous pouvez envoyer une invitation à un testeur.

Envoyer une invitation à un testeur

Pour inviter un appareil compatible avec le protocole RCS à devenir testeur, envoyez-lui une invitation. Lorsque l'appareil accepte l'invitation, votre agent peut lui envoyer des messages, des événements et des requêtes.

Si l'appareil n'est pas compatible avec RCS, n'a pas répondu à l'invitation du testeur ou a refusé l'invitation, votre agent recevra une erreur 403 PERMISSION_DENIED lorsqu'il tentera de communiquer avec l'appareil.

Console

Pour envoyer une invitation à un 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, puis cliquez sur votre agent.
  2. Dans le menu de gauche, sélectionnez Appareils.
  3. Ajoutez un appareil de test à la liste des appareils de test en saisissant son numéro de téléphone, y compris le code pays et l'indicatif. Pour ajouter plusieurs numéros de téléphone, séparez-les par des virgules.

Lorsqu'un appareil est ajouté à la liste, une invitation est envoyée. L'utilisateur voit le message d'invitation sur son appareil et peut l'accepter ou le refuser.

La liste des appareils de test indique l'état de l'invitation de testeur pour chaque appareil que vous invitez à tester votre agent.

API

Pour envoyer une invitation à un testeur avec l'API RBM Management :

  • Utilisez le code suivant. Pour connaître les options de mise en forme et de valeur, consultez 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);
});
 Ce code est un extrait d'un exemple d'agent 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();
}
 Ce code est un extrait 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 est un extrait 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 est un extrait d'un exemple d'agent RBM.

Si vous envoyez plus de 200 invitations, la plate-forme RBM renvoie le code d'erreur 429 RESOURCE_EXHAUSTED en réponse.

Renvoyer une invitation à un testeur

Si nécessaire, vous pouvez renvoyer une invitation à un testeur. Le résultat dépend de l'état actuel de l'invitation de l'appareil.

État de l'appareil Résultat
PENDING Une invitation de testeur est envoyée à l'appareil.
ACCEPTED L'invitation du testeur n'est pas envoyée à l'appareil, qui conserve son état ACCEPTED.
DECLINED L'invitation du testeur est refusée. Vous devez d'abord supprimer l'appareil de test avant de renvoyer une invitation. À défaut, la requête échoue.

Une fois que l'appareil a accepté l'invitation 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 des fonctionnalités à l'appareil pour tester les fonctionnalités et les workflows de votre agent.

Obtenir l'état de l'invitation d'un appareil de test

Lorsqu'un testeur reçoit une invitation, il peut l'accepter ou la refuser sur son appareil. Vous pouvez interroger l'API pour connaître l'état de l'invitation de l'appareil.

Console

Pour obtenir l'état de l'invitation d'un appareil de test avec la Business Communications Developer Console :

  1. Ouvrez la console pour les développeurs Business Communications, connectez-vous avec votre compte Google RBM, puis cliquez sur votre agent.
  2. Dans le menu de gauche, sélectionnez Appareils.
  3. Ajoutez un appareil de test à la liste des appareils de test en saisissant son numéro de téléphone, y compris le code pays et l'indicatif. Pour ajouter plusieurs numéros de téléphone, séparez-les par des virgules.

Lorsqu'un appareil de test est ajouté à la liste, vous pouvez vérifier son état dans la colonne État.

API

Pour obtenir l'état de l'invitation d'un appareil de test avec l'API RBM Management :

  • Utilisez le code suivant. Pour connaître les options de mise en forme et de valeur, consultez 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`"

Obtenir l'état de tous les appareils de test

Vous pouvez interroger l'état de l'invitation de tous les appareils que vous avez invités à participer aux tests.

Console

Pour vérifier l'état de l'invitation de tous les appareils de test 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, puis cliquez sur votre agent.
  2. Dans le menu de gauche, sélectionnez Appareils.
  3. Ajoutez un appareil de test à la liste des appareils de test en saisissant son numéro de téléphone, y compris le code pays et l'indicatif. Pour ajouter plusieurs numéros de téléphone, séparez-les par des virgules.

Lorsqu'un appareil de test est ajouté à la liste, vous pouvez vérifier son état dans la colonne État.

API

Pour vérifier l'état de l'invitation de tous les appareils de test avec l'API RBM Management :

  • Utilisez le code suivant. Pour connaître les options de mise en forme et de valeur, consultez 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`"

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.

Console

Pour supprimer un appareil de test avec la console Business Communications pour les développeurs :

  1. Ouvrez la console pour les développeurs Business Communications, connectez-vous avec votre compte Google RBM, puis cliquez sur votre agent.
  2. Dans le menu de gauche, sélectionnez Appareils.
  3. Sélectionnez l'appareil dans la liste des appareils de test, puis cliquez sur le menu .
  4. Cliquez sur Supprimer l'appareil.

API

Pour supprimer un appareil de test avec l'API RBM Management :

  • Utilisez le code suivant. Pour connaître les options de mise en forme et de valeur, consultez 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`"
Précédent
Modifier les informations sur l'agent
Suivant
Liens profonds