Method: phones.getCapabilities

Recebe as funcionalidades relacionadas ao RBM de um usuário.

O payload retornado especifica se um usuário pode ser contatado com o RBM e, em caso afirmativo, quais recursos do RBM ele oferece suporte.

Tratamento de erros: um erro 404 NOT_FOUND é retornado quando não é possível entrar em contato com o usuário usando o RBM. Isso inclui vários cenários: (1) O dispositivo do usuário não é compatível com o RCS ou ele está desativado. (2) O usuário está em uma rede móvel em que o agente não é iniciado ou em que o tráfego do RCS não está ativado. (3) Um agente não lançado solicita os recursos de um usuário que não é um testador.

Solicitação HTTP

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

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
name

string

Esse campo é resolvido como "phones/{E.164}/capabilities", em que {E.164} é o número de telefone do usuário no formato E.164. Por exemplo, para um usuário com o número de telefone dos EUA +1-222-333-4444, o endpoint resultante é https://rcsbusinessmessaging.googleapis.com/v1/phones/+12223334444/capabilities.

Parâmetros de consulta

Parâmetros
requestId

string

O ID exclusivo da solicitação, atribuído pelo agente. Precisa ser um UUID, conforme definido em https://tools.ietf.org/html/rfc4122. Se o ID da solicitação corresponder a um ID usado pelo agente em uma solicitação anterior, a plataforma RBM vai ignorar a nova solicitação.
agentId

string

Obrigatório. O identificador exclusivo do agente.

Corpo da solicitação

O corpo da solicitação precisa estar vazio.

Corpo da resposta

Lista de recursos compatíveis com o usuário

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Representação JSON 
{
  "features": [
    enum (Feature)
  ]
}
Campos
features[]

enum (Feature)

Lista de recursos do RBM compatíveis com este dispositivo.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte o OAuth 2.0 Overview.

Recurso

Tipos de recursos do RBM compatíveis com o usuário.

Enums
FEATURE_UNSPECIFIED Não especificado.
RICHCARD_STANDALONE Rich Cards independentes.
ACTION_CREATE_CALENDAR_EVENT Ação sugerida para criar um evento na agenda.
ACTION_DIAL Ação sugerida para discar um número.
ACTION_OPEN_URL Ação sugerida para abrir um URL no navegador.
ACTION_SHARE_LOCATION Ação sugerida para compartilhar um local.
ACTION_VIEW_LOCATION Ação sugerida para ver um local em um app de mapas.
ACTION_OPEN_URL_IN_WEBVIEW Ação sugerida para abrir um URL no WebView.