Configure sua conta de parceiro

Depois de se registrar como parceiro do RBM, você terá uma conta de parceiro. Para acessar as configurações da conta do parceiro, abra o Console para desenvolvedores do Business Communications e clique em Configurações da conta do parceiro. A partir daqui, você pode fazer o seguinte:

Atualizar informações da conta do parceiro

Na página Configurações, você pode ver seu ID do parceiro e atualizar as seguintes informações:

Campo Descrição
Nome do parceiro nome da sua conta do parceiro
Nome de exibição O nome vai aparecer nos relatórios de faturamento do RBM que as operadoras recebem (como o campo owner_name). As operadoras vão usar isso para identificar você como um parceiro confiável e garantir que gerem as informações de faturamento corretas para o uso do RBM e alcançar os assinantes. O nome fornecido aqui precisa estar alinhado ao nome usado nos contratos de mensagens da operadora.
Ponto de contato técnico

A pessoa com quem o Google vai entrar em contato se houver problemas técnicos com seus agentes. Você pode atualizar

  • Nome
  • Endereço de e-mail corporativo
  • Telefone
Webhook Esse é o URL do endpoint do webhook. Clique em **Configurar** para atualizar. Quando você configura o webhook do parceiro, ele é aplicado a todos os seus agentes. Se você quiser usar um webhook diferente com um agente individual, configure um webhook de agente que só será aplicado a esse agente.

Gerenciar marcas

Como parceiro do RBM, você pode criar agentes em nome das marcas.

Use a página Marcas em Configurações da conta para adicionar, editar e remover as marcas associadas à sua conta do parceiro.

Adicionar uma marca

Para adicionar uma marca, digite o nome dela no campo de entrada e clique em Adicionar.

Editar uma marca

Para editar uma marca, faça o seguinte:

  1. Clique na caixa de seleção ao lado do nome da marca.
  2. Clique no botão e em Editar nome.
  3. Faça as edições e clique em Concluído.

Remover uma marca

Não é possível remover uma marca que está associada a um agente, mesmo que ele não tenha sido lançado.

Para remover uma marca, clique na caixa de seleção ao lado do nome dela e em Excluir.

Gerenciar usuários

Na página Usuários em Configurações da conta, você gerencia os usuários da conta do parceiro. O usuário que criou a conta do parceiro tem o papel de Proprietário. Novos usuários podem ter o papel de administrador ou leitor.

  • Os gerentes podem acessar todas as funcionalidades do Play Console para gerenciar todo e qualquer agente pertencente à conta do parceiro.
  • Os leitores têm acesso somente leitura ao Play Console para visualizar todos os agentes pertencentes à conta do parceiro.

Adicionar um usuário

Para adicionar um usuário, insira o endereço de e-mail dele no campo de entrada e selecione o respectivo Papel.

Quando você adiciona um novo usuário, ele recebe um e-mail informando que tem acesso à conta do parceiro.

Remover um usuário

Para remover um usuário, faça o seguinte:

  1. Encontre o usuário que você quer remover e clique no botão na linha da tabela dele.
  2. Selecione Remover usuário.
  3. Confirme a remoção.

O usuário removido vai receber um e-mail informando que ele não tem mais acesso à conta do parceiro.

Não é possível remover um usuário com função de proprietário. Para alterar ou remover o proprietário, entre em contato com o suporte.

Mudar a função de um usuário

Para atualizar a função de um usuário:

  1. Encontre o usuário que você quer atualizar e clique no botão na linha da tabela dele.
  2. Selecione Editar papel.
  3. Escolha uma nova função no menu suspenso.
  4. Clique em Salvar.

Configurar a conta de serviço para autenticar chamadas de API

Ao fazer chamadas para a API RBM, você autentica as chamadas com uma chave de conta de serviço. Essa chave permite criar e gerenciar marcas e agentes, além de enviar mensagens e solicitações como um agente.

