Integración de Genesys Cloud AudioHook

Este conector de audio de Genesys Cloud captura, procesa y analiza de forma eficiente las secuencias de audio en tiempo real de las interacciones de tu centro de contacto. Se integra a la perfección con la API Audiohook de Genesys Cloud mediante una conexión WebSocket persistente con el servicio Audiohook. Esta conexión permite la transmisión de audio en tiempo real con gRPC al backend de la integración de Agent Assist. El conector proporciona un marco para gestionar los fragmentos de audio entrantes, lo que permite el procesamiento de audio personalizado, la transcripción u otras funciones basadas en IA, como Resumen y Asistencia proactiva con conocimientos generativos.

Requisitos previos

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

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

En la documentación sobre cómo crear y usar el cliente de OAuth para Genesys Cloud se explica cómo especificar el tipo de concesión, la redirección, la duración del token y las funciones basadas en IA que usa el agente.

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

Desplegar el servidor del conector de audio de Genesys Cloud mediante la CLI de Google Cloud

Sigue estos pasos para usar la CLI de Google Cloud e 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. Ve 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 la integración de Asistente:

    • REDIS_INSTANCE_ID
    • VPC_CONNECTOR_NAME
    • SERVICE_REGION

    Usa un valor de otra fuente:

    • UI_CONNECTOR: nombre de dominio del servicio backend de integración de Asistente implementado.
    • GCP_PROJECT_ID: identificador único global de tu proyecto. Para encontrarlo, sigue estos pasos.
    • SERVICE_ACCOUNT: la cuenta de servicio del servicio de conector AudioHook. Si no existe, la secuencia de comandos deploy.sh creará una.
    • API_KEY: genera una clave de API en la integración de monitorización de AudioHook. Consulta la sección Añadir credenciales de monitor de AudioHook. Déjelo en blanco por ahora y actualice el valor después de configurar AudioHook.
    • VOICE_INTERCEPTOR_SERVICE: elige un nombre para el servicio de Cloud Run de tu conector de voz.

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

    sh deploy.sh

Configurar la integración de monitor de AudioHook de Genesys Cloud

Sigue estos pasos para configurar la integración.

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