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 perfectamente con la API de Audiohook de Genesys Cloud a través de 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 la 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 potenciada por IA, como Resumen y Asistencia proactiva con conocimiento generativo.

Requisitos previos

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

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

La documentación sobre cómo crear y usar el cliente de OAuth para Genesys Cloud proporciona instrucciones para especificar el tipo de otorgamiento, el redireccionamiento, 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 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 la integración de Agent Assist:

    • REDIS_INSTANCE_ID
    • VPC_CONNECTOR_NAME
    • SERVICE_REGION

    Usa un valor de una fuente diferente:

    • UI_CONNECTOR: Es el nombre de dominio del servicio de backend de la integración de Agent Assist implementado.
    • GCP_PROJECT_ID: Es el identificador único a nivel global de tu proyecto. Para encontrarlo, sigue estos pasos.
    • SERVICE_ACCOUNT: Es la cuenta de servicio del 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 para agregar credenciales de AudioHook Monitor. 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 de Voice Connector.

    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 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 Monitor Configuration 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 AudioHook dentro de la cola. Consulta la sección "Set behavior and thresholds for all interaction types" del artículo sobre cómo crear y configurar colas de Genesys Cloud para obtener más detalles.