Configurar um dispositivo de teste

Até que você lance seu agente, ele só poderá se comunicar com os dispositivos de teste designados. Isso permite que você teste seu agente internamente para evitar acesso antecipado acidental aos usuários finais.

Para se comunicar com um agente do RBM, um dispositivo de teste precisa estar ativado para RCS. Observação: alguns dispositivos Android não têm o RCS ativado por padrão. Para verificar o status do RCS do seu dispositivo, consulte Verificar o status do RCS do seu dispositivo.

Os agentes podem enviar no máximo 20 convites para testadores por dia, com um limite total de 200 convites.

Verificar o status do RCS no seu dispositivo

  1. No app Mensagens, acesse Configurações do app Mensagens.
  2. Toque em Chats RCS. Se você não encontrar "Chats RCS", toque em Recursos de chat.
  3. Encontre o valor Status.

Se o dispositivo não for compatível com RCS, ative o RCS configurando o dispositivo com versões pré-lançamento dos apps Mensagens e Serviços da operadora.

Se o dispositivo estiver ativado para RCS, você poderá enviar um convite para teste. Quando o dispositivo aceitar o convite, ele poderá começar a enviar mensagens para seu agente não lançado.

Ativar o RCS no dispositivo

Para ativar o RCS em um dispositivo Android, ative os chats RCS no app Mensagens.

Quando o RCS estiver ativo no seu dispositivo, você poderá enviar um convite para testador.

Enviar um convite para testador

Para convidar um dispositivo compatível com RCS para ser um testador, envie um convite. Quando o dispositivo aceita o convite, o agente pode enviar mensagens, eventos e solicitações para ele.

Se o dispositivo não estiver ativado para RCS, não tiver respondido ao convite do testador ou recusar o convite, seu agente vai receber um erro 403 PERMISSION_DENIED ao tentar se comunicar com o dispositivo.

Console

Para enviar um convite de testador com o console para desenvolvedores do Business Communications:

  1. Abra o Business Communications Developer Console, faça login com sua Conta do Google do RBM e clique no seu agente.
  2. No menu à esquerda, selecione Dispositivos.
  3. Adicione um dispositivo de teste à lista de dispositivos de teste inserindo o número de telefone do dispositivo, incluindo o código do país e o código de área. Para adicionar vários números de telefone, separe-os com vírgulas.

Quando um dispositivo é adicionado à lista, um convite é enviado. O usuário vê a mensagem de convite no dispositivo e pode aceitar ou recusar.

A lista de dispositivos de teste detalha o status do convite de teste para cada dispositivo que você convida para testar seu agente.

API

Para enviar um convite de teste com a API RBM Management:

  • Use o seguinte código. Para opções de formatação e valores, consulte 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 é um trecho de um agente de amostra 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 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");
 Este código é um trecho de um agente de amostra do RBM.

Se você enviar mais de 200 convites, a plataforma RBM vai retornar o código de erro 429 RESOURCE_EXHAUSTED na resposta.

Reenviar um convite para testador

Se necessário, você pode reenviar um convite para testador. O resultado depende do status do convite atual do dispositivo.

Status do dispositivo Result
PENDING O convite para teste é enviado ao dispositivo.
ACCEPTED O convite do testador não é enviado ao dispositivo, que mantém o status ACCEPTED.
DECLINED O convite para testador é recusado. Primeiro, remova o dispositivo de teste antes de reenviar um convite. Caso contrário, a solicitação falhará.

Depois que o dispositivo aceita o convite do testador, ele se torna um dispositivo de teste designado para seu agente. É possível enviar mensagens, eventos e verificações de capacidade para o dispositivo e testar a funcionalidade e os fluxos de trabalho do seu agente.

Receber o status do convite de um dispositivo de teste

Quando você convida um testador, ele pode aceitar ou recusar o convite no dispositivo. É possível consultar o status do convite do dispositivo na API.

Console

Para conferir o status do convite de um dispositivo de teste com o Console para desenvolvedores do Business Communications:

  1. Abra o Business Communications Developer Console, faça login com sua Conta do Google do RBM e clique no seu agente.
  2. No menu à esquerda, selecione Dispositivos.
  3. Adicione um dispositivo de teste à lista de dispositivos de teste inserindo o número de telefone do dispositivo, incluindo o código do país e o código de área. Para adicionar vários números de telefone, separe-os com vírgulas.

Quando um dispositivo de teste é adicionado à lista, é possível verificar o status dele na coluna Status.

API

Para receber o status do convite de um dispositivo de teste com a API RBM Management:

  • Use o seguinte código. Para opções de formatação e valores, consulte 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`"

Receber o status de todos os dispositivos de teste

Você pode consultar o status do convite de todos os dispositivos convidados para serem testadores.

Console

Para verificar o status do convite de todos os dispositivos de teste com o Console para desenvolvedores de comunicações comerciais:

  1. Abra o Business Communications Developer Console, faça login com sua Conta do Google do RBM e clique no seu agente.
  2. No menu à esquerda, selecione Dispositivos.
  3. Adicione um dispositivo de teste à lista de dispositivos de teste inserindo o número de telefone do dispositivo, incluindo o código do país e o código de área. Para adicionar vários números de telefone, separe-os com vírgulas.

Quando um dispositivo de teste é adicionado à lista, você pode verificar o status dele na coluna Status.

API

Para verificar o status do convite de todos os dispositivos de teste com a API RBM Management:

  • Use o seguinte código. Para opções de formatação e valores, consulte 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`"

Remover um dispositivo de teste

Quando você remove um dispositivo de teste, ele não pode mais receber mensagens do seu agente não lançado. A plataforma RBM não exclui mensagens enviadas pelo seu agente que estão em trânsito ou armazenadas no dispositivo de teste.

Console

Para remover um dispositivo de teste com o console para desenvolvedores do Business Communications:

  1. Abra o Business Communications Developer Console, faça login com sua Conta do Google do RBM e clique no seu agente.
  2. No menu à esquerda, selecione Dispositivos.
  3. Selecione o dispositivo na Lista de dispositivos de teste e clique no menu .
  4. Clique em Remover dispositivo.

API

Para remover um dispositivo de teste com a API RBM Management:

  • Use o seguinte código. Para opções de formatação e valores, consulte 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 informações do agente
Avançar
Links diretos