Skip to main content

RCS - Capability Check

  • Updated

What it is

The Capability Check is used to verify if a user's device is enabled for RCS and can communicate with an RBM agent. It identifies which features a device offers, and if availability exists, it allows the agent to customize the conversation according to the device's functionalities and avoid presenting interactions that are difficult or impossible for the user to complete. 

Note: If a user's device is not capable of receiving RCS messages, you can communicate with them through other services, such as SMS/MMS.

Google's official documentation: Capability checks.

 

How to use

When sending a file with the numbers that should receive messages, it is necessary to check each number to avoid sending unnecessary messages. On the platform, this check happens automatically at the moment the messages are being sent. 

The sending is done by a command to the platform using the following structure:

Where to find the command URI: 

How to perform the call 

The request must be sent as follows: 

  • YOUR_TOKEN is your bot's authorization key. 

  • PHONE_NUMBER is the user number to be validated. It must be in its full form with +, DDI, DDD, and the number.

Point of attention: Do not forget to add the "+" (plus) sign before sending. 

Example: +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}"
}

In case of batch requests, the limit is 1000 numbers. If there is a larger quantity, perform the split and send in batches.

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"

Request Response

This call will return the numbers that support RCS plus two more information:

  • totalRandomSampleUserCount: represents the count of a random sample of specified numbers. Typically, about 75% of the specified numbers.

  • reachableRandomSampleUserCount: represents the count of numbers from the random sample that can be reached by RBM across all carriers, regardless of which carriers the agent is launched on. This count is used to provide a rough estimate of the total number of reachable users across all carriers.

 

For more information, visit the discussion on the subject at our community or videos on our channel. 😃

Related articles