Implantar o servidor de aplicativos Genesys Cloud

É possível configurar um servidor de aplicativos para renderizar sugestões do Assistente do agente na Web no Genesys Cloud.

Objetivos

A integração do Genesys Cloud envolve os seguintes processos:

  1. Implante o servidor de back-end para que o módulo da UI chame a API Dialogflow, registre um token de autenticação e configure o Cloud Pub/Sub e o Memorystore para Redis.
  2. Implante o servidor de aplicativos Genesys Cloud para renderizar o módulo da interface do Agente de assistência no Cloud Run.
  3. Crie um cliente OAuth.
  4. Preencha as variáveis de ambiente.
  5. Configure o widget de interação no Genesys Cloud.
  6. Configure a integração do Assistente do agente com o widget de interação no Genesys Cloud.
  7. Configure o Messenger no Genesys Cloud.
  8. Use as ferramentas de chat e mensagens da Web do Genesys Cloud para testar a integração.

Antes de começar

Antes de iniciar a integração com a Genesys Cloud, você precisa concluir as seguintes ações:

  1. Instale a Google Cloud CLI, caso ainda não tenha configurado.
  2. Siga as instruções do Google Cloud para criar uma conta de serviço e atribuir a função de cliente da API Dialogflow.
  3. Entre em contato com agent-assist-ui-modules-support@google.com para ter acesso ao repositório do Genesys Cloud.
  4. Implante um back-end de módulos de interface do Agent Assist. Ao implantar o servidor de back-end, especifique a variável de ambiente AUTH_OPTION como GenesysCloud, seguindo as instruções de implantação.

Implantar o servidor de aplicativos Genesys Cloud usando a CLI

  1. Clone o repositório do git na máquina local ou no ambiente de desenvolvimento com o seguinte código:
    git clone https://github.com/GoogleCloudPlatform/agent-assist-integrations
    
  2. No terminal local, use o código abaixo para mudar o diretório ativo para o diretório raiz do repositório em que o arquivo do Docker está localizado antes de executar os builds da Google Cloud CLI.
    cd genesyscloud/frontend
    
  3. Quando for solicitado um nome de serviço, pressione Enter para aceitar o padrão.
  4. Implante a integração usando o comando a seguir. Substitua PROJECT-ID pelo ID do projeto Google Cloud do agente, UI_MODULE_SERVICE_ACCOUNT pelo e-mail do cliente da conta de serviço e configure o REGION para o Cloud Run.
    gcloud run deploy $AA_MODULE_APPLICATION_SERVER 
    --source= ./
    --service-account=$ui_module_service_account
    --memory 1Gi --platform managed
    --region us-central1
    --allow-unauthenticated
  5. Clique em Enter para aceitar o nome de serviço padrão.

Para mais detalhes, consulte a documentação do Cloud Run. No console do Google Cloud , você pode conferir uma lista das implantações de integração ativas em Cloud Run.

Criar um cliente OAuth

  1. Siga as instruções na documentação do Genesys Cloud para criar um novo cliente OAuth (permissão implícita de token).
  2. Verifique se o tipo de concessão é Conceito implícito (navegador).
  3. Adicione o URL do aplicativo à seção URIs de redirecionamento autorizados.
  4. Atualize a duração do token do cliente OAuth 2.0 para 3.600 segundos. Isso corresponde ao token JWT para o acesso de 1 hora à API Dialogflow.
    {Application_SERVER_URL}?conversationProfile={CONVERSATION_PROFILE_NAME}&features={FEATURES}Replace {APPLICATION_SERVER_URL} with the URL of your UI application server.
    
  5. Substitua CONVERSATION_PROFILE_NAME pelo nome do perfil de conversa, como projects/your-project/locations/your-location/conversationProfiles/abc123.
  6. Substitua FEATURES por uma lista separada por vírgulas dos recursos do Assistente do agente que você quer incluir no aplicativo. Inclua apenas os recursos configurados no seu perfil de conversa. A Genesys Cloud oferece suporte aos seguintes recursos:

URL de exemplo:

https://my-project.wm.run.app?conversationProfile=projects/my-project/conversationProfiles/abc123&features=ARTICLE_SUGGESTION,CONVERSATION_SUMMARIZATION

Preencha as variáveis de ambiente

O aplicativo Genesys Cloud usa as seguintes variáveis de ambiente. Para definir as variáveis de ambiente, siga as instruções do Cloud Run.

  • OAUTH_CLIENT_ID: ID do cliente OAuth do Genesys Cloud.
  • GENESYS_CLOUD_REGION: região do Genesys Cloud. Por exemplo, usw2.pure.cloud para a região Oeste dos EUA(Oregon). O valor padrão é mypurecloud.com.
  • GENESYS_CLOUD_ENVIRONMENT: ambiente de nuvem Genesys. O valor padrão é prod.
  • PROXY_SERVER: o URL do conector de back-end do Agente Assist.
  • APPLICATION_SERVER_URL: URL do servidor do aplicativo da UI.
  • PROJECT_ID: o ID do projeto do Google Cloud .
  • CONVERSATION_PROFILE: o perfil de conversa a ser usado. Ele precisa corresponder ao perfil no URL de redirecionamento do cliente OAuth.
  • FEATURES: constante separada por vírgulas para recursos do Agent Assist. Ele precisa corresponder aos recursos no URL de redirecionamento do cliente OAuth.
  • CHANNEL: escolha o tipo de integração. O valor pode ser "voz" ou "chat".

Exemplo de arquivo .env:

OAUTH_CLIENT_ID={your-oauth-client-id}
GENESYS_CLOUD_REGION={your-pure-cloud-region}
GENESYS_CLOUD_ENVIRONMENT={your-pure-cloud-environment}
PROXY_SERVER={your-proxy-server-endpoint}
PROJECT_ID={your-gcp-project-id}
CONVERSATION_PROFILE={your-conversation-profile}
FEATURES=ARTICLE_SUGGESTION,CONVERSATION_SUMMARIZATION
CHANNEL={use-voice-or-chat}

Quando você cria um cliente OAuth, o Genesys Cloud também fornece um ID do cliente.

Execute o comando de implantação com as variáveis de ambiente atualizadas.

    gcloud run deploy $AA_MODULE_APPLICATION_SERVER 
--source ./
--service-account=$ui_module_service_account
--memory 1Gi --platform managed
--region us-central1
--allow-unauthenticated
--set-env-vars ^~^OAUTH_CLIENT_ID=$OAUTH_CLIENT_ID~GENESYS_CLOUD_REGION=$GENESYS_CLOUD_REGION~GENESYS_CLOUD_ENVIORNMENT=$GENESYS_CLOUD_ENVIORNMENT~CONVERSATION_PROFILE=$CONVERSATION_PROFILE~FEATURES=$FEATURES~PROJECT_ID=$PROJECT_ID~APPLICATION_SERVER_URL=''~PROXY_SERVER=$PROXY_SERVER~APPLICATION_SERVER_URL=$APPLICATION_SERVER_URL

O servidor de aplicativos do Genesys Cloud precisa ser implantado em um serviço de hospedagem do Google Cloud . Use o App Engine ou o Cloud Run.

Desligar o servidor do aplicativo

  1. Exclua o serviço do Cloud Run.
  2. No terminal local, execute o seguinte comando:
    gcloud run services list
    
  3. Selecione a plataforma de destino escolhida anteriormente para listar as implantações ativas.
  4. Execute este comando:
    gcloud run services delete agent-assist-modules-application-server
    

A seguir