Atualizações: consulte as notas da versão para ver os novos recursos e atualizações do produto.

Esta página foi traduzida pela API Cloud Translation.

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 de parceiro, abra o Console do desenvolvedor de comunicações comerciais e clique em Configurações da conta de parceiro. Aqui, você pode fazer o seguinte:

Atualizar as informações da conta de parceiro

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

Campo	Descrição
Nome do parceiro	Nome da sua conta de 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 as informações de faturamento corretas sejam geradas para seu uso da RBM para alcançar os assinantes. O nome fornecido aqui precisa ser o mesmo 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 Número de 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 agentes. Se você quiser usar um webhook diferente para um agente específico, configure um webhook de agente que será aplicado apenas a esse agente.

Gerenciar marcas

Como parceiro da RBM, você pode criar agentes em nome de marcas.

Use a página Marcas nas Configurações da conta para adicionar, editar e remover as marcas associadas à sua conta de 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:

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

Remover uma marca

Não é possível remover uma marca se ela estiver 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 das Configurações da conta, você gerencia os usuários da sua conta de parceiro. O usuário que criou a conta de parceiro tem a função de proprietário. Os novos usuários podem ter a função de administrador ou leitor.

Os administradores podem acessar todos os recursos do Developer Console para gerenciar todos os agentes que pertencem à conta de parceiro.
Os leitores têm acesso somente leitura ao Play Console para conferir todos os agentes que pertencem à 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 a função.

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:

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

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

Não é possível remover um usuário com a função de proprietário. Para mudar 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:

Encontre o usuário que você quer atualizar e clique no botão na linha da tabela.
Selecione Editar função.
Escolha uma nova função no menu suspenso.
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. Com essa chave, você pode criar e gerenciar marcas e agentes, além de enviar mensagens e solicitações como um agente. Uma conta de serviço pode ter até 10 chaves.

Para autenticar com segurança as chamadas de API, você também precisa da ferramenta de linha de comando oauth2l.

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

Em Configurações da conta, acesse a página Conta de serviço.
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 particular. Não compartilhe sua chave publicamente. Você vai precisar dessa chave mais tarde para acessar as APIs RBM.

Configurar o webhook do parceiro

Um webhook é um callback HTTPS criado pelo parceiro que especifica como o agente vai responder a mensagens e eventos. Depois de configurar o webhook, você pode começar a receber mensagens e eventos.

Se você quiser usar um webhook diferente para qualquer um dos seus agentes, configure um webhook no nível do agente que substitua o webhook do parceiro. Para mais informações, consulte Configurar um webhook de agente.

Para configurar o webhook do parceiro, siga estas etapas:

Abra o console do desenvolvedor de comunicações comerciais e faça login com sua Conta do Google do parceiro RBM.
Abra as Configurações da conta.
Para o URL do webhook da RCS Business Messaging, clique em Configurar.
Em URL do endpoint do webhook, insira o URL do webhook que começa com "https://".
Anote o valor de clientToken. Você precisa dele para verificar se as mensagens que você recebe são do Google.
Configure seu webhook para aceitar uma solicitação POST com o parâmetro clientToken especificado e envie 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 do corpo
```
{
  "clientToken":"SJENCPGJESMGUFPY",
  "secret":"1234567890"
}
```
O webhook precisa 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);
});
```
No console do desenvolvedor, clique em Verificar. Quando o RBM verifica seu webhook, a caixa de diálogo é fechada.

Para processar falhas de entrega de webhook e garantir um processamento de mensagens confiável, consulte Processamento de mensagens.

Verificar mensagens recebidas

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

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

Extraia o cabeçalho X-Goog-Signature da mensagem. Esta é uma cópia hash codificada em base64 do payload do corpo da mensagem.
Decodificar em base64 o payload do RBM no elemento message.body da solicitação.
Usando o token de cliente do webhook (especificado ao configurar o webhook) como chave, crie um HMAC SHA512 dos bytes do payload da mensagem decodificada em base-64 e codifique o resultado em base64.
Compare o hash X-Goog-Signature com o hash que você criou.
- Se os hashes forem correspondentes, você terá confirmado que o Google enviou a mensagem.
- Se os hashes não corresponderem, verifique o processo de hash em uma mensagem conhecida como boa.
  
  Se o processo de hash estiver funcionando corretamente e você receber uma mensagem que acredita ter sido enviada de forma fraudulenta, entre em contato com nossa equipe.

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.

Registrar como parceiro

Crie seu primeiro agente