Dominios mejorados y Service Cloud Voice (Spring ‘23)

Prepárese para la versión Winter ‘24, en la que los dominios mejorados deberán estar activados en todas las organizaciones.

• Service Cloud Voice con Amazon Connect. Si Salesforce ya creó una de AWS y le proporcionó una nueva instancia de Amazon Connect, no tendrá que hacer nada. Cuando los dominios mejorados estén activos, nosotros automáticamente nos encargaremos de todo en segundo plano.
• Service Cloud Voice con telefonía para socios de Amazon Connect (aprovisionado)
  • Si Salesforce utilizó una cuenta existente de AWS para proporcionar una nueva instancia de Amazon Connect, no tendrá que hacer nada. Cuando los dominios mejorados estén activos, nosotros automáticamente nos encargaremos de todo en segundo plano.
• Service Cloud Voice con telefonía para socios de Amazon Connect (importar XML)
  • Si utilizó una cuenta existente de AWS para proporcionar de forma manual una instancia de Amazon Connect utilizando archivos de importación XML, realice una serie de pasos puntuales para asegurar que los usuarios puedan iniciar sesión y utilizar Service Cloud Voice.
• Service Cloud Voice con telefonía para socios. Si su proveedor de telefonía no es Amazon Connect, realice los pasos puntuales de la sección Service Cloud Voice con telefonía de socios.

Service Cloud Voice con Amazon Connect

Si Salesforce ya creó una de AWS y le proporcionó una nueva instancia de Amazon Connect, no tendrá que hacer nada. Cuando los dominios mejorados estén activos, nosotros automáticamente nos encargaremos de todo en segundo plano.

Si desea mantener su personalización de las funciones de AWS Lambda, puede restaurar las actualizaciones de las funciones de Lambda. Consulte la sección Roll Back an AWS Lambda Function Update After Enhanced Domains is Enabled (Revertir una actualización de las funciones de AWS Lambda después de activar los dominios mejorados) para seguir los pasos.

Service Cloud Voice con telefonía para socios de Amazon Connect (aprovisionado)

Si al principio configuró Service Cloud Voice suministrando la instancia de Amazon Connect mediante Salesforce, no tiene que hacer nada. Cuando los dominios mejorados estén activos, nosotros automáticamente nos encargaremos de todo en segundo plano.

Si desea mantener su personalización de las funciones de AWS Lambda, puede restaurar las actualizaciones de las funciones de Lambda. Consulte la sección Roll Back an AWS Lambda Function Update After Enhanced Domains is Enabled (Revertir una actualización de las funciones de AWS Lambda después de activar los dominios mejorados) para seguir los pasos.

Service Cloud Voice con telefonía para socios de Amazon Connect (importar XML)

Si utilizó una cuenta existente de AWS para proporcionar de forma manual una instancia de Amazon Connect utilizando archivos de importación XML, realice los siguientes pasos puntuales para asegurar que los usuarios puedan iniciar sesión y utilizar Service Cloud Voice.

Una vez haya realizado los pasos, si desea mantener su personalización de las funciones de AWS Lambda, puede restaurar las actualizaciones de las funciones de Lambda. Consulte la sección Roll Back an AWS Lambda Function Update After Enhanced Domains is Enabled (Revertir una actualización de las funciones de AWS Lambda después de activar los dominios mejorados) para seguir los pasos.

1. Si el inicio de sesión único no funciona, actualice los metadatos del proveedor de identidades de Salesforce.
   1. En Setup (Configuración), en el cuadro Quick Find (Búsqueda rápida), introduzca My Domain (Mi dominio) y, a continuación, seleccione Identity Provider (Proveedor de identidades)..
   2. Haga clic en Download Metadata (Descargar metadatos) y guarde el archivo XML de metadatos en su ordenador.
   3. Vaya al panel IAM desde AWS Management Console.
   4. Vaya a Access management (Gestión de acceso) > Identity providers (Proveedores de identidades).

5. Haga clic en el proveedor de identidades AmazonConnectSFDC o el proveedor que configurara anteriormente y haga clic en Replace metadata (Reemplazar metadatos). A continuación, reemplace el archivo XML de metadatos con la copia que guardó en su ordenador.
6. Guarde sus cambios.

