Guide de dépannage pour RBM

Suivez ce guide pour fournir les informations nécessaires pour résoudre les problèmes liés à RBM.

Impossible d'envoyer des messages RBM

Fournissez autant d'informations que possible parmi les suivantes pour accélérer le dépannage:

  • Exemples d'ID de message avec horodatage
  • ID du partenaire (voir la capture d'écran)
  • Nombre d'agents concernés
  • ID des agents (séparés par une virgule)
  • Nombre estimé de messages concernés ou potentiellement concernés
  • Les méthodes d'API avec lesquelles vous rencontrez des problèmes (par exemple: importer des fichiers, créer un message de l'agent à l'utilisateur, créer un événement de l'agent à l'utilisateur, supprimer un message de l'agent à l'utilisateur, obtenir des fonctionnalités, obtenir de manière groupée)
  • Exemple de charge utile JSON des requêtes ayant échoué
  • Pour les problèmes liés aux clients: Signaler un bug client

  • Journaux d'erreur (erreurs affichées dans le terminal lors de l'appel des API RBM), y compris le code et le message d'erreur. Exemple :

    "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",
}

Latence lors de l'exécution d'actions RBM

N'oubliez pas de vérifier les points suivants:

Question Recommandation
La latence est-elle <5s ? Si tel est le cas, la valeur est acceptable.
La latence a-t-elle diminué ? Si oui, quand cela a-t-il commencé ? Quelle était la latence habituelle avant par rapport à maintenant ?
Utilisez-vous l'API d'importation de fichiers ? Essayez d'utiliser des ID de fichier au lieu d'envoyer des URL directes. Le traitement des nouvelles URL multimédias implique le téléchargement, le traitement, les miniatures, la protection contre les utilisations abusives et la protection contre les virus, cette dernière prenant environ 50% du temps.
Avez-vous importé les éléments multimédias du message à l'avance ? Pour accélérer le traitement, nous vous recommandons d'utiliser l'appel d'API suivant: https://developers.google.com/business-communications/rcs-business-messaging/reference/rest/v1/files/create
Avez-vous effectué des vérifications des fonctionnalités ? Pour réduire la latence d'envoi de messages aux utilisateurs qui ne sont pas joignables via le RCS, exécutez d'abord des vérifications de fonctionnalités.

Si le problème persiste, veuillez fournir autant d'informations supplémentaires que possible pour accélérer le dépannage:

  • Nombre de messages concernés
  • Source de la latence (par exemple: importer des fichiers, créer un message de l'agent à l'utilisateur, créer un événement de l'agent à l'utilisateur, supprimer un message de l'agent à l'utilisateur, obtenir des fonctionnalités, obtenir par lot)
  • Point de terminaison de service
  • Distribution de la latence (p50, p95, p99)
  • Variation de la latence et période concernée
  • ID du partenaire
  • ID des agents concernés
  • ID de message avec horodatage
  • Données utiles JSON

Je ne reçois pas d'événements ni de messages au niveau du webhook.

Pour assurer la diffusion fluide des messages, vérifiez que tous les webhooks des agents de votre compte partenaire fonctionnent correctement et peuvent traiter les messages de Google. Tous les agents d'un compte partenaire partagent un seul canal pour les messages et les événements entrants. Par conséquent, un webhook défectueux peut perturber la diffusion pour tous les agents.

Si le problème persiste, partagez les informations suivantes pour accélérer le dépannage:

  • Quand le problème a-t-il commencé ? Receviez-vous correctement des messages et des événements avant cette date ?
  • ID du partenaire
  • ID des agents
  • URL du webhook
  • ID de message avec horodatage

Par exemple, l'échec du chargement, l'affichage d'un écran noir, le recadrage et l'absence de suggestions d'actions.

