Intégration de Genesys Cloud AudioHook

Ce connecteur audio Genesys Cloud capture, traite et analyse efficacement les flux audio en temps réel issus des interactions de votre centre de contact. Elle s'intègre parfaitement à l'API Audiohook 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'Assistance pour les agents. Le connecteur fournit un framework pour gérer les blocs audio entrants, ce qui permet un traitement audio personnalisé, une transcription ou d'autres fonctionnalités basées sur l'IA, comme la synthèse et l'assistance proactive à la génération de connaissances.

Prérequis

Avant de commencer l'intégration vocale de Genesys Cloud, procédez comme suit :

  1. Installez le serveur d'application Genesys Cloud.
  2. Configurez le client OAuth Genesys Cloud et le widget d'interaction.

La documentation sur la création et l'utilisation du client OAuth pour Genesys Cloud fournit des instructions pour spécifier le type d'attribution, la redirection, la durée du jeton et les fonctionnalités optimisées par l'IA utilisées par l'agent.

  1. Installez le backend d'intégration d'Agent Assist.
  2. Notez les variables suivantes :
    • VPC_CONNECTOR_NAME
    • SERVICE_REGION
    • REDIS_INSTANCE_ID
  3. Installez le moniteur AudioHook sur Genesys Cloud.

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

Suivez ces étapes pour utiliser la Google Cloud CLI afin de déployer le serveur du connecteur audio.

  1. Clonez le dépôt GitHub sur votre machine locale ou 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 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 Agent Assist déployé.
    • GCP_PROJECT_ID : identifiant unique global de votre projet. Pour le trouver, suivez ces étapes.
    • SERVICE_ACCOUNT : compte de service pour le service de connecteur AudioHook. S'il n'existe pas, 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 mettez à jour la valeur 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 ./genesyscloud/genesyscloud-audiohook :

    sh deploy.sh

Configurer l'intégration du moniteur Genesys Cloud AudioHook

Suivez ces étapes pour configurer votre intégration.

  1. Après avoir déployé le connecteur vocal sur Cloud Run, configurez et activez le moniteur AudioHook dans Genesys Cloud.
  2. Dans l'onglet Configuration du monitoring d'Audiohook, mettez à jour les variables suivantes :
    • Sélectionnez Les deux pour le canal.
    • 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 de 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'interaction" de l'article sur la création et la configuration de files d'attente de Genesys Cloud.