2. Si las funciones de Lambda no funcionan, actualice la URL del punto de conexión SCRT (ScrtEndpointUrl) en todas las funciones afectada con la nueva URL. La siguiente URL del punto de conexión SCRT cambiará después de activar los dominios mejorados.

ScrtEndpointUrl:

Tipo: cadena

Predeterminada: salesforce-scrt-endpoint-url

Descripción: URL de punto de conexión del servidor de Salesforce en tiempo real

Puede actualizar las URL del punto de conexión SCRT desde CloudFormation o manualmente mediante la actualización de la URL de cada función de Lambda afectada.

Para actualizar las URL del punto de conexión SCRT desde CloudFormation:

1. En Setup (Configuración), en el cuadro Quick Find (Búsqueda rápida), introduzca My Domain (Mi dominio) y, a continuación, seleccione My Domain (Mi dominio)..
2. Copie la URL actual de My Domain (Mi dominio). La URL debe ser "con dominios mejorados", para indicar que los dominios se han activado.
3. Desde AWS Management Console, vaya a CloudFormation > Stacks (Pilas) > ServerlessApplicationStack.
4. Haga clic en el nombre de la pila que desee cambiar.
5. Haga clic en la ficha Parameters (Parámetros).
6. Cambie el valor de la clave ScrtEndpointUrl a la URL de "My Domain" (Mi dominio) que copió anteriormente. Por ejemplo, si la URL es MyDomainName.my.salesforce.com, el valor de ScrtEndpointUrl será https://MyDomainName.my.salesforce-scrt.com.

Para actualizar la URL del punto de conexión SCRT de cada función Lambda afectada, haga lo siguiente:

1. En Setup (Configuración), en el cuadro Quick Find (Búsqueda rápida), introduzca My Domain (Mi dominio) y, a continuación, seleccione My Domain (Mi dominio)..
2. Copie la URL actual de My Domain (Mi dominio). La URL debe ser "con dominios mejorados", para indicar que los dominios se han activado.
3. Desde AWS Management Console, vaya al servicio de Lambda en cuestión y seleccione Functions (Funciones).
4. En la lista de nombres de funciones, haga clic en el nombre de la función.
5. Haga clic en la ficha Configuration (Configuración), seleccione Environment variables (Variables de entorno) y haga clic en Edit (Modificar).
6. Cambie el valor de la clave ScrtEndpointUrl a la URL de "My Domain" (Mi dominio) que copió anteriormente. Por ejemplo, si la URL es MyDomainName.my.salesforce.com, el valor de ScrtEndpointUrl será https://MyDomainName.my.salesforce-scrt.com.
7. Haga clic en Guardar.

3. Si utiliza alguna función de Lambda que invoque el punto de conexión de la API REST de Salesforce, actualice las variables de entorno de esas funciones.
   1. Desde AWS Management Console, vaya al servicio de Lambda en cuestión y seleccione Functions (Funciones).
   2. En la lista de nombres de funciones, haga clic en el nombre de la función.
   3. Haga clic en la ficha Configuration (Configuración), seleccione Environment variables (Variables de entorno) y haga clic en Edit (Modificar).
   4. Cambie el valor de SALESFORCE_AUTH_ENDPOINT de My Domain (Mi dominio) a la URL que copió anteriormente. Por ejemplo, https://MyDomainName.my.salesforce.com/services/oauth2/token.

Para verificar el nombre de My Domain (Mi dominio), en Salesforce, vaya a Salesforce > Setup (Configuración) > MyDomain.

5. Cambie el valor de SALESFORCE_REST_API_ENDPOINT_BASE de My Domain (Mi dominio) a la URL que copió anteriormente. Por ejemplo, https://MyDomainName.my.salesforce.com/services/data/v<##.#>.
6. Haga clic en Guardar.

Service Cloud Voice con telefonía para socios

Si ha configurado originalmente Service Cloud Voice con un servicio de telefonía para socios que no sea Amazon Connect, siga estos pasos una sola vez después de activar los dominios mejorados. 

