Hasta que lanzas el agente, solo podrá comunicarse con los dispositivos de prueba designados. Esto te permite probar tu agente de forma interna y 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 RCS habilitado de forma predeterminada. Puedes verificar el estado de RCS de tu dispositivo y, si es necesario, habilitarlo mediante la configuración de versiones previas al lanzamiento de las apps Mensajes y Servicios del proveedor.
Cuando tu dispositivo sea compatible con RCS, puedes enviar una solicitud de prueba para invitarlo a probar tu agente. Una vez que el dispositivo acepta la solicitud, puede recibir y responder mensajes del agente desvinculado.
Un agente puede enviar 20 solicitudes de verificador cada día con un máximo total de 200 solicitudes. 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 RCS de tu dispositivo
- En la app de Mensajes, navega a la configuración de Mensajes.
- Presiona Chats RCS. Si no encuentras la opción "Chats de RCS", presiona Funciones de chat.
Busca el valor Status.
Si el Estado es Conectado, RCS estará activo en tu dispositivo.
Próximos pasos
Si RCS está activo en tu dispositivo, ya puedes enviar una solicitud de prueba. Si el RCS está inactivo en tu dispositivo, debes habilitarlo en él para poder comenzar a probar el agente de RBM.
Habilita RCS en tu dispositivo
Para habilitar RCS en un dispositivo Android, activa los chats RCS en la app de Mensajes.
Próximos pasos
Cuando RCS esté activado en tu dispositivo, podrás enviar una solicitud de prueba.
Envía una solicitud de verificador
Si quieres invitar a un dispositivo habilitado para RCS a convertirse en verificador, debes enviar una solicitud. Si el dispositivo acepta la solicitud, el agente puede enviar mensajes, eventos y solicitudes al dispositivo.
Si el dispositivo no está habilitado para RCS, no respondió a la solicitud de verificador o la rechazó, 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 izquierdo, haz clic en Dispositivos.
- En Add device devices, ingresa el número de teléfono de tu dispositivo y haz clic en Add.
En la lista de dispositivos de prueba, se detallan los estados de las solicitudes de los verificadores para cada dispositivo que invitas 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('../libs/rbm_api_helper');
// 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 muestra de RBM.
Java
import com.google.rbm.samples.lib.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 muestra 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 muestra 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
Una vez que el dispositivo acepta la solicitud de verificador, es un dispositivo de prueba designado para el agente. Puedes enviar mensajes, eventos y verificaciones de capacidades a tu dispositivo para probar la funcionalidad y los flujos de trabajo de tu agente.
Cómo quitar un dispositivo de prueba
Cuando quitas un dispositivo de prueba, el dispositivo ya no puede recibir mensajes de tu agente no iniciado. La plataforma de RBM no borra los mensajes que envía tu agente que están en tránsito o se almacenan en el dispositivo de prueba.
- 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.
- Ubica el dispositivo en Test device list y haz clic en el menú para ese elemento de lista.
- Haz clic en Quitar dispositivo.