Cómo configurar un dispositivo de prueba

Hasta que lances tu agente, este solo podrá comunicarse con los dispositivos de prueba designados. Esto te permite probar tu agente de forma interna para evitar el acceso anticipado accidental de los usuarios finales.

Para comunicarse con un agente de RBM, un dispositivo de prueba debe tener habilitado el RCS. Ten en cuenta que algunos dispositivos Android no tienen habilitado el RCS de forma predeterminada. Para verificar el estado de los RCS de tu dispositivo, consulta Cómo verificar el estado de los RCS de tu dispositivo.

Los agentes pueden enviar un máximo de 20 invitaciones a verificadores por día, con un límite total de 200 invitaciones.

Cómo verificar el estado de los RCS en tu dispositivo

  1. En la app de Mensajes, navega a Configuración de Mensajes.
  2. Presiona Chats RCS. Si no encuentras la opción “Chats RCS”, presiona Funciones de chat.
  3. Busca el valor de Estado.

Si tu dispositivo no es compatible con los RCS, habilita los RCS configurando tu dispositivo con versiones previas al lanzamiento de las apps de Mensajes y Servicios del operador.

Si tu dispositivo es compatible con los RCS, puedes enviar una invitación de verificador. Cuando el dispositivo acepta la invitación, puede comenzar a intercambiar mensajes con tu agente no lanzado.

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.

Cuando RCS esté activo en tu dispositivo, podrás enviar una invitación a un verificador.

Envía una invitación a un verificador

Para invitar a un dispositivo compatible con RCS a convertirse en verificador, debes enviar una invitación. Cuando el dispositivo acepta la invitación, tu agente puede enviarle mensajes, eventos y solicitudes.

Si el dispositivo no está habilitado para RCS, no respondió a la invitación del verificador o la rechazó, tu agente recibirá un error 403 PERMISSION_DENIED cuando intente comunicarse con el dispositivo.

Console

Para enviar una invitación de prueba con la Consola para desarrolladores de Business Communications, haz lo siguiente:

  1. Abre la Consola para desarrolladores de Business Communications, accede con tu Cuenta de Google de RBM y haz clic en tu agente.
  2. En el menú de la izquierda, selecciona Dispositivos.
  3. Para agregar un dispositivo de prueba a la lista de dispositivos de prueba, ingresa el número de teléfono del dispositivo, incluidos el código de país y el código de área. Para agregar varios números de teléfono, sepáralos con comas.

Cuando se agrega un dispositivo a la lista, se envía una invitación. El usuario ve el mensaje de invitación en su dispositivo y tiene la opción de aceptarlo o rechazarlo.

En la Lista de dispositivos de prueba, se detalla el estado de la invitación del verificador para cada dispositivo que invites a probar tu agente.

API

Para enviar una invitación a un verificador con la API de RBM Management, haz lo siguiente:

  • Usa el siguiente código. Para conocer las opciones de formato y valores, consulta testers.

cURL

curl -X POST "https://businesscommunications.googleapis.com/v1/testers" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/rcs-business-messaging" \
-H "`oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY businesscommunications`" \
-d '{"phone_number": "PHONE_NUMBER", "agentId": "AGENT_ID"}'

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 fragmento de un agente de muestra 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 fragmento 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 fragmento 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 fragmento de un agente de muestra de RBM.

Si envías más de 200 invitaciones, la plataforma de RBM devolverá el código de error 429 RESOURCE_EXHAUSTED en la respuesta.

Cómo volver a enviar una invitación a un verificador

Si es necesario, puedes volver a enviar una invitación a un verificador. El resultado depende del estado de invitación actual del dispositivo.

Estado del dispositivo Resultado
PENDING Se envía la invitación de prueba al dispositivo.
ACCEPTED No se envía la invitación de verificador al dispositivo, que mantiene su estado ACCEPTED.
DECLINED Se rechazó la invitación de verificador. Primero, debes quitar el dispositivo de prueba antes de volver a enviar una invitación. De lo contrario, la solicitud fallará.

