Invite un utilisateur à tester un agent.
L'utilisateur invité doit être compatible avec le 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 pour lui demander de confirmer qu'il souhaite faire partie des testeurs de l'agent. Une fois que l'utilisateur a confirmé, il devient testeur.
Un agent qui n'a pas encore été lancé ne peut interagir qu'avec les utilisateurs qui sont testeurs de cet agent. Si un agent non lancé tente d'envoyer un message, un événement ou un rappel de fonctionnalité à un non-testeur, la plate-forme RBM renvoie une erreur 403 PERMISSION_DENIED.
Un agent peut envoyer 20 demandes de test par jour, pour un total maximal de 200 demandes de testeur. Si les requêtes que vous envoyez aux testeurs dépassent 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} correspond au 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 est 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 Tester.
Corps de la réponse
Si la requête aboutit, le corps de la réponse contient une nouvelle instance de Tester.
Champs d'application des autorisations
Requiert le niveau d'accès OAuth suivant :
https://www.googleapis.com/auth/rcsbusinessmessaging
Pour en savoir plus, consultez la présentation d'OAuth 2.0.