Method: phones.testers.create

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

string

"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

string

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.