Implementa el servidor de aplicaciones de Genesys Cloud

Puedes configurar un servidor de aplicaciones para renderizar sugerencias de Agent Assist en la Web en Genesys Cloud.

Objetivos

La integración de Genesys Cloud incluye los siguientes procesos:

  1. Implementa el servidor de backend para que el módulo de IU llame a la API de Dialogflow, registre un token de autenticación y configure Cloud Pub/Sub y Memorystore para Redis.
  2. Implementa el servidor de aplicaciones de Genesys Cloud para renderizar el módulo de la IU de Agent Assist en Cloud Run.
  3. Crea un cliente de OAuth.
  4. Completa las variables de entorno.
  5. Configura el widget de interacción en Genesys Cloud.
  6. Configura la integración de Agent Assist con el widget de interacción en Genesys Cloud.
  7. Configura Messenger en Genesys Cloud.
  8. Usa las herramientas de chat web y mensajería de Genesys Cloud para probar la integración.

Antes de comenzar

Antes de comenzar la integración de Genesys Cloud, debes completar las siguientes acciones:

  1. Instala la CLI de Google Cloud si aún no la configuraste.
  2. Sigue las Google Cloud instrucciones para crear una cuenta de servicio y asignar el rol de cliente de la API de Dialogflow.
  3. Comunícate con agent-assist-ui-modules-support@google.com para acceder al repositorio de Genesys Cloud.
  4. Implementa un backend de los módulos de la IU de Agent Assist. Cuando implementes el servidor de backend, especifica que la variable de entorno AUTH_OPTION sea GenesysCloud, según las instrucciones de implementación.

Implementa el servidor de aplicaciones de Genesys Cloud con la CLI

  1. Clona el repositorio de Git en tu máquina local o entorno de desarrollo con el siguiente código: 
    git clone https://github.com/GoogleCloudPlatform/agent-assist-integrations
  2. En tu terminal local, usa el siguiente código para cambiar el directorio activo al directorio raíz del repositorio en el que reside el archivo de Docker antes de ejecutar las compilaciones de Google Cloud CLI. 
    cd genesyscloud/frontend
  3. Cuando se te solicite un nombre de servicio, presiona Intro para aceptar el valor predeterminado.
  4. Implementa la integración con el siguiente comando. Reemplaza PROJECT-ID por el ID del proyecto de tu agente, UI_MODULE_SERVICE_ACCOUNT por el correo electrónico del cliente de tu cuenta de servicio y establece REGION para Cloud Run. Google Cloud 
    gcloud run deploy $AA_MODULE_APPLICATION_SERVER 
    
--source ./ 
    
--service-account=$ui_module_service_account 
    
--memory 1Gi --platform managed 
    
--region us-central1 
    
--allow-unauthenticated
  5. Haz clic en Intro para aceptar el nombre de servicio predeterminado.

Para obtener más información, consulta la documentación de Cloud Run. En la consola de Google Cloud , puedes ver una lista de tus implementaciones de integración activas en Cloud Run.

Crea un cliente de OAuth

  1. Sigue las instrucciones de la documentación de Genesys Cloud para crear un nuevo cliente de OAuth (concesión implícita de token).
  2. Asegúrate de que el tipo de concesión sea Implicit Grant (Browser).
  3. Agrega la URL de tu aplicación a la sección URIs de redireccionamiento autorizados.
  4. Actualiza la duración del token de cliente de OAuth 2.0 a 3,600 segundos. Esto coincide con el token JWT para el acceso a la API de Dialogflow de 1 hora. 
    {Application_SERVER_URL}?conversationProfile={CONVERSATION_PROFILE_NAME}&features={FEATURES}Replace {APPLICATION_SERVER_URL} with the URL of your UI application server.
  5. Reemplaza CONVERSATION_PROFILE_NAME por el nombre del perfil de conversación, como projects/your-project/locations/your-location/conversationProfiles/abc123.
  6. Reemplaza {FEATURES} por una lista separada por comas de las funciones de Agent Assist que deseas que incluya la aplicación. Importante: Solo incluye las funciones configuradas en tu perfil de conversación. Genesys Cloud admite las siguientes funciones:
  7. Para agregar permisos al cliente de OAuth, navega a la sección Permiso y selecciona tus etiquetas.

. Los alcances deben incluir alertas, autorización, conversaciones, notificaciones y organización.

URL de ejemplo: 

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

Completa las variables de entorno

La aplicación de Genesys Cloud usa las siguientes variables de entorno. Para configurar las variables de entorno, sigue las instrucciones de Cloud Run.

  • OAUTH_CLIENT_ID: Es el ID de cliente de OAuth de Genesys Cloud.
  • GENESYS_CLOUD_REGION: Región de Genesys Cloud. Por ejemplo, usw2.pure.cloud para US West(Oregón). El valor predeterminado es mypurecloud.com.
  • GENESYS_CLOUD_ENVIRONMENT: Es el entorno de Genesys Cloud. El valor predeterminado es prod.
  • PROXY_SERVER: Es la URL del conector de backend de Agent Assist.
  • APPLICATION_SERVER_URL: URL del servidor de aplicaciones de la IU.
  • PROJECT_ID: El ID de tu proyecto de Google Cloud .
  • CONVERSATION_PROFILE: Es el perfil de conversación que se usará. Debe coincidir con el perfil de la URL de redireccionamiento del cliente de OAuth.
  • FEATURES: Constante separada por comas para las funciones de Agent Assist. Estos deben coincidir con los parámetros de la URL de redireccionamiento del cliente de OAuth.
  • CHANNEL: Elige el tipo de integración. El valor puede ser "voz" o "chat".

Ejemplo de archivo .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}

Cuando creas un cliente de OAuth, Genesys Cloud también proporciona un ID de cliente.

Ejecuta el comando de implementación con las variables de entorno actualizadas. 

    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

El servidor de aplicaciones de Genesys Cloud debe implementarse en un servicio de hosting Google Cloud . Usa App Engine o Cloud Run.

Apaga el servidor de aplicaciones

  1. Borra el servicio de Cloud Run.
  2. En tu terminal local, ejecuta el siguiente comando: 
    gcloud run services list
  3. Selecciona la plataforma de destino elegida anteriormente para enumerar las implementaciones activas.
  4. Ejecuta el siguiente comando: 
    gcloud run services delete agent-assist-modules-application-server

Renuncia de responsabilidad sobre el precio

Si usas la integración de Genesys Cloud, hay un costo asociado con el servicio subyacente de Cloud Run.

¿Qué sigue?