Déployer le serveur d'applications Genesys Cloud

Vous pouvez configurer un serveur d'applications pour afficher les suggestions Agent Assist sur le Web dans Genesys Cloud.

Objectifs

L'intégration de Genesys Cloud implique les processus suivants:

  1. Déployez le serveur backend pour que le module d'interface utilisateur appelle l'API Dialogflow, enregistre un jeton d'authentification et configure Cloud Pub/Sub et Memorystore pour Redis.
  2. Déployez le serveur d'application Genesys Cloud pour afficher le module d'interface utilisateur Agent Assist dans Cloud Run.
  3. Créez un client OAuth.
  4. Complétez les variables d'environnement.
  5. Configurez le widget d'interaction dans Genesys Cloud.
  6. Configurez l'intégration d'Agent Assist avec le widget d'interaction dans Genesys Cloud.
  7. Configurez Messenger dans Genesys Cloud.
  8. Utilisez les outils de chat et de messagerie Web de Genesys Cloud pour tester l'intégration.

Avant de commencer

Vous devez effectuer les actions suivantes avant de commencer l'intégration de Genesys Cloud:

  1. Installez la Google Cloud CLI si vous ne l'avez pas déjà fait.
  2. Suivez les instructions de Google Cloud pour créer un compte de service et attribuer le rôle client de l'API Dialogflow.
  3. Contactez agent-assist-ui-modules-support@google.com pour accéder au dépôt Genesys Cloud.
  4. Déployez un backend de modules d'interface utilisateur Agent Assist. Lorsque vous déployez le serveur backend, spécifiez GenesysCloud comme valeur de la variable d'environnement AUTH_OPTION, en suivant les instructions de déploiement.

Déployer le serveur d'applications Genesys Cloud à l'aide de la CLI

  1. Clonez le dépôt Git sur votre machine locale ou dans votre environnement de développement à l'aide du code suivant:
    git clone https://github.com/GoogleCloudPlatform/agent-assist-integrations
    
  2. Dans votre terminal local, utilisez le code suivant pour remplacer le répertoire actif par le répertoire racine du dépôt où se trouve le fichier Docker avant d'exécuter les builds de la Google Cloud CLI.
    cd genesyscloud/frontend
    
  3. Lorsque vous êtes invité à saisir un nom de service, appuyez sur Entrée pour accepter le nom par défaut.
  4. Déployez l'intégration à l'aide de la commande suivante. Remplacez PROJECT-ID par l'ID de projet Google Cloud de votre agent, UI_MODULE_SERVICE_ACCOUNT par l'adresse e-mail client de votre compte de service et définissez REGION pour Cloud Run.
    gcloud run deploy $AA_MODULE_APPLICATION_SERVER 
    --source= ./
    --service-account=$ui_module_service_account
    --memory 1Gi --platform managed
    --region us-central1
    --allow-unauthenticated
  5. Cliquez sur Entrée pour accepter le nom de service par défaut.

Pour en savoir plus, consultez la documentation Cloud Run. Dans la console Google Cloud , vous pouvez afficher la liste de vos déploiements d'intégration actifs sous Cloud Run.

Créer un client OAuth

  1. Suivez les instructions de la documentation Genesys Cloud pour créer un client OAuth (autorisation implicite par jeton).
  2. Assurez-vous que le type d'autorisation est Autorisation implicite (navigateur).
  3. Ajoutez l'URL de votre application à la section URI de redirection autorisés.
  4. Définissez la durée du jeton client OAuth 2.0 sur 3 600 secondes. Il correspond au jeton JWT pour l'accès à l'API Dialogflow d'une heure.
    {Application_SERVER_URL}?conversationProfile={CONVERSATION_PROFILE_NAME}&features={FEATURES}Replace {APPLICATION_SERVER_URL} with the URL of your UI application server.
    
  5. Remplacez CONVERSATION_PROFILE_NAME par le nom du profil de conversation, par exemple projects/your-project/locations/your-location/conversationProfiles/abc123.
  6. Remplacez FEATURES par une liste des fonctionnalités Agent Assist que vous souhaitez inclure dans l'application, séparées par une virgule. N'incluez que les fonctionnalités configurées dans votre profil de conversation. Genesys Cloud est compatible avec les fonctionnalités suivantes :

