Integración de AudioHook de Genesys Cloud

Este conector de audio de Genesys Cloud captura, procesa y analiza de forma 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 a través de una conexión WebSocket persistente al servicio de Audiohook. Esta conexión habilita la transmisión de audio en tiempo real con gRPC al backend de integración de Agent Assist. El conector proporciona un marco de trabajo para controlar los fragmentos de audio entrantes, lo que permite el procesamiento de audio personalizado, la transcripción y otras funciones potenciadas por IA, como el Resumen y la Asistencia de conocimiento generativo proactivo.

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.
  3. Instala el backend de integración de Agent Assist.
  4. Ten en cuenta las siguientes variables:
    • VPC_CONNECTOR_NAME
    • SERVICE_REGION
    • REDIS_INSTANCE_ID
  5. 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, luego, 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: Es el nombre de dominio del servicio de backend de 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 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 el servicio de Cloud Run del 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 que se encuentra en el directorio ./aa-integration-backend/audiohook:

    sh deploy.sh

Configura la integración del monitor 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 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 Credentials, actualiza la variable de entorno API_KEY en el archivo ENV.
  4. Vuelve a implementar el servicio de conector de voz.
  5. Habilita el monitor de AudioHook dentro de la cola. Para obtener más información, consulta la sección "Establece el comportamiento y los umbrales para todos los tipos de interacción" del artículo sobre la creación y configuración de colas de Genesys Cloud.