Qué es
El Capability Check (Verificación de Capacidad) sirve para verificar si el dispositivo de un usuario está activado para RCS y puede comunicarse con un agente de RBM. Identifica qué recursos ofrece un dispositivo y, si hay disponibilidad, permite que el agente personalice la conversación de acuerdo con las funcionalidades del dispositivo y evite presentar interacciones difíciles o imposibles de completar por el usuario.
Obs.: Si el dispositivo de un usuario no es capaz de recibir mensajes RCS, usted podrá comunicarse con él por otros servicios, como SMS/MMS.
Documentación oficial de Google: Verificaciones de capacidad.
Cómo utilizar
Al enviar un archivo con los números que deben recibir mensajes, es necesario verificar cada número para evitar el envío de mensajes innecesarios. En la plataforma, esta verificación ocurre automáticamente en el momento en que los mensajes están siendo enviados.
El envío se realiza mediante un command a la plataforma usando la siguiente estructura:
Dónde encontrar la URI de comandos:
Cómo realizar la llamada
La solicitud debe enviarse de la siguiente forma:
YOUR_TOKEN es la clave de autorización de su bot.
PHONE_NUMBER es el número del usuario a validar. Debe estar en su forma completa con +, DDI, DDD y el número.
Punto de atención: No olvide añadir el signo "+" (más) antes de enviar.
Ejemplo: +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}"
}En el caso de solicitudes por lote, el límite es de 1000 números. Si hay una cantidad mayor, realice la división y envíe por 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 de la llamada
Esta llamada devolverá los números que soportan RCS acompañados de dos informaciones más:
totalRandomSampleUserCount: representa el conteo de una muestra aleatoria de números especificados. Normalmente, cerca del 75% de los números especificados.
reachableRandomSampleUserCount: representa el conteo de números de la muestra aleatoria que pueden ser alcanzados por RBM en todas las operadoras, independientemente de en qué operadoras se lance el agente. Este conteo se utiliza para proporcionar una estimación aproximada del número total de usuarios alcanzables en todas las operadoras.
Para obtener más información, acceda a la discusión sobre el tema en nuestra comunidad o los vídeos en nuestro canal. 😃