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 :

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.
Déployez le serveur d'applications Genesys Cloud pour afficher le module d'interface utilisateur Agent Assist dans Cloud Run.
Créez un client OAuth.
Renseignez les variables d'environnement.
Configurez le widget d'interaction dans Genesys Cloud.
Configurez l'intégration Agent Assist avec le widget d'interaction dans Genesys Cloud.
Configurez Messenger dans Genesys Cloud.
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 :

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

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

Clonez le dépôt Git sur votre machine locale ou votre environnement de développement avec le code suivant :
```
git clone https://github.com/GoogleCloudPlatform/agent-assist-integrations
```
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 builds Google Cloud CLI.
```
cd genesyscloud/frontend
```
Lorsque vous êtes invité à saisir un nom de service, appuyez sur Entrée pour accepter la valeur par défaut.
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 la 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 
```
Cliquez sur Entrée pour accepter le nom de service par défaut.

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

Créer un client OAuth

Suivez les instructions de la documentation Genesys Cloud pour créer un client OAuth.
Assurez-vous que le type d'octroi est Code d'autorisation / PKCE.
Ajoutez l'URL de votre application à la section URI de redirection autorisés.
Définissez la durée du jeton client OAuth 2.0 sur 3 600 secondes. Cela correspond à la durée par défaut du jeton JWT d'une heure pour l'accès à l'API Dialogflow. Si vous avez besoin d'une durée personnalisée, mettez à jour les durées des jetons OAuth et JWT en conséquence.
```
{Application_SERVER_URL}?conversationProfile={CONVERSATION_PROFILE_NAME}&features={FEATURES}
```
Remplacez {APPLICATION_SERVER_URL} par l'URL de votre serveur d'applications d'interface utilisateur.
Remplacez CONVERSATION_PROFILE_NAME par le nom du profil de conversation, par exemple projects/your-project/locations/your-location/conversationProfiles/abc123.
Remplacez {FEATURES} par une liste de fonctionnalités Agent Assist séparées par une virgule 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 :
Pour ajouter des champs d'application au client OAuth, accédez à la section Champs d'application.
Sélectionnez les champs d'application suivants : alerting, authorization, conversations, notifications, messaging et organization.

Exemple d'URL :

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

Nous vous recommandons d'activer l'authentification pop-out pour les iFrames intégrés afin de garantir une expérience de connexion fluide.

Renseigner 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 USA Ouest(Oregon). La valeur par défaut est mypurecloud.com.
GENESYS_CLOUD_ENVIRONMENT : environnement Genesys Cloud. La valeur par défaut est prod.
PROXY_SERVER : URL du connecteur backend Agent Assist.
APPLICATION_SERVER_URL : URL du serveur d'applications d'interface utilisateur.
PROJECT_ID: ID de votre Google Cloud projet.
CONVERSATION_PROFILE : profil de conversation à utiliser. Il doit correspondre au profil de l'URL de redirection du client OAuth.
FEATURES : constante séparée par une virgule pour les fonctionnalités Agent Assist. Elle 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_ENVIRONMENT=$GENESYS_CLOUD_ENVIRONMENT~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 Google Cloud service d'hébergement. Utilisez App Engine ou Cloud Run.

Arrêter le serveur d'applications

Supprimez le service Cloud Run.
Dans votre terminal local, exécutez la commande suivante :
```
gcloud run services list
```
Sélectionnez la plate-forme cible précédemment choisie pour afficher la liste des déploiements actifs.

Exécutez la commande suivante :

gcloud run services delete agent-assist-modules-application-server

Avis concernant les prix

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

Déployer le serveur d'applications Genesys Cloud Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.