Hasta que lances tu agente, solo podrá comunicarse con los dispositivos de prueba designados. Esto te permite probar tu agente de forma interna y, al mismo tiempo, evitar el acceso anticipado accidental a los usuarios finales.
Para comunicarse con un agente de RBM, un dispositivo de prueba debe estar habilitado para RCS. Ten en cuenta que algunos dispositivos Android no tienen habilitados los RCS de forma predeterminada. Puedes verificar el estado de los RCS de tu dispositivo y, si es necesario, habilitar los RCS configurando tu dispositivo con versiones previas al lanzamiento de las apps de Mensajes y Servicios del operador.
Cuando tu dispositivo tenga habilitada la función RCS, puedes enviar una solicitud de verificador para invitar al dispositivo a probar tu agente. Una vez que el dispositivo acepta la solicitud, puede recibir y responder mensajes de tu agente sin lanzar.
Un agente puede enviar 20 solicitudes de verificador cada día con un total máximo de 200
solicitudes de verificador. Si agregas verificadores a través de la API de RBM y envías más de 200 solicitudes, la plataforma de RBM muestra una respuesta 429 RESOURCE_EXHAUSTED.
Verifica el estado de los RCS de tu dispositivo
- En la app de Mensajes, navega a Configuración de Mensajes.
- Presiona Chats RCS. Si no encuentras la opción “Chats RCS”, presiona Funciones de chat.
Busca el valor Estado.
Si el Estado es Conectado, significa que los RCS están activos en tu dispositivo.
Próximos pasos
Si los RCS están activos en tu dispositivo, puedes enviar una solicitud de verificador. Si los RCS están inactivos en tu dispositivo, debes habilitarlos para comenzar a probar tu agente de RBM con ellos.
Cómo habilitar los RCS en tu dispositivo
Para habilitar los RCS en un dispositivo Android, activa los chats RCS en la app de Mensajes.
Próximos pasos
Una vez que los RCS estén activos en tu dispositivo, podrás enviar una solicitud de verificador.
Envía una solicitud de verificador
Para invitar a un dispositivo compatible con RCS a convertirse en verificador, envía una solicitud de verificador. Si el dispositivo acepta la solicitud, tu agente puede enviarle mensajes, eventos y solicitudes.
Si el dispositivo no está habilitado para RCS, no responde la solicitud del verificador o
la rechaza, el agente recibirá un error 403 PERMISSION_DENIED
cuando intente comunicarse con el dispositivo.
Opción 1: Envía una solicitud de verificador con la Consola para desarrolladores de Business Communications
- Abre la consola para desarrolladores de Business Communications, accede con tu Cuenta de Google de RBM y haz clic en tu agente.
- En el panel de navegación de la izquierda, haz clic en Dispositivos.
- En Agregar dispositivos de prueba, ingresa el número de teléfono de tu dispositivo y haz clic en Agregar.
En la lista de dispositivos de prueba, se detalla el estado de la solicitud del verificador para cada dispositivo que invites a probar tu agente.
Opción 2: Envía una solicitud de verificador con la API de RBM
El siguiente código envía una solicitud de verificador. Para ver las opciones de formato y valor, consulta phones.testers.
cURL
curl -X POST "https://REGION-rcsbusinessmessaging.googleapis.com/v1/phones/PHONE_NUMBER/testers" \ -H "Content-Type: application/json" \ -H "User-Agent: curl/rcs-business-messaging" \ -H "`oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY rcsbusinessmessaging`"
Node.js
// Reference to RBM API helper
const rbmApiHelper = require('@google/rcsbusinessmessaging');
// Send the tester invite to the device
rbmApiHelper.sendTesterInvite('+12223334444', function(response) {
console.log(response);
});
Este código es un extracto de un agente de ejemplo de RBM.
Java
import com.google.rbm.RbmApiHelper;
…
try {
// Create an instance of the RBM API helper
RbmApiHelper rbmApiHelper = new RbmApiHelper();
// Register the device as a tester
rbmApiHelper.registerTester("+12223334444");
} catch(Exception e) {
e.printStackTrace();
}
Este código es un extracto de un agente de ejemplo de RBM.
Python
# Reference to RBM Python client helper
from rcs_business_messaging import rbm_service
# Send the tester invite to a device
rbm_service.invite_tester('+12223334444')
Este código es un extracto de un agente de ejemplo de RBM.
C#
using RCSBusinessMessaging;
…
// Create an instance of the RBM API helper
RbmApiHelper rbmApiHelper = new RbmApiHelper(credentialsFileLocation,
projectId);
// Register the device as a tester
rbmApiHelper.RegisterTester("+12223334444");
Este código es un extracto de un agente de muestra de RBM.
Próximos pasos
Después de que el dispositivo acepte la solicitud del verificador, será un dispositivo de prueba designado para tu agente. Puedes enviar mensajes, eventos y verificaciones de capacidad a tu dispositivo para probar la funcionalidad y los flujos de trabajo del agente.
Cómo quitar un dispositivo de prueba
Cuando quitas un dispositivo de prueba, este ya no puede recibir mensajes de tu agente sin lanzar. La plataforma de RBM no borra los mensajes que envía tu agente que están en tránsito hacia el dispositivo de prueba o almacenados en él.
- Abre la consola para desarrolladores de Business Communications, accede con tu Cuenta de Google de RBM y haz clic en tu agente.
- En el panel de navegación izquierdo, haz clic en Dispositivos.
- Busca el dispositivo en Lista de dispositivos de prueba y haz clic en el menú de ese elemento de la lista.
- Haz clic en Quitar dispositivo.