Business Messages fournit une interface utilisateur Web appelée Console pour les développeurs Business Communications. Cette console vous permet de créer, de gérer et de lancer des agents.
La console pour les développeurs Business Communications est différente de Google Cloud Platform. (GCP). La console pour les développeurs Business Communications vous permet de gérer les agents Business Messages. La console GCP vous permet également de gérer les paramètres spécifiques à GCP (par exemple, facturation et API) et les autres ressources GCP.
Bien que la console pour les développeurs Business Communications vous permette de créer et de gérer des agents, vous pouvez également utiliser l'API Business Communications pour créer et gérer des agents dans le cas de scénarios avancés, tels que l'intégration à votre propre produit.
Les guides de démarrage rapide et d'utilisation vous expliquent comment utiliser la console et les API. Cette page fournit un résumé général de la mise en page de l'interface utilisateur et de l'utilisation de la console.
Fonctionnalités de la console
La console permet de créer, gérer, mettre à jour, valider et lancer vos agents. Grâce à elle, vous pouvez
- Configurez votre webhook et d'autres paramètres de compte partenaire.
- Créer et gérer des agents, qui contiennent toutes les propriétés et données qui définissent la représentation conversationnelle d'une marque.
- Configurez les paramètres de l'agent non local et la disponibilité des messages.
- créer et gérer des établissements qui représentent les établissements physiques d'une entreprise ;
- Récupérez les URL de test de votre agent et de votre emplacement pour voir comment les utilisateurs voient une conversation avec votre agent.
- Intégrez Dialogflow pour répondre aux questions fréquentes.
- Validez votre agent et vos établissements.
- Lancez votre agent et vos emplacements.
Écran d'accueil de la console
Lorsque vous chargez la console pour la première fois, l'écran de sélection de l'agent s'affiche. Sur cette page, le lien Paramètres de compte partenaire ouvre la page Paramètres de compte partenaire.
L'écran d'accueil permet également d'effectuer les actions suivantes:
- Sélectionnez un agent existant.
- Créer des agents.
- Triez les agents.
- Filtrez les agents par compte partenaire.
Par défaut, les agents s'affichent dans une vue Vignette. Les agents sont classés en fonction de la date de leur dernière mise à jour. Pour passer à la vue sous forme de liste, utilisez les options Afficher en tant que à droite. Dans la vue Liste, les agents peuvent être triés par nom, type, état et date de dernière mise à jour.
Si vous possédez plusieurs comptes partenaire, un sélecteur de compte partenaire vous permet de filtrer la sélection de l'agent par compte partenaire.
Paramètres de compte
Sur la page "Paramètres", vous pouvez mettre à jour:
- Nom de l'entreprise
- Nom à afficher
- Contact en cas de problème technique
- Webhook
Dans le panneau de navigation latéral, vous pouvez accéder à la gestion de la marque et de l'utilisateur, ainsi qu'à vos comptes de service.
Stratégie de la marque
Une marque est une entreprise, une organisation ou un groupe. Un agent est la représentation conversationnelle d'une marque.
Utilisez cette page pour ajouter, modifier et supprimer des marques. La suppression d'une marque entraîne également celle de tous les agents associés. Une marque ne peut pas être supprimée si elle est associée à un agent lancé.
Gestion des utilisateurs
Cette page vous permet d'ajouter ou de supprimer l'accès à vos comptes partenaires enregistrés. Pour changer de compte, utilisez le menu déroulant de la barre de navigation supérieure.
Ajouter un utilisateur
Pour ajouter un utilisateur, saisissez son adresse e-mail dans le champ de saisie et sélectionnez le rôle.
Les nouveaux utilisateurs peuvent avoir les rôles Administrateur ou Lecteur. Un rôle de gestionnaire a accès à toutes les fonctionnalités de la console, tandis qu'un rôle de lecteur fournit un accès en lecture seule aux informations sur l'agent et l'emplacement.
Lorsque vous ajoutez un utilisateur, celui-ci reçoit un e-mail l'informant qu'il a désormais accès au compte partenaire.
L'adresse e-mail ayant initialement enregistré le compte partenaire a le rôle de propriétaire.
Supprimer un utilisateur
Pour supprimer un utilisateur :
- Recherchez l'utilisateur à supprimer dans la liste.
- Cliquez sur le bouton .
- Sélectionnez Supprimer un utilisateur.
- Confirmez la suppression.
L'utilisateur que vous avez supprimé reçoit une notification par e-mail l'informant qu'il n'a plus accès au compte.
Vous ne pouvez pas supprimer un utilisateur avec un rôle de propriétaire. Pour modifier ou supprimer un propriétaire, vous devez contacter l'assistance.
Modifier un rôle utilisateur
Pour mettre à jour le rôle d'un utilisateur:
- Recherchez l'utilisateur dont vous souhaitez modifier le rôle.
- Cliquez sur le bouton .
- Sélectionnez Modifier le rôle.
- Sélectionnez un nouveau rôle dans la liste déroulante.
- Cliquez sur Enregistrer.
Comptes de service
Lorsque vous appelez les API Business Communications et Business Messages, vous authentifiez les appels à l'aide d'une clé de compte de service. Les clés de compte de service vous permettent de créer et de gérer des marques, des agents et des établissements, et d'envoyer des messages et des requêtes en tant qu'agent.
Pour générer une clé de compte de service, sélectionnez Service accounts (Comptes de service) dans le menu de navigation latéral. La console GCP du projet GCP associé au compte de partenaire actuellement sélectionné s'ouvre.
Créez un compte de service et une clé :
- Cliquez sur Create service account (Créer un compte de service).
- Dans le champ Nom du compte de service, saisissez le nom de votre agent, puis cliquez sur Créer.
- Cliquez sur OK.
- Recherchez le nouveau compte de service dans la table, puis cliquez sur > Créer une clé.
- Sélectionnez JSON, puis cliquez sur Créer.
Votre navigateur télécharge la clé du compte de service.
Sélection de l'agent
Après avoir sélectionné un agent, vous êtes redirigé vers sa page "Vue d'ensemble".
La vue d'ensemble affiche les éléments suivants:
- Marque
- Nom de l'agent
- Compte partenaire dans lequel l'agent a été créé
- ID de la marque
- ID de l'agent
- Les URL de test de l'agent vous permettent de voir comment les utilisateurs voient une conversation avec cet agent et de vérifier votre infrastructure de messagerie
- État de validation de l'agent
- Aperçu de l'agent
- Emplacements associés à l'agent
- Liens vers la documentation pertinente
Le panneau de navigation de gauche vous permet d'accéder aux éléments suivants:
- Informations sur l'agent
- Emplacements
- Intégrations
- Questions de l'enquête
- Journaux de débogage
- Validation
- Lancement
- Tableau de bord des métriques
- Liens vers la documentation pertinente
Informations sur l'agent
Utilisez la page d'informations sur l'agent pour mettre à jour ses propriétés.
La page est divisée en deux colonnes. Utilisez les champs de saisie de la colonne de gauche pour mettre à jour les champs de l'agent, tels que le nom, le logo, le message de bienvenue et les propriétés de l'agent, ainsi que des propriétés de lieu et de points d'entrée non locaux. Vous ne pouvez pas mettre à jour certains champs, tels que Nom de l'agent et Logo, après avoir lancé votre agent.
Utilisez la colonne de droite pour obtenir les URL de test de votre agent et afficher un aperçu de celui-ci sur l'appareil d'un utilisateur.
Gestion des établissements
Utilisez cette page pour ajouter des établissements, récupérer les URL de test pour des établissements et faire valider les établissements une fois que vous avez validé votre agent.
Intégrations
Cette page vous permet d'intégrer Dialogflow et de configurer un bot pour répondre aux questions fréquentes.
Enquêtes
Utilisez cette page pour personnaliser l'enquête client de votre agent.
Journaux
Utilisez cette page pour déboguer les problèmes de distribution des messages. Les journaux sont disponibles pendant 14 jours. Filtrez par ID de conversation, ID de message, horodatage, direction ou état afin de trouver les journaux correspondant aux problèmes de l'utilisateur. Vous pouvez également consulter cette page pour vérifier que vous n'envoyez pas involontairement des messages non valides.
Les journaux incluent la charge utile du message, à l'exception des champs sensibles masqués, tels que le contenu du message. Les messages ayant échoué et rejetés présentent des détails d'erreur supplémentaires pour faciliter le débogage.
Certains événements, comme les indicateurs de saisie, n'ont pas de reçu et leur état est "Envoyé".
Validation
Utilisez cette page pour demander la validation de votre agent.
Lancer
Utilisez cette page pour lancer votre agent pour les points d'entrée locaux et non locaux, ainsi que pour lancer des emplacements individuels.
