Method: phones.getCapabilities

Obtén las capacidades relacionadas con la RBM de un usuario.

La carga útil que se muestra especifica si se puede comunicar con un usuario con la RBM y, de ser así, qué funciones de la RBM admite el usuario. Si no se puede comunicar con el usuario con RBM, la plataforma de RBM muestra 404 NOT_FOUND.

Un agente que no se lanza solo puede solicitar capacidades para los usuarios que son verificadores de ese agente. Si un agente no lanzado solicita las capacidades de un no verificador, la plataforma de RBM muestra 403 PERMISSION_DENIED.

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 en "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 que asigna el agente. Debe ser un UUID, como 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 solicitud nueva.
agentId

string

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 la lista de funciones de RBM que admite este dispositivo.

Alcances de autorización

Requiere el siguiente alcance de OAuth:

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

Para obtener más información, consulta la descripción general de OAuth 2.0.

Función

Tipos de funciones de RBM que admite el usuario.

Enumeraciones
FEATURE_UNSPECIFIED No se especifica.
REVOCATION Revocación. Si el usuario admite la revocación, el agente puede revocar un mensaje que envió antes de que la plataforma de RBM entregue el mensaje.
RICHCARD_STANDALONE Tarjetas enriquecidas independientes.
ACTION_CREATE_CALENDAR_EVENT Acción sugerida para crear un evento de calendario.
ACTION_DIAL Acción sugerida para marcar un número.
ACTION_OPEN_URL Acción sugerida para abrir una URL en el navegador.
ACTION_SHARE_LOCATION 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 Acción sugerida para abrir una URL en WebView.
ACTION_COMPOSE Acción sugerida para redactar un mensaje de texto, audio o video.