Intégration de Genesys Cloud AudioHook

Ce connecteur audio Genesys Cloud capture, traite et analyse efficacement les flux audio en temps réel de vos interactions dans le centre de contact. Il s'intègre parfaitement à l'API Audiohook de Genesys Cloud à l'aide d'une connexion WebSocket persistante au service Audiohook. Cette connexion permet le streaming audio en temps réel avec gRPC vers le backend d'intégration d'Agent Assist. Le connecteur fournit un framework permettant de gérer les segments audio entrants, ce qui permet de traiter l'audio de manière personnalisée, de transcrire ou d'utiliser d'autres fonctionnalités optimisées par l'IA, comme la synthèse et l'assistance proactive générative des connaissances.

Prérequis

Suivez ces étapes avant de commencer l'intégration de la voix dans Genesys Cloud:

  1. Installez le serveur d'applications Genesys Cloud.
  2. Configurez le client OAuth Genesys Cloud et le widget d'interaction.
  3. Installez le backend d'intégration d'Agent Assist.
  4. Notez les variables suivantes :
    • VPC_CONNECTOR_NAME
    • SERVICE_REGION
    • REDIS_INSTANCE_ID
  5. Installez le moniteur AudioHook dans Genesys Cloud.

Déployer le serveur du connecteur audio Genesys Cloud à l'aide de la Google Cloud CLI

Pour déployer le serveur du connecteur audio à l'aide de la Google Cloud CLI, procédez comme suit :

  1. Clonez le dépôt GitHub sur votre ordinateur local ou dans votre environnement de développement à l'aide du code suivant: 
    git clone https://github.com/GoogleCloudPlatform/agent-assist-integrations
cd  genesyscloud/genesyscloud-audiohook
  2. Accédez au répertoire racine du connecteur audio.

  3. Créez un fichier ENV dans le répertoire racine et mettez-le à jour avec les variables suivantes.

    Utilise la même valeur que la variable d'environnement du backend d'intégration d'Agent Assist:

    • REDIS_INSTANCE_ID
    • VPC_CONNECTOR_NAME
    • SERVICE_REGION

    Utilise une valeur provenant d'une autre source:

    • UI_CONNECTOR: nom de domaine du service de backend d'intégration d'Agent Assist déployé.
    • GCP_PROJECT_ID: identifiant unique global de votre projet. Pour le trouver, suivez ces étapes.
    • SERVICE_ACCOUNT: compte de service du service de connecteur AudioHook. Si ce n'est pas le cas, le script deploy.sh en créera un.
    • API_KEY: générez une clé API dans l'intégration du moniteur AudioHook. Consultez la section Ajouter des identifiants AudioHook Monitor. Laissez ce champ vide pour le moment et modifiez-le après avoir configuré AudioHook.
    • VOICE_INTERCEPTOR_SERVICE: choisissez un nom pour votre service Cloud Run de connecteur vocal.

    Exemple de fichier ENV:

    CONVERSATION_PROFILE_NAME=projects/{your-project-id}/locations/{your-service-region}/conversationProfiles/{your-conversation-profile-id}
SERVICE_REGION={your-service-region}
GCP_PROJECT_ID={your-project-id}
API_KEY={api-key-from-genesys}
VPC_CONNECTOR_NAME={vpc-connector-name-from-aa-integration-backend}
SERVICE_ACCOUNT={your-service-account-name}
UI_CONNECTOR={your-agent-assist-backend-domain-name}
REDIS_INSTANCE_ID={redis-instance-id-from-aa-integration-backend}
VOICE_INTERCEPTOR_SERVICE={your-voice-interceptor-service-name}

  4. Exécutez le script deploy.sh situé dans le répertoire ./aa-integration-backend/audiohook:

    sh deploy.sh

Configurer l'intégration du moniteur AudioHook dans Genesys Cloud

Suivez ces étapes pour configurer votre intégration.

  1. Après avoir déployé le connecteur vocal dans Cloud Run, configurez et activez le moniteur AudioHook dans Genesys Cloud.
  2. Dans l'onglet Monitor Configuration (Configuration du moniteur) d'Audiohook, mettez à jour les variables suivantes :
    • Sélectionnez les deux pour la chaîne.
    • Pour l'URI de connexion Audiohook, utilisez: 
      wss://your-cloud-run-domain.run.app/connect
  3. Après avoir défini la clé API dans l'onglet Identifiants, mettez à jour la variable d'environnement API_KEY dans le fichier ENV.
  4. Redéployez le service du connecteur vocal.
  5. Activez le moniteur AudioHook dans la file d'attente. Pour en savoir plus, consultez la section "Définir le comportement et les seuils pour tous les types d'interactions" de l'article sur la création et la configuration de files d'attente de Genesys Cloud.