Invite un utilisateur à tester un agent.
L'utilisateur invité doit être compatible avec le RCS et joignable via la plate-forme RCS for Business. Lorsqu'un agent invite un utilisateur à devenir testeur, un agent de gestion de la plate-forme RCS for Business lui envoie un message lui demandant de confirmer qu'il souhaite devenir testeur de l'agent. Une fois que l'utilisateur a confirmé, il devient un 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 fonctionnalité à un utilisateur qui n'est pas un testeur, la plate-forme RCS pour les entreprises 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 demandes de testeur au-delà de ces limites, la plate-forme RCS for Business renvoie une réponse 429 RESOURCE_EXHAUSTED.
Obsolète : cette méthode sera obsolète le 31 janvier 2026. Pour en savoir plus, consultez la nouvelle méthode Testers de l'API Business Communications.
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.