Siga estas etapas para gerar uma chave de conta de serviço:

  1. Em Configurações da conta, navegue até a página Conta de serviço.
  2. Clique em Criar chave e em Criar. O navegador faz o download da chave da conta de serviço.

Armazene a chave da conta de serviço em um local seguro e privado. Não compartilhe sua chave publicamente. Você vai precisar dessa chave mais tarde para acessar as APIs do RBM.

Configurar o webhook do parceiro

Um webhook é um callback HTTPS criado pelo parceiro que especifica como seu agente precisa responder a mensagens e eventos. Depois de configurar o webhook, comece a receber mensagens e eventos.

Para configurar o webhook do parceiro, siga estas etapas:

  1. Abra o Console para desenvolvedores do Business Communications e faça login com sua Conta do Google de parceiro do RBM.

  2. Abra as Configurações da conta.

  3. Em URL do webhook do RCS Business Messaging, clique em Configurar.

  4. Em URL do endpoint do webhook, insira o URL que começa com "https://".

  5. Anote o valor de clientToken. Você precisa dela para verificar se as mensagens recebidas foram enviadas do Google.

  6. Configure seu webhook para aceitar uma solicitação POST com o parâmetro clientToken especificado e enviar uma resposta 200 OK com o valor de texto simples do parâmetro secret como o corpo da resposta.

    Por exemplo, se o webhook receber uma solicitação POST com o seguinte conteúdo:

    {
  "clientToken":"SJENCPGJESMGUFPY",
  "secret":"1234567890"
}

    O webhook precisará confirmar o valor clientToken e, se clientToken estiver correto, retornar uma resposta 200 OK com 1234567890 como o corpo da resposta:

    // clientToken from Configure
const myClientToken = "SJENCPGJESMGUFPY";

// Example endpoint
app.post("/rbm-webhook", (req, res) => {
  const msg = req.body;
  if (msg.clientToken === myClientToken) {
      res.status(200).send(msg.secret);
      return;
  }
  res.send(400);
});

  7. No Play Console, clique em Verificar. Quando o RBM verifica seu webhook, a caixa de diálogo é fechada.

Verificar mensagens recebidas

Como os webhooks podem receber mensagens de qualquer remetente, verifique se o Google enviou as mensagens recebidas antes de processar o conteúdo delas.

Para confirmar que o Google enviou uma mensagem que você recebeu, siga estas etapas:

  1. Extraia o cabeçalho X-Goog-Signature da mensagem. Essa é uma cópia em hash codificada em base64 do payload do corpo da mensagem.
  2. Decodifique em base64 o payload do RBM no elemento message.body da solicitação.
  3. Usando o token de cliente do webhook, que você especificou ao configurar o webhook, como uma chave, crie um HMAC SHA512 dos bytes do payload da mensagem decodificada base64 e codifique o resultado em base64.
  4. Compare o hash X-Goog-Signature com o hash que você criou.
    • Se os hashes forem iguais, você vai confirmar que o Google enviou a mensagem.

    • Se os hashes não forem correspondentes, verifique o processo de hash em uma mensagem conhecida.

      Se o processo de hash estiver funcionando corretamente e você receber uma mensagem que acredita ter sido enviada de maneira fraudulenta, entre em contato conosco.

Node.js

  if ((requestBody.hasOwnProperty('message')) && (requestBody.message.hasOwnProperty('data'))) {
    // Validate the received hash to ensure the message came from Google RBM
    let userEventString = Buffer.from(requestBody.message.data, 'base64');
    let hmac = crypto.createHmac('sha512', CLIENT_TOKEN);
    let data = hmac.update(userEventString);
    let genHash = data.digest('base64');
    let headerHash = req.header('X-Goog-Signature');

    if (headerHash === genHash) {
      let userEvent = JSON.parse(userEventString);

      console.log('userEventString: ' + userEventString);
      handleMessage(userEvent);
    } else {
      console.log('hash mismatch - ignoring message');
    }
  }

  res.sendStatus(200);

Próximas etapas

Agora que sua conta de parceiro está configurada, é hora de criar seu primeiro agente.