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 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 el chat web y las herramientas de mensajería de Genesys Cloud para probar la integración.

Antes de comenzar

Debes completar las siguientes acciones antes de iniciar la integración de Genesys Cloud:

  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 API de Dialogflow.
  3. Implementa un backend de módulos de IU de Agent Assist backend. Cuando implementes el servidor de backend, especifica la variable de entorno AUTH_OPTION como GenesysCloud, siguiendo 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 Google Cloud , UI_MODULE_SERVICE_ACCOUNT por el correo electrónico del cliente de tu cuenta de servicio y establece la REGION para 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. Haz clic en Intro para aceptar el nombre de servicio predeterminado.

Para obtener más detalles, consulta la documentación de Cloud Run. En la Google Cloud consola, 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 cliente de OAuth nuevo.
  2. Asegúrate de que el tipo de otorgamiento sea Autorización de código / PKCE.
  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 la duración predeterminada del token JWT de 1 hora para el acceso a la API de Dialogflow. Si necesitas una duración personalizada, actualiza las duraciones de los tokens de OAuth y JWT según corresponda. 
    {Application_SERVER_URL}?conversationProfile={CONVERSATION_PROFILE_NAME}&features={FEATURES}
    Reemplaza {APPLICATION_SERVER_URL} por la URL de tu servidor de aplicaciones de IU.
  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: Incluye solo las funciones configuradas en tu perfil de conversación. Genesys Cloud admite las siguientes funciones
  7. Para agregar alcances al cliente de OAuth, navega a la sección Alcances.
  8. Selecciona los siguientes alcances: alerting, authorization, conversations, notifications, messaging y organization.

URL de ejemplo: 

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

Te recomendamos que habilite la autenticación emergente para iframes incorporados para garantizar una experiencia de acceso sin problemas.

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 EE.UU. (Oeste de 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: Es la URL del servidor de aplicaciones de IU.
  • PROJECT_ID: Es el ID del Google Cloud proyecto.
  • CONVERSATION_PROFILE: Es el perfil de conversación que se usará. Debe coincidir con el perfil en la URL de redireccionamiento del cliente de OAuth.
  • FEATURES: Es una constante separada por comas para las funciones de Agent Assist. Debe coincidir con las funciones en la URL de redireccionamiento del cliente de OAuth.
  • CHANNEL: Elige el tipo de integración. El valor puede ser "voice" o "chat".

Archivo .env de muestra: 

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_ENVIRONMENT=$GENESYS_CLOUD_ENVIRONMENT~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 Google Cloud servicio de hosting. Usa App Engine o Cloud Run.

Cierra 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 mostrar las implementaciones activas.
  4. Ejecuta el siguiente comando: 
    gcloud run services delete agent-assist-modules-application-server

Descargo 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?