Dominios mejorados y Service Cloud Voice: Spring ‘23

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

• Service Cloud Voice con Amazon Connect. Si Salesforce creó una nueva cuenta de AWS y proporcionó una nueva instancia de Amazon Connect para usted, no tiene que hacer nada. Cuando se activen los dominios mejorados, nos encargaremos de todo en segundo plano automáticamente.
• Service Cloud Voice con Partner Telephony de Amazon Connect (aprovisionado)
  • Si Salesforce usó una cuenta de AWS existente a fin de proporcionar una nueva instancia de Amazon Connect para usted, no tiene que hacer nada. Cuando se activen los dominios mejorados, nos encargaremos de todo en segundo plano automáticamente.
• Service Cloud Voice con Partner Telephony de Amazon Connect (XML de importación)
  • Si usó una cuenta de AWS existente para aprovisionar manualmente una instancia de Amazon Connect con archivos de importación XML, siga los pasos de única vez para garantizar que los usuarios puedan iniciar sesión y usar Service Cloud Voice.
• Service Cloud Voice con Partner Telephony. Si Amazon Connect no es su proveedor de telefonía, siga los pasos de única vez en la sección Service Cloud Voice con Partner Telephony.

Service Cloud Voice con Amazon Connect

Si Salesforce creó una nueva cuenta de AWS y proporcionó una nueva instancia de Amazon Connect para usted, no tiene que hacer nada. Cuando se activen los dominios mejorados, nos encargaremos de todo en segundo plano automáticamente.

Si desea mantener sus funciones personalizadas de AWS Lambda, puede restablecer las actualizaciones de funciones de Lambda. Consulte la sección Restablecer una actualización de función de AWS Lambda después de la activación de los dominios mejorados para seguir los pasos.

Service Cloud Voice con Partner Telephony de Amazon Connect (aprovisionado)

Si originalmente configuró Service Cloud Voice aprovisionando la instancia de Amazon Connect a través de Salesforce, no tiene que hacer nada. Cuando se activen los dominios mejorados, nos encargaremos de todo en segundo plano automáticamente.

Si desea mantener sus funciones personalizadas de AWS Lambda, puede restablecer las actualizaciones de funciones de Lambda. Consulte la sección Restablecer una actualización de función de AWS Lambda después de la activación de los dominios mejorados para seguir los pasos.

Service Cloud Voice con Partner Telephony de Amazon Connect (XML de importación)

Si usó una cuenta de AWS existente para aprovisionar manualmente una instancia de Amazon Connect con archivos de importación XML, siga los siguientes pasos de única vez para garantizar que los usuarios puedan iniciar sesión y usar Service Cloud Voice.

Una vez que realizó los pasos, si desea mantener sus funciones personalizadas de AWS Lambda, puede restablecer las actualizaciones de funciones de Lambda. Consulte la sección Restablecer una actualización de función de AWS Lambda después de la activación de los dominios mejorados para seguir los pasos.

1. Si el inicio de sesión único no funciona, actualice los metadatos de proveedor de Salesforce Identity.
   1. En Configuración, en el cuadro Búsqueda rápida, ingrese Mi dominio y seleccione Proveedor de identidad.
   2. Haga clic en Descargar metadatos y, a continuación, guarde el archivo XML de metadatos en su computadora.
   3. En la Consola de administración de AWS, diríjase al tablero IAM.
   4. Vaya a Administración de acceso > Proveedores de identidad.

5. Haga clic en el proveedor de identidad AmazonConnectSFDC o en el proveedor de identidad que configuró anteriormente, haga clic en Reemplazar metadatos y reemplace el archivo XML de metadatos con la copia que guardó en su computadora.
6. Guarde sus cambios.

2. Si las funciones de Lambda no funcionan, use la URL nueva para actualizar la URL del extremo SCRT (ScrtEndpointUrl) en todas las funciones de Lambda afectadas. Una vez que se activen los dominios mejorados, se cambiará la siguiente URL del extremo SCRT.

ScrtEndpointUrl:

Tipo: cadena

Predeterminado: salesforce-scrt-endpoint-url

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

Puede actualizar las URL del extremo SCRT a través de CloudFormation o manualmente actualizando la URL de las funciones de Lambda afectadas.

Para actualizar las URL del extremo de SCRT a través de CloudFormation:

1. En Configuración, en el cuadro Búsqueda rápida, ingrese Mi dominio y seleccione Mi dominio.
2. Copie la URL de Mi dominio actual. La URL debe ser "con dominios mejorados", para indicar que estos se activaron.
3. En la Consola de administración de AWS, vaya a CloudFormation > Pilas > ServerlessApplicationStack.
4. Haga clic en el nombre de la pila que desea cambiar.
5. Haga clic en la fichaParámetros.
6. Cambie el valor de la clave ScrtEndpointUrl a la URL de Mi dominio que copió. Por ejemplo, si su URL de Mi dominio es MyDomainName.my.salesforce.com, el valor de ScrtEndpointUrl es https://MyDomainName.my.salesforce-scrt.com.

Para actualizar la URL del extremo de SCRT en cada función de Lambda afectada:

1. En Configuración, en el cuadro Búsqueda rápida, ingrese Mi dominio y seleccione Mi dominio.
2. Copie la URL de Mi dominio actual. La URL debe ser "con dominios mejorados", para indicar que estos se activaron.
3. En la Consola de administración de AWS, vaya al servicio de Lambda AWS y seleccione Funciones.
4. En la lista de nombres de función, haga clic en el nombre de la función.
5. Haga clic en la ficha Configuración, seleccione Variables de entorno y, luego, haga clic en Modificar.
6. Cambie el valor de la clave ScrtEndpointUrl a la URL de Mi dominio que copió. Por ejemplo, si su URL de Mi dominio es MyDomainName.my.salesforce.com, el valor de ScrtEndpointUrl es https://MyDomainName.my.salesforce-scrt.com.
7. Haga clic en Guardar.

3. Si usa una función de Lambda que invoca un extremo de API de REST de Salesforce, actualice las variables de entorno para esas funciones de Lambda.
   1. En la Consola de administración de AWS, vaya al servicio de Lambda AWS y seleccione Funciones.
   2. En la lista de nombres de función, haga clic en el nombre de la función.
   3. Haga clic en la ficha Configuración, seleccione Variables de entorno y, luego, haga clic en Modificar.
   4. Cambie el valor de SALESFORCE_AUTH_ENDPOINT de Mi dominio a la URL que copió. Por ejemplo, https://MyDomainName.my.salesforce.com/services/oauth2/token.

Para comprobar su nombre de Mi dominio, en Salesforce, vaya a Salesforce > Configuración > MyDomain.

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

Service Cloud Voice con Partner Telephony

Si originalmente configuró Service Cloud Voice con un servicio de telefonía que no es Amazon Connect, siga los siguientes pasos de única vez después de que se activen los dominios mejorados. 

1. Activar los dominios mejorados si están desactivados.
2. Aprovisionar e implementar el nuevo Mi dominio.
3. Actualice todas las URL de API de conector preprogramadas, los extremos de API de REST de telefonía y las referencias a la URL de SCRT2 con las nuevas URL. Asegúrese de actualizar la URL de inicio de sesión de Mi dominio para el sandbox debido a que cambia con los dominios mejorados. Si no actualiza la URL, los usuarios no podrán iniciar sesión.
4. De manera opcional, implemente la interfaz de Apex service_cloud_voice.UpdateOrgDomainProvider para recibir notificaciones sobre futuros cambios en Mi dominio en su organización. La interfaz contiene una API a la que se llama siempre que la URL de MyDomain cambia y envía información del dominio actualizado al socio de implementación, quien puede actualizar 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 Partner Telephony de Amazon Connect
• Service Cloud Voice con Partner Telephony

Puede desactivar los dominios mejorados temporalmente. Sin embargo, se recomienda que active los dominios mejorados antes de la versión Winter ‘24 a fin de tener el tiempo suficiente para probar sus entornos con la nueva configuración. 

1. En Configuración, en el cuadro Búsqueda rápida, ingrese Mi dominio y seleccione Mi dominio.
2. En la sección Enrutamiento, haga clic en Modificar.
3. Anule la selección de Dominios mejorados.
4. Anule la selección de Estabilizar direcciones URL de Visualforce, Experience Builder, Site.com Studio y de archivos de contenido si se anuló la selección antes de Spring ‘23.
5. Haga clic en Guardar.
6. Haga clic en Implementar Nuevo dominio.

Restablezca una actualización de función de AWS Lambda después de la activación de los dominios mejorados

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

• Service Cloud Voice con Amazon Connect
• Service Cloud Voice con Partner Telephony de Amazon Connect

Si tiene funciones de Lambda de AWS personalizadas y no desea reemplazarlas por las versiones actualizadas más recientes, restablezca la actualización de Lambda cuando se activen los dominios mejorados. Para hacer esto, después del restablecimiento, actualice manualmente determinadas URL de variables de entorno en sus funciones de Lambda para señalar la nueva versión de URL de los dominios mejorados.

Para restablecer una actualización de función de Lambda que se desencadenó cuando se activaron los dominios mejorados:

1. Siga los pasos en Restablecer una actualización de Lambda para restablecer las funciones de Lambda.
2. En Configuración, en el cuadro Búsqueda rápida, ingrese Mi dominio y seleccione Mi dominio.
3. Anote la URL de Mi dominio actual. La URL debe ser "con dominios mejorados", para indicar que estos se activaron.
4. En la consola Lambda de AWS, seleccione Funciones.
5. Actualice las variables de entorno de función de Lambda con la nueva URL de dominios mejorados. Repita este paso para todas las funciones de Lambda.
   1. Haga clic en el nombre de la función para abrir su página de detalles.
   2. Haga clic en la ficha Configuración, seleccione Variables de entorno y, luego, haga clic en Modificar.
   3. Busque las variables de entorno que incluyan la URL del dominio de Salesforce o la URL de SCRT2, y cambie esas URL a la versión de dominios mejorados que anotó.
   4. Guarde sus cambios.

Consulte también:

• Ayuda de Salesforce: Dominios mejorados 
• Artículo de Knowledge: Dominios mejorados y su impacto en Service Cloud Voice
• Guía del desarrollador: Referencia de Apex de Service Cloud Voice para Partner Telephony