Guide de dépannage pour RBM

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

Problèmes de distribution et de mise en forme des messages

Il s'agit de problèmes liés à la transmission et à la réception réelles des messages, y compris des problèmes de mise en forme des messages.

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

    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 distribution 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

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

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 de reproduction, 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

Problèmes de configuration/connectivité du client et de l'appareil

Ces problèmes incluent la configuration côté client, la connexion et les problèmes spécifiques à la plate-forme.

É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 de reproduction, le cas échéant
  • Rapport de bug depuis l'appareil sur lequel le lien a été ouvert
  • Capture d'écran ou enregistrement vidéo du problème

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
  • Date et heure du test effectué

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 au RCS/RBM sur les appareils iOS

Bien qu'Apple ait adopté la norme RCS (Rich Communication Services) pour la messagerie, il a choisi de développer sa propre implémentation. Cela inclut des fonctionnalités telles que RCS Business Messaging (RBM).

Si vous rencontrez des problèmes avec RBM sur votre appareil iOS, nous vous encourageons à les signaler directement à Apple via l'application Assistant d'avis. Cela aidera Apple à identifier et à résoudre les problèmes spécifiques à leur implémentation.

  1. Ouvrez l'application Assistant d'avis sur un appareil iOS.
  2. Sélectionnez un sujet de départ approprié, en lien avec les problèmes liés à une application de messagerie.
  3. Rédigez et envoyez vos commentaires.
  4. Pour tenir l'équipe d'assistance du RBM au courant, veuillez également nous faire part de vos conclusions. Merci de nous aider à améliorer l'expérience RCS pour tous.

Disponibilité du RCS/RBM par opérateur sur les appareils iOS

Apple choisit ses propres opérateurs pour le lancement du RCS/RBM sur iOS. Pour en savoir plus sur la disponibilité mondiale ou les futurs projets d'Apple, contactez directement Apple. Vous pouvez également contacter votre opérateur pour savoir s'il a lancé le RCS/RBM sur iOS.

Pour en savoir plus sur la compatibilité des opérateurs mobiles et les fonctionnalités de l'iPhone par pays, consultez la page d'assistance Apple.

Problèmes de performances et d'affichage

Il s'agit de problèmes liés aux performances et à l'affichage de la RBM.

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é le contenu multimédia 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

Exemples de problèmes de ce type : échec du chargement, affichage d'un écran noir, recadrage et 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

Problèmes de gestion des comptes, des agents et des transporteurs

Il s'agit de problèmes liés à la gestion et aux rapports sur les comptes, y compris aux requêtes de facturation.

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'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

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