Method: phones.getCapabilities

Obtiene las capacidades relacionadas con RBM de un usuario.

La carga útil devuelta especifica si se puede comunicar con un usuario a través de RBM y, si es así, qué funciones de RBM admite el usuario.

Control de errores: Se devuelve un error 404 NOT_FOUND cuando no se puede comunicar con el usuario a través de RBM. Esto incluye varias situaciones: (1) El dispositivo del usuario no admite RCS o tiene inhabilitados los RCS. (2) El usuario se encuentra en una red móvil en la que no se inicia el agente o en la que no está habilitado el tráfico de RCS. (3) Un agente no lanzado solicita las capacidades de un usuario que no es verificador.

Solicitud HTTP

GET https://rcsbusinessmessaging.googleapis.com/v1/{name=phones/*}/capabilities

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
name

string

Este campo se resuelve como "phones/{E.164}/capabilities", donde {E.164} es el número de teléfono del usuario en formato E.164. Por ejemplo, para un usuario con el número de teléfono de EE.UU. +1-222-333-4444, el extremo resultante es https://rcsbusinessmessaging.googleapis.com/v1/phones/+12223334444/capabilities.

Parámetros de consulta

Parámetros
requestId

string

Es el ID único de la solicitud, asignado por el agente. Debe ser un UUID, según se define en https://tools.ietf.org/html/rfc4122. Si el ID de la solicitud coincide con un ID que el agente usó para una solicitud anterior, la plataforma de RBM ignora la nueva solicitud.
agentId

string

Es obligatorio. Es el identificador único del agente.

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Lista de funciones compatibles con el usuario

Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:

Representación JSON 
{
  "features": [
    enum (Feature)
  ]
}
Campos
features[]

enum (Feature)

Es una lista de las funciones de RBM que admite este dispositivo.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

  • https://www.googleapis.com/auth/rcsbusinessmessaging

Para obtener más información, consulta OAuth 2.0 Overview.

Función

Son los tipos de funciones de RBM que admite el usuario.

Enumeraciones
FEATURE_UNSPECIFIED No se especifica.
RICHCARD_STANDALONE Tarjetas enriquecidas independientes.
ACTION_CREATE_CALENDAR_EVENT Es la acción sugerida para crear un evento de calendario.
ACTION_DIAL Es la acción sugerida para marcar un número.
ACTION_OPEN_URL Es la acción sugerida para abrir una URL en el navegador.
ACTION_SHARE_LOCATION Es la acción sugerida para compartir una ubicación.
ACTION_VIEW_LOCATION Acción sugerida para ver una ubicación en una app de mapas.
ACTION_OPEN_URL_IN_WEBVIEW Es la acción sugerida para abrir una URL en WebView.