Exemple d'URL :

https://my-project.wm.run.app?conversationProfile=projects/my-project/conversationProfiles/abc123&features=ARTICLE_SUGGESTION,CONVERSATION_SUMMARIZATION

Compléter les variables d'environnement

L'application Genesys Cloud utilise les variables d'environnement suivantes. Pour définir les variables d'environnement, suivez les instructions de Cloud Run.

  • OAUTH_CLIENT_ID: ID client OAuth Genesys Cloud.
  • GENESYS_CLOUD_REGION: région Genesys Cloud Par exemple, usw2.pure.cloud pour l'Ouest des États-Unis(Oregon). La valeur par défaut est mypurecloud.com.
  • GENESYS_CLOUD_ENVIRONMENT: environnement cloud Genesys. La valeur par défaut est prod.
  • PROXY_SERVER: URL du connecteur de backend Agent Assist.
  • APPLICATION_SERVER_URL: URL du serveur d'application de l'UI.
  • PROJECT_ID : ID de votre projet Google Cloud .
  • CONVERSATION_PROFILE: profil de conversation à utiliser. Il doit correspondre au profil dans l'URL de redirection du client OAuth.
  • FEATURES: constante séparée par des virgules pour les fonctionnalités Agent Assist. Il doit correspondre aux fonctionnalités de l'URL de redirection du client OAuth.
  • CHANNEL: choisissez le type d'intégration. La valeur peut être "voice" ou "chat".

Exemple de fichier .env:

OAUTH_CLIENT_ID={your-oauth-client-id}
GENESYS_CLOUD_REGION={your-pure-cloud-region}
GENESYS_CLOUD_ENVIRONMENT={your-pure-cloud-environment}
PROXY_SERVER={your-proxy-server-endpoint}
PROJECT_ID={your-gcp-project-id}
CONVERSATION_PROFILE={your-conversation-profile}
FEATURES=ARTICLE_SUGGESTION,CONVERSATION_SUMMARIZATION
CHANNEL={use-voice-or-chat}

Lorsque vous créez un client OAuth, Genesys Cloud fournit également un ID client.

Exécutez la commande de déploiement avec les variables d'environnement mises à jour.

    gcloud run deploy $AA_MODULE_APPLICATION_SERVER 
--source ./
--service-account=$ui_module_service_account
--memory 1Gi --platform managed
--region us-central1
--allow-unauthenticated
--set-env-vars ^~^OAUTH_CLIENT_ID=$OAUTH_CLIENT_ID~GENESYS_CLOUD_REGION=$GENESYS_CLOUD_REGION~GENESYS_CLOUD_ENVIORNMENT=$GENESYS_CLOUD_ENVIORNMENT~CONVERSATION_PROFILE=$CONVERSATION_PROFILE~FEATURES=$FEATURES~PROJECT_ID=$PROJECT_ID~APPLICATION_SERVER_URL=''~PROXY_SERVER=$PROXY_SERVER~APPLICATION_SERVER_URL=$APPLICATION_SERVER_URL

Le serveur d'applications Genesys Cloud doit être déployé sur un service d'hébergement Google Cloud . Utilisez App Engine ou Cloud Run.

Arrêter le serveur d'application

  1. Supprimez le service Cloud Run.
  2. Dans votre terminal local, exécutez la commande suivante:
    gcloud run services list
    
  3. Sélectionnez la plate-forme cible précédemment choisie pour afficher les déploiements actifs.
  4. Exécutez la commande suivante :
    gcloud run services delete agent-assist-modules-application-server
    

Étape suivante