Guia de solução de problemas do RBM

Siga este guia para fornecer as informações necessárias para resolver problemas com o RBM.

Não é possível enviar mensagens RBM

Compartilhe o máximo possível dos seguintes detalhes para agilizar a solução de problemas:

  • Exemplos de IDs de mensagens com carimbos de data/hora
  • ID do parceiro (consulte a captura de tela).
  • Número de agentes afetados
  • IDs dos agentes (separados por vírgulas)
  • Número estimado de mensagens afetadas ou que podem ser afetadas
  • Métodos da API com que você está tendo problemas (por exemplo: fazer upload de arquivos, criar agente para mensagem do usuário, criar agente para evento do usuário, excluir agente para mensagem do usuário, receber recursos, receber em lote)
  • Exemplo de payload JSON de solicitações com falha
  • Para problemas com clientes: relatório de bugs do cliente

  • Registros de erros (erros encontrados no terminal ao chamar as APIs RBM), incluindo o código e a mensagem de erro. Exemplo:

    "error": {
"code": 403,
"message": "There was an error looking up the RBM agent (ID: my-test-agent@rbm.goog) that corresponds to the Google Cloud Platform (GCP) project you're authenticating with.",
"status": "PERMISSION_DENIED",
}

Latência ao realizar ações de RBM

Confira o seguinte primeiro:

Pergunta Recomendação
A latência é <5s? Se estiver, isso está dentro do intervalo aceitável.
Houve alguma regressão na latência? Se sim, quando começou? Qual era a latência típica antes em comparação com agora?
Você está usando a API de upload de arquivos? Tente usar IDs de arquivo em vez de enviar URLs diretos. O processamento de novos URLs de mídia envolve download, processamento, miniaturas, proteção contra abuso e proteção contra vírus, sendo que a última leva cerca de 50% do tempo.
Você já fez o upload da mídia da mensagem? Para acelerar o processamento, recomendamos fazer isso com a seguinte chamada de API: https://developers.google.com/business-communications/rcs-business-messaging/reference/rest/v1/files/create
Você fez verificações de recursos? Para reduzir a latência no envio de mensagens para usuários que não podem ser alcançados pelo RCS, execute primeiro as verificações de recursos.

Se o problema persistir, forneça o máximo de detalhes possível para agilizar a solução de problemas:

  • Número de mensagens afetadas
  • Origem da latência (por exemplo, fazer upload de arquivos, criar uma mensagem do agente para o usuário, criar um evento do agente para o usuário, excluir uma mensagem do agente para o usuário, receber recursos, receber em lote)
  • Endpoint de serviço
  • Distribuição de latência (p50, p95, p99)
  • Mudança de latência e período
  • ID do parceiro
  • IDs dos agentes afetados
  • IDs de mensagens com carimbos de data/hora
  • Payload do JSON

Não receber eventos ou mensagens no webhook

Para garantir o envio tranquilo de mensagens, verifique se todos os webhooks do agente da sua conta de parceiro estão funcionando corretamente e podem processar mensagens do Google. Todos os agentes em uma conta de parceiro compartilham um único canal para mensagens e eventos recebidos. Portanto, um webhook com defeito pode interromper as entregas de todos os agentes.

Se o problema persistir, compartilhe os seguintes detalhes para permitir uma solução de problemas mais rápida:

  • Quando o problema começou? Você recebia mensagens e eventos com sucesso antes disso?
  • ID do parceiro
  • IDs dos agentes
  • URL do webhook
  • IDs de mensagens com carimbos de data/hora

Exemplos desse problema incluem falha de carregamento, tela preta, recorte e ações sugeridas que não aparecem.

Compartilhe o máximo possível dos seguintes detalhes para agilizar a solução de problemas:

  • IDs de mensagens com carimbos de data/hora
  • Payload do JSON
  • Etapas para reproduzir o problema no dispositivo, se conhecidas
  • Relatório do bug do dispositivo que recebe as mensagens
  • Detalhes sobre o dispositivo e a versão do app de mensagens usado
  • Captura de tela ou gravação de vídeo do problema

Mensagens RBM enviadas como JSON ou convertidas em SMS

Compartilhe o máximo possível dos seguintes detalhes para agilizar a solução de problemas:

  • IDs de mensagens com carimbos de data/hora
  • Payload do JSON
  • Etapas para reproduzir o problema no dispositivo, se conhecidas
  • Relatório do bug do dispositivo que recebe as mensagens
  • Detalhes sobre o dispositivo e a versão do app de mensagens usado
  • Captura de tela ou gravação de vídeo do problema

Falha ao gerar o URL ou o QR code da proteção em duas etapas

Compartilhe o máximo possível dos seguintes detalhes para agilizar a solução de problemas:

Compartilhe o máximo possível dos seguintes detalhes para agilizar a solução de problemas:

  • ID do agente
  • Número de telefone
  • Etapas para reproduzir o problema, se conhecidas
  • Relatório do bug (do dispositivo em que o link foi aberto)
  • Captura de tela ou gravação de vídeo do problema

Não é possível receber mensagens em um dispositivo com RCS

Compartilhe o máximo possível dos seguintes detalhes para agilizar a solução de problemas:

  • Relatório de bug do dispositivo que não recebe as mensagens RBM
  • Número de telefone
  • Detalhes sobre o dispositivo e o SO
  • Versão do app de mensagens usada
  • Etapas para reproduzir o problema, se conhecidas
  • Captura de tela mostrando o status do RCS
  • Captura de tela ou gravação de vídeo do problema
  • Nome e país da operadora

Não foi possível adicionar um testador

Siga as etapas em Configurar um dispositivo de teste.

Se o problema persistir, compartilhe os seguintes detalhes para permitir uma solução de problemas mais rápida:

  • ID do agente
  • Número de telefone
  • Nome e país da operadora

O dispositivo de teste não recebe convites ou mensagens de testadores

Siga as etapas em Configurar um dispositivo de teste.

Se o problema persistir, compartilhe os seguintes detalhes para agilizar a solução de problemas:

  • ID do agente
  • Número de telefone
  • ID da mensagem com carimbo de data/hora
  • Relatório de bug enviado até 5 minutos após o envio do convite de teste

Problemas com verificações de recursos

Compartilhe os seguintes detalhes para agilizar a solução de problemas:

  • Lista de números de telefone com códigos de país em um arquivo CSV
  • IDs dos agentes
  • Registros de erro
  • Status de RCS do dispositivo

Informações ausentes nos relatórios de eventos de faturamento

Compartilhe os seguintes detalhes para agilizar a solução de problemas:

  • Datas em que os arquivos estão ausentes
  • IDs dos agentes

A operadora não consegue aprovar o lançamento do agente

Informe o problema no console de administração do RBM (consulte a captura de tela).

Para lançamentos urgentes, forneça:

  • Nome e país da operadora
  • ID do agente a ser iniciado
  • Autorização da operadora para lançamento

Pedido para atualizar os detalhes do agente

Compartilhe os seguintes detalhes para ativar atualizações mais rápidas:

  • ID do agente
  • Detalhes dos metadados a serem atualizados (por exemplo, nome, logotipo, banner, descrição, detalhes de contato, link da política de privacidade ou dos Termos de Serviço)

Solicitação para migrar agentes para outra conta de parceiro

Compartilhe os seguintes detalhes para ativar atualizações mais rápidas:

  • Lista de IDs de agentes
  • ID antigo do parceiro
  • Novo ID do parceiro