Invita a un usuario a probar un agente.
El usuario invitado debe tener habilitados los RCS y la plataforma de RBM debe poder comunicarse con él. Cuando un agente invita a un usuario a convertirse en verificador, un agente de administración de la plataforma de RBM le envía un mensaje al usuario para pedirle que confirme que quiere ser verificador del agente. Una vez que el usuario confirma, se convierte en verificador.
Un agente que aún no se lanzó solo puede interactuar con los usuarios que son verificadores de ese agente. Si un agente no lanzado intenta enviar un mensaje, un evento o una devolución de llamada de capacidad a un usuario que no es verificador, la plataforma de RBM devuelve un error 403 PERMISSION_DENIED
.
Un agente puede enviar 20 solicitudes de verificador por día, con un máximo total de 200 solicitudes de verificador. Si envías solicitudes de verificador que superan esos límites, la plataforma de RBM devolverá una respuesta 429 RESOURCE_EXHAUSTED
.
Solicitud HTTP
POST https://rcsbusinessmessaging.googleapis.com/v1/{parent=phones/*}/testers
La URL usa la sintaxis de la transcodificación gRPC.
Parámetros de ruta de acceso
Parámetros | |
---|---|
parent |
"phones/{E.164}", donde {E.164} es el número de teléfono del usuario en formato E.164. Por ejemplo, con el número de teléfono de EE.UU. +1-222-333-4444, el extremo resultante sería https://rcsbusinessmessaging.googleapis.com/v1/phones/+12223334444/testers/. |
Parámetros de consulta
Parámetros | |
---|---|
agentId |
Obligatorio. Es el identificador único del agente. |
Cuerpo de la solicitud
El cuerpo de la solicitud contiene una instancia de Tester
.
Cuerpo de la respuesta
Si el proceso se realiza de forma correcta, el cuerpo de la respuesta contiene una instancia recién creada de Tester
.
Permisos de autorización
Requiere el siguiente permiso de OAuth:
https://www.googleapis.com/auth/rcsbusinessmessaging
Para obtener más información, consulta OAuth 2.0 Overview.