Fournissez autant d'informations que possible parmi les suivantes pour accélérer le dépannage:

  • ID de message avec horodatage
  • Données utiles JSON
  • Étapes à suivre pour reproduire le problème sur l'appareil, le cas échéant
  • Rapport de bug de l'appareil qui reçoit les messages
  • Informations sur l'appareil et la version de l'application de messagerie utilisée
  • Capture d'écran ou enregistrement vidéo du problème

Messages RBM envoyés au format JSON ou convertis en SMS

Fournissez autant d'informations que possible parmi les suivantes pour accélérer le dépannage:

  • ID de message avec horodatage
  • Données utiles JSON
  • Étapes à suivre pour reproduire le problème sur l'appareil, le cas échéant
  • Rapport de bug de l'appareil qui reçoit les messages
  • Informations sur l'appareil et la version de l'application de messagerie utilisée
  • Capture d'écran ou enregistrement vidéo du problème

Échec de la génération de l'URL ou du code QR P2A

Fournissez autant d'informations que possible parmi les suivantes pour accélérer le dépannage:

Fournissez autant d'informations que possible parmi les suivantes pour accélérer le dépannage:

  • ID de l'agent
  • Numéro de téléphone
  • Procédure à suivre pour reproduire le problème, le cas échéant
  • Rapport de bug (de l'appareil sur lequel le lien a été ouvert)
  • Capture d'écran ou enregistrement vidéo du problème

Impossible de recevoir des messages sur un appareil compatible avec le RCS

Fournissez autant d'informations que possible parmi les suivantes pour accélérer le dépannage:

  • Rapport de bug de l'appareil qui ne reçoit pas les messages RBM
  • Numéro de téléphone
  • Informations sur l'appareil et l'OS
  • Version de l'application de chat utilisée
  • Procédure à suivre pour reproduire le problème, le cas échéant
  • Capture d'écran montrant l'état du RCS
  • Capture d'écran ou enregistrement vidéo du problème
  • Nom et pays de l'opérateur

Impossible d'ajouter un testeur

Suivez la procédure décrite dans la section Configurer un appareil de test.

Si le problème persiste, partagez les informations suivantes pour accélérer le dépannage:

  • ID de l'agent
  • Numéro de téléphone
  • Nom et pays de l'opérateur

L'appareil de test ne reçoit pas d'invitation ni de message de testeur

Suivez la procédure décrite dans la section Configurer un appareil de test.

Si le problème persiste, partagez les informations suivantes pour accélérer le dépannage:

  • ID de l'agent
  • Numéro de téléphone
  • ID du message avec code temporel
  • Rapport de bug dans les cinq minutes suivant l'envoi de l'invitation de test

Problèmes liés aux vérifications de fonctionnalités

Pour accélérer le dépannage, partagez les informations suivantes:

  • Liste des numéros de téléphone avec les codes pays inclus dans un fichier CSV
  • ID des agents
  • Journaux d'erreurs
  • État du RCS de l'appareil

Informations manquantes dans les rapports sur les événements de facturation

Pour accélérer le dépannage, partagez les informations suivantes:

  • Dates pour lesquelles des fichiers sont manquants
  • ID des agents

L'opérateur ne parvient pas à approuver le lancement d'agents

Signalez le problème dans la console d'administration RBM (voir la capture d'écran).

Pour les lancements urgents, veuillez fournir les informations suivantes:

  • Nom et pays de l'opérateur
  • ID de l'agent à lancer
  • Autorisation de l'opérateur pour le lancement

Demande de mise à jour des informations sur l'agent

Partagez les informations suivantes pour accélérer les mises à jour:

  • ID de l'agent
  • Informations des métadonnées à mettre à jour (par exemple: nom, logo, bannière, description, coordonnées, lien vers les règles de confidentialité ou lien vers les conditions d'utilisation)

Demander la migration d'agents vers un autre compte partenaire

Partagez les informations suivantes pour accélérer les mises à jour:

  • Liste des ID d'agent
  • Ancien ID du partenaire
  • Nouveau partenaire