Pular para o conteúdo principal

RCS - Capability Check

  • Atualizado

O que é

O Capability Check serve para verificar se o dispositivo de um usuário está ativado para RCS e pode se comunicar com um agente do RBM. Ele identifica quais recursos um dispositivo oferece, e se houver disponibilidade, permite que o agente personalize a conversa de acordo com as funcionalidades do dispositivo e evite apresentar interações difíceis ou impossíveis de serem concluídas pelo usuário.

Obs.: Se o dispositivo de um usuário não for capaz de receber mensagens RCS, você poderá se comunicar com ele por outros serviços, como SMS/MMS.

Documentação oficial do Google: Verificações de capacidade. 

 

Como utilizar 

Ao enviar um arquivo com os números que devem receber mensagens, é necessário conferir cada número para evitar o envio de mensagens desnecessárias. Na plataforma, essa conferência acontece automaticamente no momento em que as mensagens estão sendo enviadas.

O envio é feito por um command para a plataforma usando a seguinte estrutura:

Onde encontrar a URI de comandos: 

 

Como realizar a chamada

A requisição deve ser enviada da seguinte forma: 

  • YOUR_TOKEN é a chave de autorização do seu bot.

  • PHONE_NUMBER é o número do usuário a ser validado. Ele deve estar na sua forma completa com +, DDI, DDD e o número.

Ponto de atenção: Não se esqueça de adicionar o sinal de "+" (mais) antes de enviar.

Exemplo: +5531988889999 

POST https://{ORGANIZATION_ID}.http.msging.net/commands HTTP/1.1
Content-Type: application/json
Authorization: Key {YOUR_TOKEN}
{
"id": "{{$guid}}",
"to": "postmaster@googlercs.gw.msging.net",
"method": "get",
"uri": "lime://wa.gw.msging.net/accounts/{PHONE_NUMBER}"
}

No caso de requisições em lote, o limite é de 1000 números. Caso haja uma quantidade maior, realize a quebra e envie em lotes.

POST https://{ORGANIZATION_ID}.http.msging.net/commands HTTP/1.1
Content-Type: application/json
Authorization: Key {YOUR_TOKEN}
{
"id": "{{$guid}}",
"to": "postmaster@googlercs.gw.msging.net",
"method": "get",
"uri": "lime://wa.gw.msging.net/accounts?identities=+5531988889999;+553198887777"

Retorno da chamada

Essa chamada retornará os números que suportam o RCS acrescentadas de mais duas informações: 

  1. totalRandomSampleUserCount: representa a contagem de uma amostra aleatória de números especificados. Normalmente, cerca de 75% dos números especificados. 

  2. reachableRandomSampleUserCount: representa a contagem de números da amostra aleatória que podem ser alcançados por RBM em todas as operadoras, independente de quais operadoras o agente é lançado. Essa contagem é usada para fornecer uma estimativa aproximada do número total de usuários alcançáveis em todas as operadoras.

 


Para mais informações, acesse a discussão sobre o assunto em nossa comunidade ou os vídeos no nosso canal. 😃
 

Artigos relacionados