Method: phones.testers.create

Invita a un usuario a probar un agente.

El usuario invitado debe tener habilitado el RCS y ser accesible a través de la plataforma de RCS para empresas. Cuando un agente invita a un usuario a convertirse en verificador, un agente de administración de la plataforma de RCS for Business 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 RCS para empresas 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 RCS for Business devolverá una respuesta 429 RESOURCE_EXHAUSTED.

Obsoleto: Este método quedará obsoleto el 31 de enero de 2026. Consulta el nuevo método Testers en la API de Business Communications para obtener más información.

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

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.