Até que você inicie o agente, ele só poderá se comunicar com dispositivos de teste designados. Isso permite que você teste o agente internamente, evitando o acesso antecipado acidental aos usuários finais.
Para se comunicar com um agente do RBM, o dispositivo de teste precisa estar ativado para RCS. Observe que alguns dispositivos Android não têm o RCS ativado por padrão. É possível conferir o status do RCS do dispositivo e, se necessário, ativar o RCS configurando o dispositivo com versões de pré-lançamento dos apps Mensagens e Carrier Services.
Quando o dispositivo for ativado para RCS, será possível enviar uma solicitação de testador para convidar o dispositivo a testar o agente. Depois que o dispositivo aceitar a solicitação, ele poderá receber e responder a mensagens do agente não autorizado.
Um agente pode enviar 20 solicitações de testador por dia, com um total máximo de 200 solicitações de testador. Se você adicionar testadores por meio da API RBM e enviar mais de 200 solicitações, a plataforma RBM retornará uma resposta 429 RESOURCE_EXHAUSTED.
Verificar o status do RCS do dispositivo
- No app Mensagens, navegue até Configurações de mensagens.
- Toque em Chats RCS. Se você não encontrar a opção "Bate-papos RCS", toque em Recursos de chat.
Encontre o valor em Status.
Se o Status estiver Conectado, o RCS está ativo no seu dispositivo.
Próximas etapas
Se o RCS estiver ativo no seu dispositivo, você estará pronto para enviar uma solicitação de testador. Se o RCS estiver inativo no dispositivo, será necessário ativar o RCS no dispositivo antes de começar a testar seu agente do RBM com ele.
Ativar o RCS no seu dispositivo
Para ativar o RCS em um dispositivo Android, ative os bate-papos do RCS no app Mensagens.
Próximas etapas
Quando o RCS estiver ativo no seu dispositivo, você estará pronto para enviar uma solicitação de testador.
Enviar uma solicitação de testador
Se você quiser convidar um dispositivo compatível com RCS para ser um testador, envie uma solicitação de testador. Se o dispositivo aceitar a solicitação, o agente poderá enviar mensagens, eventos e solicitações para o dispositivo.
Se o dispositivo não estiver ativado para RCS, não tiver respondido à solicitação de testador ou
recusado a solicitação, o agente receberá um erro 403 PERMISSION_DENIED
quando tentar se comunicar com o dispositivo.
Opção 1: enviar uma solicitação de testador com o Developer Communications Developer Console
- Abra o Business Communications Developer Console, faça login com sua Conta do Google do RBM e clique no agente.
- Na navegação à esquerda, clique em Dispositivos.
- Em Adicionar dispositivos de teste, digite o número de telefone do seu dispositivo e clique em Adicionar.
A lista de dispositivos de teste detalha o status da solicitação de testador para cada dispositivo convidado para testar o agente.
Opção 2: enviar uma solicitação de testador com a API RBM
O código a seguir envia uma solicitação de testador. Para opções de formatação e valor, consulte 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);
});
Esse código é um trecho de um agente de amostra do 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();
}
Esse código é um trecho de um agente de amostra do 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')
Esse código é um trecho de um agente de amostra do 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");
Esse código é um trecho de um agente de amostra do RBM.
Próximas etapas
Depois que o dispositivo aceitar a solicitação de testador, ele será designado como um dispositivo do agente. É possível enviar mensagens, eventos e verificações de recursos para o dispositivo para testar a funcionalidade e os fluxos de trabalho do agente.
Remover um dispositivo de teste
Quando você remove um dispositivo de teste, ele não pode mais receber mensagens do agente não iniciado. A plataforma RBM não exclui mensagens enviadas pelo agente que estejam em trânsito para ou armazenadas no dispositivo de teste.
- Abra o Business Communications Developer Console, faça login com sua Conta do Google do RBM e clique no agente.
- Na navegação à esquerda, clique em Dispositivos.
- Localize o dispositivo na lista de dispositivos de teste e clique no menu do item da lista.
- Clique em Remover dispositivo.