Invite un utilisateur à tester un agent.
L'utilisateur invité doit être compatible avec RCS et joignable par la plate-forme RBM. Lorsqu'un agent invite un utilisateur à devenir testeur, un agent de gestion de la plate-forme RBM lui envoie un message lui demandant de confirmer qu'il souhaite tester l'agent. Une fois la confirmation de l'utilisateur reçue, il devient testeur.
Un agent qui n'a pas encore été lancé ne peut interagir qu'avec les utilisateurs qui sont des testeurs de cet agent. Si un agent non lancé tente d'envoyer un message, un événement ou un rappel de capacité à un utilisateur qui n'est pas un testeur, la plate-forme RBM renvoie une erreur 403 PERMISSION_DENIED.
Un agent peut envoyer 20 demandes de testeur par jour, avec un maximum de 200 demandes de testeur au total. Si vous envoyez des requêtes de testeur au-delà de ces limites, la plate-forme RBM renvoie une réponse 429 RESOURCE_EXHAUSTED.
Requête HTTP
POST https://rcsbusinessmessaging.googleapis.com/v1/{parent=phones/*}/testers
L'URL utilise la syntaxe de transcodage gRPC.
Paramètres de chemin d'accès
| Paramètres | |
|---|---|
parent |
"phones/{E.164}", où {E.164} est le numéro de téléphone de l'utilisateur au format E.164. Par exemple, avec le numéro de téléphone américain +1-222-333-4444, le point de terminaison obtenu serait https://rcsbusinessmessaging.googleapis.com/v1/phones/+12223334444/testers/. |
Paramètres de requête
| Paramètres | |
|---|---|
agentId |
Obligatoire. Identifiant unique de l'agent. |
Corps de la requête
Le corps de la requête contient une instance de Tester.
Corps de la réponse
Si la requête aboutit, le corps de la réponse contient une nouvelle instance de Tester.
Niveaux d'accès des autorisations
Requiert le niveau d'accès OAuth suivant :
https://www.googleapis.com/auth/rcsbusinessmessaging
Pour plus d'informations, consultez la OAuth 2.0 Overview.