Esse conector de áudio do Genesys Cloud captura, processa e analisa com eficiência fluxos de áudio em tempo real das interações da sua central de atendimento. Ele 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 gRPC para o back-end de integração do Agent Assist. O conector fornece uma estrutura para processar partes de áudio recebidas, permitindo o processamento de áudio personalizado, a transcrição ou outros recursos baseados em IA, como Resumo e Assistente de conhecimento generativo proativo.
Pré-requisitos
Siga estas etapas antes de iniciar a integração de voz do Genesys Cloud:
- Instale o servidor de aplicativos do Genesys Cloud.
- 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 Genesys Cloud (em inglês) fornece instruções para especificar o tipo de concessão, o redirecionamento, a duração do token e quais recursos com tecnologia de IA o agente usa.
- Instale o backend de integração do Assistente de IA.
- Observe as seguintes variáveis:
- VPC_CONNECTOR_NAME
- SERVICE_REGION
- REDIS_INSTANCE_ID
- Instale o monitor AudioHook no Genesys Cloud.
Implante 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.
- Clone o repositório do GitHub na sua máquina local ou ambiente de desenvolvimento com o seguinte código:
git clone https://github.com/GoogleCloudPlatform/agent-assist-integrations cd genesyscloud/genesyscloud-audiohook
- Navegue até o diretório raiz do conector de áudio.
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 de IA:
REDIS_INSTANCE_ID
VPC_CONNECTOR_NAME
SERVICE_REGION
Usa um valor de uma fonte diferente:
UI_CONNECTOR
: o nome de domínio do serviço de back-end de integração do Assistente de IA implantado.GCP_PROJECT_ID
: o identificador globalmente exclusivo do projeto. Para encontrar, 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.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}
Execute o script deploy.sh localizado no diretório
./genesyscloud/genesyscloud-audiohook
:sh deploy.sh
Configurar a integração do monitor AudioHook do Genesys Cloud
Siga estas etapas para configurar sua integração.
- Depois de implantar o conector de voz no Cloud Run, configure e ative o monitor AudioHook no Genesys Cloud.
- Na guia Configuração do monitor 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
- Depois de definir a chave de API na guia Credenciais, atualize a variável de ambiente
API_KEY
no arquivo ENV. - Implante novamente o serviço do conector de voz.
- Ative o monitor AudioHook na fila. Consulte a seção "Definir comportamento e limites para todos os tipos de interação" do artigo sobre criação e configuração de filas do Genesys Cloud para mais detalhes.