Method: phones.getCapabilities

Receber os recursos relacionados 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 aceita.

Processamento de erros: um erro 404 NOT_FOUND é retornado quando o usuário não pode ser alcançado com o RBM. Isso inclui cenários em que: o dispositivo do usuário não oferece suporte ao RCS ou o RCS está desativado, o usuário está em uma rede móvel em que o agente não foi iniciado ou o tráfego do RCS não está ativado, um agente não iniciado 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. Ele precisa ser um UUID, conforme definido em https://tools.ietf.org/html/rfc4122. Se o ID do pedido corresponder a um ID que o agente usou para 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 com suporte do 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 de RBM compatíveis com o dispositivo.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

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

Recurso

Tipos de recursos de RBM com suporte do 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 conferir um local em um app de mapas.
ACTION_OPEN_URL_IN_WEBVIEW Ação sugerida para abrir um URL na WebView.
ACTION_COMPOSE Ação sugerida para escrever uma mensagem de texto/áudio/vídeo.