Integração do Genesys Cloud AudioHook

Esse conector de áudio do Genesys Cloud captura, processa e analisa streams de áudio em tempo real das interações do seu contact center com eficiência. Ela se integra perfeitamente à API Genesys Cloud Audiohook usando uma conexão WebSocket persistente com o serviço Audiohook. Essa conexão permite o streaming de áudio em tempo real com o gRPC para o back-end de integração do Assistente. O conector oferece uma estrutura para processar partes de áudio recebidas, permitindo processamento de áudio personalizado, transcrição ou outros recursos com tecnologia de IA, como resumo e assistência proativa de conhecimento generativo.

Pré-requisitos

Siga estas etapas antes de começar a integração de voz do Genesys Cloud:

  1. Instale o Genesys Cloud Application Server.
  2. Configure o cliente OAuth do Genesys Cloud e o widget de interação.
  3. Instale o back-end de integração do Agente Assist.
  4. Observe as seguintes variáveis:
    • VPC_CONNECTOR_NAME
    • SERVICE_REGION
    • REDIS_INSTANCE_ID
  5. Instale o monitor AudioHook no Genesys Cloud.

Implantar o servidor do conector de áudio do Genesys Cloud usando a Google Cloud CLI

Siga estas etapas para usar a Google Cloud CLI e implantar o servidor do conector de áudio.

  1. Clone o repositório do GitHub na sua máquina local ou no ambiente de desenvolvimento com o seguinte código:
    git clone https://github.com/GoogleCloudPlatform/agent-assist-integrations
    cd  genesyscloud/genesyscloud-audiohook 
  2. Navegue até o diretório raiz do conector de áudio.
  3. Crie um arquivo ENV no diretório raiz e atualize-o com as seguintes variáveis.

    Usa o mesmo valor da variável de ambiente do back-end de integração do Assistente:

    • REDIS_INSTANCE_ID
    • VPC_CONNECTOR_NAME
    • SERVICE_REGION

    Usa um valor de uma origem diferente:

    • UI_CONNECTOR: o nome de domínio do serviço de back-end de integração do Agent Assist implantado.
    • GCP_PROJECT_ID: o identificador globalmente exclusivo do projeto. Para encontrá-lo, siga estas etapas.
    • SERVICE_ACCOUNT: a conta de serviço do serviço de conector AudioHook. Se ele não existir, o script deploy.sh vai criar um novo.
    • API_KEY: gere uma chave de API na integração do monitor AudioHook. Consulte a seção Adicionar credenciais do AudioHook Monitor. Deixe em branco por enquanto e atualize o valor depois de configurar o AudioHook.
    • VOICE_INTERCEPTOR_SERVICE: escolha um nome para o serviço do Cloud Run do conector de voz.

    Exemplo de arquivo 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. Execute o script deploy.sh localizado no diretório ./aa-integration-backend/audiohook:

    sh deploy.sh

Configurar a integração do monitor Genesys Cloud AudioHook

Siga estas etapas para configurar a integração.

  1. Depois de implantar o conector de voz no Cloud Run, configure e ative o monitor AudioHook no Genesys Cloud.
  2. Na guia Monitor Configuration do Audiohook, atualize as seguintes variáveis:
    • Selecione ambos para o canal.
    • Para o URI de conexão do Audiohook, use:
      wss://your-cloud-run-domain.run.app/connect
  3. Depois de definir a chave de API na guia Credenciais, atualize a variável de ambiente API_KEY no arquivo ENV.
  4. Reimplante o serviço do conector de voz.
  5. Ative o monitor AudioHook na fila. Consulte a seção "Definir comportamento e limites para todos os tipos de interação" do artigo sobre a criação e configuração de filas do Genesys Cloud para mais detalhes.