Después de que el dispositivo acepta la invitación del verificador, se convierte en un dispositivo de prueba designado para tu agente. Puedes enviar mensajes, eventos y verificaciones de capacidades al dispositivo para probar la funcionalidad y los flujos de trabajo de tu agente.

Obtén el estado de la invitación de un dispositivo de prueba

Cuando invitas a un verificador, este puede aceptar o rechazar la invitación en su dispositivo. Puedes consultar el estado de la invitación del dispositivo a través de la API.

Console

Para obtener el estado de la invitación de un dispositivo de prueba con Business Communications Developer Console, sigue estos pasos:

  1. Abre la Consola para desarrolladores de Business Communications, accede con tu Cuenta de Google de RBM y haz clic en tu agente.
  2. En el menú de la izquierda, selecciona Dispositivos.
  3. Para agregar un dispositivo de prueba a la lista de dispositivos de prueba, ingresa el número de teléfono del dispositivo, incluidos el código de país y el código de área. Para agregar varios números de teléfono, sepáralos con comas.

Cuando se agrega un dispositivo de prueba a la lista, puedes verificar su estado en la columna Estado.

API

Para obtener el estado de la invitación de un dispositivo de prueba con la API de RBM Management, haz lo siguiente:

  • Usa el siguiente código. Para conocer las opciones de formato y valores, consulta testers.

cURL

curl -X GET "https://businesscommunications.googleapis.com/v1/testers/PHONE_NUMBER?agentId=AGENT_ID" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/rcs-business-messaging" \
-H "`oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY businesscommunications`"

Obtén el estado de todos los dispositivos de prueba

Puedes consultar el estado de la invitación de todos los dispositivos que invitaste a ser verificadores.

Console

Para verificar el estado de la invitación de todos los dispositivos de prueba con la Consola para desarrolladores de Business Communications, sigue estos pasos:

  1. Abre la Consola para desarrolladores de Business Communications, accede con tu Cuenta de Google de RBM y haz clic en tu agente.
  2. En el menú de la izquierda, selecciona Dispositivos.
  3. Para agregar un dispositivo de prueba a la lista de dispositivos de prueba, ingresa el número de teléfono del dispositivo, incluidos el código de país y el código de área. Para agregar varios números de teléfono, sepáralos con comas.

Cuando se agrega un dispositivo de prueba a la lista, puedes verificar su estado en la columna Estado.

API

Para verificar el estado de la invitación de todos los dispositivos de prueba con la API de RBM Management, haz lo siguiente:

  • Usa el siguiente código. Para conocer las opciones de formato y valores, consulta testers.

cURL

curl -X GET "https://businesscommunications.googleapis.com/v1/testers?agentId=AGENT_ID" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/rcs-business-messaging" \
-H "`oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY businesscommunications`"

Cómo quitar un dispositivo de prueba

Cuando quitas un dispositivo de prueba, este ya no puede recibir mensajes de tu agente no lanzado. La plataforma de RBM no borra los mensajes que envía tu agente y que están en tránsito hacia el dispositivo de prueba o almacenados en él.

Console

Para quitar un dispositivo de prueba con Business Communications Developer Console, sigue estos pasos:

  1. Abre la Consola para desarrolladores de Business Communications, accede con tu Cuenta de Google de RBM y haz clic en tu agente.
  2. En el menú de la izquierda, selecciona Dispositivos.
  3. Selecciona el dispositivo en la lista de dispositivos de prueba y haz clic en el menú .
  4. Haz clic en Quitar dispositivo.

API

Sigue estos pasos para quitar un dispositivo de prueba con la API de RBM Management:

  • Usa el siguiente código. Para conocer las opciones de formato y valores, consulta testers.

cURL

curl -X DELETE "https://businesscommunications.googleapis.com/v1/testers/PHONE_NUMBER?agentId=AGENT_ID" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/rcs-business-messaging" \
-H "`oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY businesscommunications`"
Anterior
Editar la información del agente
Siguiente
Vínculos directos