Integração do Genesys Cloud AudioHook

Este conector de áudio do Genesys Cloud captura, processa e analisa de forma eficiente streams de áudio em tempo real das suas interações com o centro de contacto. Integra-se perfeitamente com a API Genesys Cloud Audiohook através de uma ligação WebSocket persistente ao serviço Audiohook. Esta ligação permite o streaming de áudio em tempo real com gRPC para o back-end de integração do Agent Assist. O conector fornece uma estrutura para processar blocos de áudio recebidos, permitindo o processamento de áudio personalizado, a transcrição ou outras funcionalidades baseadas em IA, como o Resumo e a Assistência de conhecimento generativo proativa.

Pré-requisitos

Siga estes passos antes de iniciar a integração de voz do Genesys Cloud:

  1. Instale o servidor de aplicações do Genesys Cloud.
  2. Configure o cliente OAuth do Genesys Cloud e o widget de interação.

A documentação sobre como criar e usar o cliente Oauth para o Genesys Cloud fornece instruções para especificar o tipo de concessão, o redirecionamento, a duração do token e as funcionalidades com tecnologia de IA que o agente usa.

  1. Instale o backend de integração do Agent Assist.
  2. Tenha em atenção as seguintes variáveis:
    • VPC_CONNECTOR_NAME
    • SERVICE_REGION
    • REDIS_INSTANCE_ID
  3. Instale o monitor AudioHook no Genesys Cloud.

Implemente o servidor do conetor de áudio do Genesys Cloud através da CLI do Google Cloud

Siga estes passos para usar a CLI do Google Cloud para implementar o servidor do conetor de áudio.

  1. Clone o repositório do GitHub para o seu computador local ou ambiente de desenvolvimento com o seguinte código: 
    git clone https://github.com/GoogleCloudPlatform/agent-assist-integrations
cd  genesyscloud/genesyscloud-audiohook
  2. Navegue para o diretório de raiz do conetor de áudio.

  3. Crie um ficheiro 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 Agent Assist:

    • REDIS_INSTANCE_ID
    • VPC_CONNECTOR_NAME
    • SERVICE_REGION

    Usa um valor de uma origem diferente:

    • UI_CONNECTOR: O nome do domínio do serviço de back-end de integração do Agent Assist implementado.
    • GCP_PROJECT_ID: o identificador globalmente exclusivo do seu projeto. Encontre-o seguindo estes passos.
    • SERVICE_ACCOUNT: a conta de serviço do serviço de conetor AudioHook. Se não existir, o script deploy.sh cria um novo.
    • API_KEY: gere uma chave da API na integração do monitor AudioHook. Consulte a secção Adicione credenciais do AudioHook Monitor. Deixe em branco por agora e atualize o valor depois de configurar o AudioHook.
    • VOICE_INTERCEPTOR_SERVICE: escolha um nome para o serviço do Cloud Run do conetor de voz.

    Exemplo de ficheiro 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 ./genesyscloud/genesyscloud-audiohook:

    sh deploy.sh

Configure a integração do monitor AudioHook do Genesys Cloud

Siga estes passos para configurar a integração.

  1. Depois de implementar o conetor de voz no Cloud Run, configure e ative o monitor AudioHook no Genesys Cloud.
  2. No separador Configuração do monitor do Audiohook, atualize as seguintes variáveis:
    • Selecione ambas para o canal.
    • Para o URI de ligação do Audiohook, use: 
      wss://your-cloud-run-domain.run.app/connect
  3. Depois de definir a chave da API no separador Credenciais, atualize a variável de ambiente API_KEY no ficheiro ENV.
  4. Volte a implementar o serviço de conetor de voz.
  5. Ative o monitor AudioHook na fila. Consulte a secção "Defina o comportamento e os limites para todos os tipos de interação" do artigo sobre a criação e configuração de filas do Genesys Cloud para ver mais detalhes.