Até que você lance o agente, ele só poderá se comunicar com dispositivos de teste designados. Isso permite que você teste seu agente internamente, evitando o acesso acidental antecipado aos usuários finais.
Para se comunicar com um agente de RBM, um dispositivo de teste precisa ser ativado para RCS. Alguns dispositivos Android não têm o RCS ativado por padrão. É possível verificar o status do RCS do seu dispositivo e, se necessário, ativar o RCS configurando o dispositivo com versões de pré-lançamento dos apps Mensagens e Serviços da operadora.
Quando o dispositivo estiver ativado para RCS, você poderá enviar uma solicitação de testador para convidar o dispositivo a testar seu agente. Depois que o dispositivo aceita a solicitação, ele pode receber e responder a mensagens do agente não iniciado.
Um agente pode enviar 20 solicitações de testador por dia, com um total máximo de 200
solicitações. Se você adicionar testadores pela API RBM e enviar mais de 200 solicitações, a plataforma RBM vai retornar uma resposta 429 RESOURCE_EXHAUSTED.
Verificar o status do RCS no seu dispositivo
- No app Mensagens, navegue até Configurações das mensagens.
- Toque em Chats RCS. Se você não encontrar a opção "Chats RCS", toque em Recursos de chat.
Encontre o valor Status.
Se o Status for Conectado, o RCS estará ativo no seu dispositivo.
Próximas etapas
Se o RCS estiver ativo no seu dispositivo, você poderá enviar uma solicitação de teste. Se o RCS estiver inativo no seu dispositivo, será necessário ativá-lo antes de começar a testar o agente RBM.
Ativar o RCS no dispositivo
Para usar o RCS em um dispositivo Android, ative os chats RCS no app Mensagens.
Próximas etapas
Quando o RCS estiver ativo no seu dispositivo, você poderá enviar uma solicitação de teste.
Enviar uma solicitação de testador
Para convidar um dispositivo com RCS para ser um testador, envie uma solicitação de teste. Se o dispositivo aceitar a solicitação, o agente poderá enviar mensagens, eventos e solicitações para ele.
Se o dispositivo não tiver suporte ao RCS, não tiver respondido à solicitação do testador ou
recusar a solicitação, seu agente vai receber um erro 403 PERMISSION_DENIED
quando tentar se comunicar com o dispositivo.
Opção 1: enviar uma solicitação de teste com o Console para desenvolvedores do Business Communications
- Abra o Business Communications Developer Console, faça login com sua Conta do Google do RBM e clique no agente.
- No painel de navegação à esquerda, clique em Dispositivos.
- Em Adicionar dispositivos de teste, insira o número de telefone do dispositivo e clique em Adicionar.
A lista de dispositivos de teste detalha o status da solicitação do testador para cada dispositivo que você convida para testar o agente.
Opção 2: enviar uma solicitação de teste com a API RBM
O código a seguir envia uma solicitação de teste. 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('@google/rcsbusinessmessaging');
// Send the tester invite to the device
rbmApiHelper.sendTesterInvite('+12223334444', function(response) {
console.log(response);
});
Este código é um trecho de um agente de exemplo do 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 é 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')
Este código é um trecho de um agente de exemplo 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");
Este código é um trecho de um agente de exemplo do RBM.
Próximas etapas
Depois de aceitar a solicitação de testador, o dispositivo será um dispositivo de teste designado para o 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 estão em trânsito para o dispositivo de teste ou armazenadas nele.
- Abra o console do desenvolvedor de comunicações com empresas, faça login com sua Conta do Google do RBM e clique no seu agente.
- No painel de navegação à esquerda, clique em Dispositivos.
- Localize o dispositivo na Lista de dispositivos de teste e clique no menu do item.
- Clique em Remover dispositivo.