Integración de AudioHook de Genesys Cloud

Este conector de audio de Genesys Cloud captura, procesa y analiza de manera eficiente las transmisiones de audio en tiempo real de las interacciones de tu centro de contacto. Se integra sin problemas con la API de Audiohook de Genesys Cloud mediante una conexión persistente de WebSocket al servicio de Audiohook. Esta conexión permite la transmisión de audio en tiempo real con gRPC al backend de integración de Agent Assist. El conector proporciona un framework para controlar fragmentos de audio entrantes, lo que permite el procesamiento de audio personalizado, la transcripción o cualquier otra función basada en IA, como la generación de resúmenes, la asistencia proactiva de conocimiento generativo.

Requisitos previos

Sigue estos pasos antes de comenzar con la integración de voz de Genesys Cloud:

  1. Instala el servidor de aplicaciones de Genesys Cloud.
  2. Configura tanto el cliente de OAuth de Genesys Cloud como el widget de interacción.

En la documentación para crear y usar el cliente de Oauth para Geneysys Cloud, se proporcionan instrucciones para especificar el tipo de otorgamiento, la redirección, la duración del token y las funciones potenciadas por IA que usa el agente.

  1. Instala el backend de integración de Agent Assist.
  2. Ten en cuenta las siguientes variables:
    • VPC_CONNECTOR_NAME
    • SERVICE_REGION
    • REDIS_INSTANCE_ID
  3. Instala el monitor de AudioHook en Genesys Cloud.

Implementa el servidor del conector de audio de Genesys Cloud con Google Cloud CLI

Sigue estos pasos para usar Google Cloud CLI y, así, implementar el servidor del conector de audio.

  1. Clona el repositorio de GitHub en tu máquina local o entorno de desarrollo con el siguiente código: 
    git clone https://github.com/GoogleCloudPlatform/agent-assist-integrations
cd  genesyscloud/genesyscloud-audiohook
  2. Navega al directorio raíz del conector de audio.

  3. Crea un archivo ENV en el directorio raíz y actualízalo con las siguientes variables.

    Usa el mismo valor de la variable de entorno del backend de integración de Agent Assist:

    • REDIS_INSTANCE_ID
    • VPC_CONNECTOR_NAME
    • SERVICE_REGION

    Usa un valor de una fuente diferente:

    • UI_CONNECTOR: El nombre de dominio del servicio de backend de integración de Agent Assist implementado.
    • GCP_PROJECT_ID: El identificador único global de tu proyecto. Para encontrarlo, sigue estos pasos.
    • SERVICE_ACCOUNT: La cuenta de servicio para el servicio del conector de AudioHook. Si no existe, la secuencia de comandos deploy.sh creará una nueva.
    • API_KEY: Genera una clave de API en la integración del monitor de AudioHook. Consulta la sección Agrega credenciales del monitor de AudioHook. Por ahora, déjalo en blanco y actualiza el valor después de configurar AudioHook.
    • VOICE_INTERCEPTOR_SERVICE: Elige un nombre para tu servicio de Cloud Run del conector de voz.

    Archivo ENV de ejemplo:

    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. Ejecuta la secuencia de comandos deploy.sh ubicada en el directorio ./genesyscloud/genesyscloud-audiohook:

    sh deploy.sh

Configura la integración del monitor de AudioHook de Genesys Cloud

Sigue estos pasos para configurar tu integración.

  1. Después de implementar el conector de voz en Cloud Run, configura y activa el monitor de AudioHook en Genesys Cloud.
  2. En la pestaña Configuración del monitor de Audiohook, actualiza las siguientes variables:
    • Selecciona ambos para el canal.
    • Para el URI de conexión de Audiohook, usa lo siguiente: 
      wss://your-cloud-run-domain.run.app/connect
  3. Después de configurar la clave de API en la pestaña Credenciales, actualiza la variable de entorno API_KEY en el archivo ENV.
  4. Vuelve a implementar el servicio del conector de voz.
  5. Habilita el monitor de AudioHook dentro de la cola. Consulta la sección "Establece el comportamiento y los umbrales para todos los tipos de interacción" del artículo de Genesys Cloud sobre cómo crear y configurar colas para obtener más detalles.