1. Active los dominios mejorados si aún están desactivados.
2. Aprovisione e implemente el nuevo valor de My Domain (Mi dominio).
3. Actualice todas las URL de API de conexión codificadas y los puntos de conexión de las API REST de telefonía, y haga referencia a la URL de SCRT2 con las nuevas URL. Asegúrese de actualizar la URL de inicio de sesión de My Domain (Mi dominio) para el entorno sandbox, porque cambia con los dominios mejorados. Si no actualiza la URL, los usuarios no podrán iniciar sesión.
4. También puede implementar la interfaz de Apex service_cloud_voice.UpdateOrgDomainProvider para recibir notificaciones de futuros cambios en My Domain (Mi dominio) en su organización. Esta interfaz contiene una API a la que se llama cuando la URL de My Domain (Mi dominio) cambia y que envía la información del nuevo dominio al socio de implementación, que actualiza las URL afectadas.

Desactivar los dominios mejorados

Esta configuración se aplica al siguiente modelo de telefonía:

• Service Cloud Voice con Amazon Connect
• Service Cloud Voice con telefonía para socios de Amazon Connect
• Service Cloud Voice con telefonía para socios

Puede desactivar los dominios mejorados de manera temporal. Sin embargo, le recomendamos active los dominios mejorados mucho antes del lanzamiento de la versión Winter ‘24 para que tenga tiempo suficiente para probar los entornos con los nuevos ajustes. 

1. En Setup (Configuración), en el cuadro Quick Find (Búsqueda rápida), introduzca My Domain (Mi dominio) y, a continuación, seleccione My Domain (Mi dominio)..
2. En la sección Routing (Enrutamiento), haga clic en Edit (Modificar).
3. Anule la selección de Enhanced Domains (Dominios mejorados).
4. Anule la selección de Stabilize Visualforce, Experience Builder, Site.com Studio, and content file URLs (Estabilizar direcciones URL de Visualforce, Experience Builder, Site.com Studio y archivos de contenido) si no estaba seleccionado antes de la versión Spring '23.
5. Haga clic en Guardar.
6. Haga clic en Deploy New Domain (Implementar nuevo dominio).

La opción Roll Back an AWS Lambda Function Update After Enhanced Domains is Enabled (Revertir una actualización de las funciones de AWS Lambda después de activar los dominios mejorados) está activada

Esta configuración se aplica al siguiente modelo de telefonía:

• Service Cloud Voice con Amazon Connect
• Service Cloud Voice con telefonía para socios de Amazon Connect

Si tiene funciones de AWS Lambda personalizadas y no quiere reemplazarlas por las versiones más recientes y actualizadas después de activar los dominios mejorados, puede revertir la actualización de Lambda. Para ello, después de realizar la reversión, actualice manualmente algunas URL de variables de entorno determinadas en las funciones de Lambda para que apunten a la nueva versión de la URL de dominios mejorados.

Para revertir la actualización de una función de Lambda desencadenada tras la activación de los dominios mejorados, haga lo siguiente:

1. Siga los pasos descritos en Revertir una actualización de Lambda para revertir las funciones de Lambda.
2. En Setup (Configuración), en el cuadro Quick Find (Búsqueda rápida), introduzca My Domain (Mi dominio) y, a continuación, seleccione My Domain (Mi dominio).
3. Escriba la URL actual de My Domain (Mi dominio). La URL debe ser "con dominios mejorados", para indicar que los dominios se han activado.
4. En la consola de AWS Lambda, seleccione Functions (Funciones).
5. Actualice las variables de entorno de la función de Lambda en cuestión con la nueva URL de dominios mejorados. Repita este paso con todas las funciones de Lambda.
   1. Haga clic en el nombre de la función para abrir la página de detalles.
   2. Haga clic en la ficha Configuration (Configuración), seleccione Environment variables (Variables de entorno) y haga clic en Edit (Modificar).
   3. Busque cualquier variable de entorno que incluya el dominio de Salesforce o la URL de SCRT2 y cambie las URL a la versión de dominios mejorados que anotó anteriormente.
   4. Guarde sus cambios.

Consulte también:

• Ayuda de Salesforce: Dominios mejorados 
• Artículo de Knowledge: Enhanced Domains and their Impact on Service Cloud Voice (Dominios mejorados y su impacto en Service Cloud Voice)
• Guía del desarrollador: Service Cloud Voice for Partner Telephony Apex Reference (Referencia de Apex sobre Service Cloud Voice para telefonía de socios)