Mise à jour des identifiants de configuration dans l'intégration de Google Cloud Dialogflow CX Add-on dans Genesys Cloud

Pour continuer à utiliser l'action Call Dialogflow CX Bot dans Architect, vous devez

  • Accordez à Genesys Cloud l'autorisation d'accéder à vos ressources Google Dialogflow CX à l'aide d'un nouvel e-mail de compte de service.
  • Mettez à jour les informations d'identification de configuration dans l'intégration Google Cloud Dialogflow CX Add-on.

Sécurité accrue du cadre d'identification

Pour prendre en charge les améliorations continues de la plateforme et maintenir les normes de sécurité, Genesys a mis à niveau le cadre d'identification sous-jacent utilisé pour authentifier et autoriser l'accès entre Genesys Cloud et Google Dialogflow CX. Ce changement implique le passage d'un modèle d'authentification ancien à une structure d'informations d'identification plus moderne, sécurisée et évolutive, basée sur les meilleures pratiques actualisées de Google Cloud et . Il est nécessaire pour continuer à utiliser l'action Call Dialogflow CX Bot dans Architect.

Avertissement: Les clients doivent mettre à jour leur intégration pour utiliser un nouveau compte de service fourni par Genesys. Si vous n'effectuez pas cette mise à jour, vous risquez d'être confronté à des interruptions de la fonctionnalité du robot ou à une dégradation des performances du système.

Cette migration renforce la fiabilité, la sécurité et la stabilité à long terme de vos expériences basées sur Google Cloud Dialogflow CX et permet à votre organisation de bénéficier des améliorations futures de l'intégration. 

Étape 1 : Recevez l'email de votre nouveau compte de service

Genesys a envoyé un e-mail contenant votre nouveau compte de service. Ce compte permet à Genesys Cloud d'accéder à vos projets Google Cloud existants. Si vous n'avez pas reçu votre courrier électronique, contactez votre représentant Genesys pour obtenir de l'aide.

Étape 2 : Accorder à Genesys Cloud l'accès à vos projets Google Cloud

Note: Pour plus d'informations sur l'utilisation de plusieurs projets Google Cloud, voir Utilisation de plusieurs projets dans la documentation Google Dialogflow CX.

  1. Depuis la console Google Cloud, naviguez jusqu'à la page IAM.
  2. Ouvrez vos projets existants.
  3. Ajouter un nouveau mandant pour chaque projet, s'il en existe plusieurs.
    1. Cliquez sur Ajouter.
    2. Dans le champ New principals, collez l'e-mail du compte de service qui vous a été envoyé par Genesys pour mettre à jour vos informations d'identification de configuration dans l'intégration Cloud Dialogflow CX Add-on.
  4. Ajoutez les rôles suivants au nouveau principal :
    Remarque : Ces rôles permettent à Genesys Cloud d'accéder aux agents Google Cloud Dialogflow CX, d'y effectuer des recherches et de traiter le bot avec succès au moment de l'exécution.
    • Dialogflow API Client
    • Lecteur d'API Dialogflow
    • Dialogflow Conversation Manager
  5. Répondez à l'e-mail qui contient l'e-mail de votre nouveau compte de service, ou contactez votre représentant Genesys et informez-le que vous avez effectué les changements appropriés. Cette action lance le processus de réception de vos informations d'identification pour les étapes suivantes.

Étape 3 : Recevoir les informations d'identification du nouveau compte de service par e-mail de Genesys Cloud

Genesys programmera une session de partage d'écran avec vous, au cours de laquelle un membre de l'équipe vous fournira les informations d'identification que vous devez ajouter à votre configuration dans l'intégration du module complémentaire Cloud Dialogflow CX. Pendant la session de partage d'écran, copiez et enregistrez les informations d'identification suivantes pour les utiliser à l'étape suivante :

  • Identifiant du client
  • Courriel du client
  • ID de la clé privée
  • Clé privée 

Note: Après avoir accordé au nouveau compte de service l'accès à vos projets GCP en utilisant les autorisations de la section précédente, Genesys fournira les informations d'identification. Informez également votre équipe de compte Genesys lorsque vous accordez ces autorisations.

Étape 4 : Mettre à jour les informations d'identification de la configuration dans Genesys Cloud

  1. Connectez-vous à Genesys Cloud.
  2. Cliquez sur Admin. 
  3. Sous Intégrationscliquez sur Intégrations.
  4. Dans la liste des intégrations, cliquez sur Google Cloud Dialogflow CX Add-on.
    1. Cliquez sur l'onglet Details.
    2. Vérifiez que la section Métadonnées s'affiche et que le champ Service-Account-Email contient l'adresse électronique de votre compte de service actuel (ancien).
      Note: Si vous ne voyez pas d'adresse électronique dans le champ, confirmez que vous avez activé le module complémentaire. Si vous ne voyez pas la section Métadonnées, contactez votre représentant Genesys Cloud ou le support produit.

  5. Cliquez sur l'onglet Configuration.
  6. Dans l'onglet Configuration, cliquez sur l'onglet Properties. Une propriété supplémentaire , Use Legacy Credentials, apparaît et est définie sur False. Si cette option est réglée sur True, réglez-la sur False, à moins que vous ne souhaitiez revenir à vos anciens paramètres.
  7. Cliquez sur l'onglet Credentials. Une section Google Cloud Platform Service Account et un bouton Configure apparaissent.
  8. Cliquez sur Configure. Une boîte de dialogue d'identification s'ouvre.
  9. Saisissez les informations d'identification que vous avez enregistrées lors de votre session de partage d'écran :
    • Identifiant du client
    • Courriel du client
    • ID de la clé privée
    • Clé privée
  10. Cliquez sur OK. La boîte de dialogue se ferme et l'état de la section Compte de service Google Cloud Platform devient Configuré, avec la date et l'heure actuelles.
  11. Cliquez sur Enregistrer. Votre module complémentaire Dialogflow CX de Google Cloud utilise désormais vos nouvelles informations d'identification pour l'ensemble de votre projet. 

En option : Revenir aux anciennes informations d'identification

  1. Dans l'onglet Configuration, cliquez sur l'onglet Properties.
  2. Définissez Use Legacy Credentials sur True.