Method: phones.getCapabilities

Acessar os recursos relacionados ao RBM de um usuário.

O payload retornado especifica se um usuário pode ser alcançado com o RBM e, em caso afirmativo, a quais recursos do RBM o usuário oferece suporte. Se não for possível entrar em contato com o usuário com o RBM, a plataforma retornará 404 NOT_FOUND.

Um agente que não foi iniciado só pode solicitar recursos para usuários que são testadores. Se um agente não lançado solicitar os recursos de um não testador, a plataforma RBM retornará 403 PERMISSION_DENIED.

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

Este 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 (em inglês). Se o ID da solicitação corresponder a um ID usado pelo agente em uma solicitação anterior, a plataforma RBM 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 a Visão geral do OAuth 2.0.

Recurso

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

Enums
FEATURE_UNSPECIFIED Não especificado.
REVOCATION Revogação. Se o usuário aceitar a revogação, o agente poderá revogar uma mensagem enviada antes de ser entregue pela plataforma RBM.
RICHCARD_STANDALONE Rich cards autônomos.
ACTION_CREATE_CALENDAR_EVENT Ação sugerida para criar um evento da agenda.
ACTION_DIAL Ação sugerida de discar um número.
ACTION_OPEN_URL Ação sugerida para abrir um URL.
ACTION_SHARE_LOCATION Ação sugerida para compartilhar um local.
ACTION_VIEW_LOCATION Ação sugerida para visualizar um local em um app de mapa.