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 de backend pour que le module d'UI 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. Renseignez les variables d'environnement.
  5. Configurez le widget d'interaction dans Genesys Cloud.
  6. Configurez l'intégration Agent Assist avec le widget d'interaction dans Genesys Cloud.
  7. Configurez Messenger dans Genesys Cloud.
  8. Utilisez les outils de chat Web et de messagerie 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 encore configurée.
  2. Suivez les instructions Google Cloud pour créer un compte de service et attribuer le rôle de 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'UI Agent Assist. Lorsque vous déployez le serveur de backend, spécifiez la variable d'environnement AUTH_OPTION sur GenesysCloud en suivant les instructions de déploiement.

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

  1. Clonez le dépôt Git sur votre machine locale ou 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ù réside le fichier Docker avant d'exécuter les compilations Google Cloud CLI.
    cd genesyscloud/frontend
    
  3. Lorsque vous êtes invité à saisir un nom de service, appuyez sur Entrée pour accepter la valeur par défaut.
  4. Déployez l'intégration à l'aide de la commande suivante. Remplacez PROJECT-ID par l'ID de projet de votre agent Google Cloud , UI_MODULE_SERVICE_ACCOUNT par l'adresse e-mail du 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 (Token Implicit Grant).
  2. Assurez-vous que le type d'attribution est Attribution implicite (navigateur).
  3. Ajoutez l'URL de votre application à la section URI de redirection autorisés.
  4. Mettez à jour la durée du jeton client OAuth 2.0 sur 3 600 secondes. Cela 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 de fonctionnalités d'Assistance de l'agent séparées par des virgules que vous souhaitez inclure dans l'application. Important : N'incluez que les fonctionnalités configurées dans votre profil de conversation. Genesys Cloud est compatible avec les fonctionnalités suivantes :
  7. Pour ajouter des niveaux d'accès au client OAuth, accédez à la section Niveau d'accès et sélectionnez vos balises.

Les autorisations doivent inclure les alertes, l'autorisation, les conversations, les notifications et l'organisation.

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 Cloud Run.

  • OAUTH_CLIENT_ID : ID client OAuth Genesys Cloud.
  • GENESYS_CLOUD_REGION : région Genesys Cloud. Par exemple, usw2.pure.cloud pour US West(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 une virgule 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" (voix) 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'application 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 choisie précédemment pour afficher la liste des déploiements actifs.
  4. Exécutez la commande suivante :
    gcloud run services delete agent-assist-modules-application-server
    

Clause de non-responsabilité concernant les prix

Si vous utilisez l'intégration Genesys Cloud, des frais sont associés au service Cloud Run sous-jacent.

Étapes suivantes