Crie seu primeiro agente

Os usuários interagem com os agentes em um app de mensagens com RCS, como o Google Mensagens, nos dispositivos. Neste guia de início rápido, você vai criar um agente RBM básico que pode enviar uma mensagem simples para um dispositivo de teste e receber uma resposta.

Fluxo de uma mensagem em uma conversa com RBM ativado

Pré-requisitos

Antes de começar a usar o agente, você vai precisar dos seguintes itens:

Configurar o dispositivo de teste

Para se comunicar com um agente RBM não lançado, um dispositivo de teste precisa estar habilitado para RCS, mas nem todos os dispositivos Android podem receber mensagens RCS por padrão. Você pode 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 Carrier Services.

Verificar o status do RCS no seu dispositivo

  1. No app Mensagens, toque no botão e em Configurações.

  2. Toque em Recursos de chat e 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á configurar o agente. Se o RCS estiver inativo no seu dispositivo, será necessário ativá-lo antes de testar o agente RBM.

Configurar o agente

Os agentes do RBM usam a API RBM para enviar mensagens, eventos e outras solicitações aos usuários. Ao criar um agente, você ativa o acesso à API RBM e define as informações básicas dele.

Identifique a região do agente

Os agentes de RBM podem existir em uma destas três regiões: América do Norte, Europa e Ásia-Pacífico. A API RBM oferece suporte a três endpoints regionais para ajudar as empresas a obedecer aos requisitos regionais e de negócios.

Ao criar o agente, escolha a região com base nos regulamentos e requisitos aplicáveis, além da proximidade dos usuários finais. Essa região determina onde o agente opera e armazena os dados.

Se você ou os usuários pretendidos não se encaixarem nessas regiões, escolha a região mais próxima para minimizar a latência. Exemplo:

  • Se você estiver na América Latina, escolha a região da América do Norte.
  • Se você estiver na África, escolha a região da Europa.
  • Se você estiver na Austrália, escolha a região da Ásia-Pacífico.

Não decida a região do agente com base nas operadoras de destino. Todas as regiões têm acesso igual às operadoras em todo o mundo.

Determinar a categoria de faturamento do agente

Ao criar um agente de RBM, é necessário especificar a categoria de faturamento com base na maneira como ele vai interagir com os usuários. Escolha a categoria que mais se aproxima do comportamento pretendido do seu agente:

  • Conversacional: para agentes que se envolvem em conversas com vários turnos com os usuários.
  • Mensagem básica ou única: para agentes que enviam mensagens sem esperar respostas frequentes.

Só é possível mudar a categoria de faturamento do seu representante antes do lançamento. Envie um e-mail para rbm-support@google.com se precisar mudar a categoria de faturamento após o lançamento.

Para mais informações sobre o modelo de faturamento do RBM, consulte as Perguntas frequentes sobre o faturamento do RBM.

Identificar o caso de uso do agente

Cada agente RBM precisa ter um caso de uso predefinido. Isso ajuda a categorizar seu agente e aplicar as regras de negócios corretas para uma boa experiência do usuário. O RBM oferece suporte a quatro casos de uso:

  • OTP: senhas únicas necessárias para autenticar com segurança uma conta ou confirmar uma transação.
  • Transacional: notificações, atualizações ou alertas que compartilham informações diretamente relevantes para os serviços ou produtos atuais de um cliente, como alertas de atividades suspeitas na conta, confirmações de compra e notificações de envio.
  • Promocionais: mensagens de vendas, marketing e promoções para clientes novos ou existentes, com o objetivo de aumentar a conscientização, o engajamento e as vendas.
  • Multiuso: conversas que combinam mensagens transacionais e promocionais, como o envio de uma notificação de conta seguida de uma oferta de desconto ou a atualização para um novo produto ou serviço.

Cada caso de uso tem regras diferentes sobre o que pode ser enviado. Para saber mais sobre cada caso de uso e encontrar o melhor para seu agente, consulte Escolher o caso de uso certo para seu agente.

Depois de enviar o agente para lançamento, não é possível mudar o caso de uso. Confira os casos de uso e regras de negócios do seu país antes de enviar o agente.

Crie um agente

Siga estas instruções para criar seu agente no Console do desenvolvedor de comunicações comerciais.

Para criar um agente, siga estas etapas:

  1. Acesse o Console do desenvolvedor de comunicações comerciais e faça login com sua Conta do Google do parceiro do RBM.
  2. Na página inicial, clique em + Criar agente.
  3. Na janela Novo agente do RCS Business Messaging, especifique as seguintes informações:
  4. Clique em Criar agente.

Quando o agente estiver disponível, você poderá adicionar informações comerciais e de branding. Consulte Criar seu agente.

Convide seu dispositivo de teste

Agora que você tem um agente e o dispositivo de teste está ativado para RCS, convide o dispositivo para testar o agente.

  1. No painel de navegação à esquerda, clique em Dispositivos.
  2. Em Adicionar dispositivos de teste, insira o número de telefone do dispositivo e clique em Adicionar.
  3. No dispositivo de teste, aceite a solicitação do testador para o agente.

Se você não receber um convite no dispositivo de teste, verifique se o RCS está ativado.

Enviar uma mensagem

Com um dispositivo de teste registrado, seu agente agora pode enviar mensagens.

Você precisa de uma chave de conta de serviço para autenticar as chamadas de API com segurança. Se você ainda não criou uma chave de conta de serviço para sua conta de parceiro, é hora de fazer isso.

Em um terminal na máquina de desenvolvimento, execute o seguinte comando:

curl -X POST "https://REGION-rcsbusinessmessaging.googleapis.com/v1/phones/PHONE_NUMBER/agentMessages?messageId=MESSAGE_ID&agentId=AGENT_ID" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/rcs-business-messaging" \
-H "`oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY rcsbusinessmessaging`" \
-d '{
  "contentMessage": {
    "text": "Hello, world!"
  }
}'
  • Substitua REGION por asia, europe ou us, dependendo da região do agente.
  • Substitua PHONE_NUMBER pelo número de telefone do dispositivo de teste. Inclua o código do país, o código de área e um + inicial, mas não inclua separadores. Por exemplo, +14155555555.
  • Substitua AGENT ID pelo seu ID de agente, localizado na página Informações do agente no Console para desenvolvedores do Business Communications.
  • Substitua PATH_TO_SERVICE_ACCOUNT_KEY pelo caminho para a chave criada anteriormente.

Você vai receber uma mensagem "Hello, world!" do agente no dispositivo de teste. Se você não receber uma mensagem no dispositivo de teste, verifique se digitou e formatou corretamente o número de telefone e o caminho para a chave da conta de serviço no comando.

Para enviar diferentes tipos de mensagens, como respostas sugeridas e cards avançados, consulte Enviar mensagens.

Próximas etapas

Agora que seu agente pode enviar mensagens para um dispositivo de teste, é hora de criar algo que atenda às necessidades da sua empresa. Baixe um agente de amostra no idioma de sua preferência e siga as instruções no README do exemplo.

Depois de configurar o agente de exemplo, consulte as práticas recomendadas do RBM e saiba como os agentes enviam e recebem mensagens.

Anterior
Configure sua conta de parceiro