Se usó la API de Cloud Translation para traducir esta página.

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:

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

Antes de comenzar

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

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

Implementa el servidor de aplicaciones de Genesys Cloud con la CLI

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
```
En la terminal local, usa el siguiente código para cambiar el directorio activo al directorio raíz del repositorio en el que reside el archivo Docker antes de ejecutar las compilaciones de Google Cloud CLI.
```
cd genesyscloud/frontend
```
Cuando se te solicite un nombre de servicio, presiona Intro para aceptar el predeterminado.
Implementa la integración con el siguiente comando. Reemplaza PROJECT-ID por el ID del proyecto de Google Cloud de tu agente, UI_MODULE_SERVICE_ACCOUNT por el correo electrónico del cliente de tu cuenta de servicio y configura el 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 
```
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

Sigue las instrucciones de la documentación de Genesys Cloud para crear un nuevo cliente de OAuth (otorgamiento implícito de tokens).
Asegúrate de que el tipo de otorgamiento sea Otorgamiento implícito (navegador).
Agrega la URL de tu aplicación a la sección URIs de redireccionamiento autorizados.

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 de 1 hora a la API de Dialogflow.

{Application_SERVER_URL}?conversationProfile={CONVERSATION_PROFILE_NAME}&features={FEATURES}Replace {APPLICATION_SERVER_URL} with the URL of your UI application server.

Reemplaza CONVERSATION_PROFILE_NAME por el nombre del perfil de conversación, como projects/your-project/locations/your-location/conversationProfiles/abc123.
Reemplaza FEATURES por una lista separada por comas de las funciones de Agent Assist que deseas que incluya la aplicación. Solo incluye las funciones configuradas en tu perfil de conversación. Genesys Cloud admite las siguientes funciones:

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: ID de cliente de OAuth de Genesys Cloud.
GENESYS_CLOUD_REGION: Región de Genesys Cloud. Por ejemplo, usw2.pure.cloud para Oeste de EE.UU. (Oregón). El valor predeterminado es mypurecloud.com.
GENESYS_CLOUD_ENVIRONMENT: Es el entorno de nube de Genesys. 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 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: Es una constante separada por comas para las funciones de Agent Assist. Debe coincidir con las funciones de 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_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 se debe implementar en un servicio de hosting de Google Cloud . Usa App Engine o Cloud Run.

Cómo cerrar el servidor de aplicaciones

Borra el servicio de Cloud Run.
En la terminal local, ejecuta el siguiente comando:
```
gcloud run services list
```
Selecciona la plataforma de destino que elegiste anteriormente para ver la lista de implementaciones activas.

Ejecuta el siguiente comando:

gcloud run services delete agent-assist-modules-application-server