Domaines avancés et Service Cloud Voice - Spring ‘23

Préparez la publication de la version Winter ‘24 pour laquelle les domaines avancés doivent être activés dans toutes les organisations.

• Service Cloud Voice avec Amazon Connect. Si Salesforce a créé un compte AWS et provisionné une nouvelle instance Amazon Connect pour vous, vous n'avez rien à faire. Lorsque les domaines avancés sont activés, nous nous occupons de tout en arrière-plan.
• Service Cloud Voice avec Partner Telephony d'Amazon Connect (provisionnée)
  • Si Salesforce a utilisé un compte AWS existant pour provisionner une nouvelle instance Amazon Connect pour vous, vous n'avez rien à faire. Lorsque les domaines avancés sont activés, nous nous occupons de tout en arrière-plan.
• Service Cloud Voice avec Partner Telephony d'Amazon Connect (importation XML)
  • Si vous avez utilisé un compte AWS existant pour provisionner manuellement une instance Amazon Connect en utilisant des fichiers d'importation XML, exécutez des étapes uniques pour vérifier que les utilisateurs peuvent se connecter à et utiliser Service Cloud Voice.
• Service Cloud Voice avec Partner Telephony. Si votre fournisseur de téléphonie n'est pas Amazon Connect, exécutez des étapes uniques dans la section Service Cloud Voice avec Partner Telephony.

Service Cloud Voice with Amazon Connect

Si Salesforce a créé un compte AWS et provisionné une nouvelle instance Amazon Connect pour vous, vous n'avez rien à faire. Lorsque les domaines avancés sont activés, nous nous occupons de tout en arrière-plan.

Si vous souhaitez conserver vos fonctions AWS Lambda personnalisées, vous pouvez annuler les mises à jour de fonction Lambda. Pour les étapes à suivre, consultez la section Roll Back an AWS Lambda Function Update After Enhanced Domains is Enabled.

Service Cloud Voice avec Partner Telephony d'Amazon Connect (provisionnée)

Si vous avez initialement configuré Service Cloud Voice en provisionnant l'instance Amazon Connect via Salesforce, vous n'avez rien à faire. Lorsque les domaines avancés sont activés, nous nous occupons de tout en arrière-plan.

Si vous souhaitez conserver vos fonctions AWS Lambda personnalisées, vous pouvez annuler les mises à jour de fonction Lambda. Pour les étapes à suivre, consultez la section Roll Back an AWS Lambda Function Update After Enhanced Domains is Enabled.

Service Cloud Voice avec Partner Telephony d'Amazon Connect (importation XML)

Si vous avez utilisé un compte AWS existant pour provisionner manuellement une instance Amazon Connect en utilisant des fichiers d'importation XML, exécutez des étapes uniques suivantes pour vérifier que les utilisateurs peuvent se connecter à et utiliser Service Cloud Voice.

Après avoir exécuté les étapes, si vous souhaitez conserver vos fonctions Lambda AWS personnalisées, vous pouvez annuler les mises à jour de fonction Lambda. Pour les étapes à suivre, consultez la section Roll Back an AWS Lambda Function Update After Enhanced Domains is Enabled.

1. Si l'authentification unique ne fonctionne pas, mettez à jour les métadonnées du fournisseur d'identité Salesforce.
   1. Dans Configuration, saisissez Mon domaine dans la case Recherche rapide, puis sélectionnez Fournisseur d'identité.
   2. Cliquez sur Téléchargez les métadonnées, puis enregistrez le fichier XML des métadonnées sur votre ordinateur.
   3. Dans la Console de gestion AWS, accédez au tableau de bord IAM.
   4. Accédez à Gestion de l'accès > Fournisseurs d’identité.

5. Cliquez sur le fournisseur d'identité AmazonConnectSFDC ou sur le fournisseur d'identité précédemment configuré, sur Remplacer les métadonnées, puis remplacez le fichier XML des métadonnées par la copie que vous avez enregistrée sur votre ordinateur.
6. Enregistrez vos modifications.

2. Si les fonctions Lambda ne fonctionnent pas, mettez à jour l'URL du point de terminaison SCRT (ScrtEndpointUrl) dans toutes les fonctions Lambda impactées vers la nouvelle URL. L'URL du point de terminaison SCRT suivante change lorsque les domaines avancés sont activés.

ScrtEndpointUrl :

Type : Chaîne

Par défaut : salesforce-scrt-endpoint-url

Description : URL du point de terminaison du serveur en temps réel Salesforce

Vous pouvez mettre à jour les URL de point de terminaison SCRT via CloudFormation ou en mettant manuellement à jour l'URL de chaque fonction Lambda impactée.

Pour mettre à jour les URL de point de terminaison SCRT via CloudFormation :

1. Dans Configuration, saisissez Mon domaine dans la case Recherche rapide, puis sélectionnez Mon domaine.
2. Copiez l'URL Mon domaine actuelle. L'URL doit être « with enhanced domains », ce qui indique que les domaines avancés sont activés.
3. Dans la Console de gestion AWS, accédez à CloudFormation > Stacks > ServerlessApplicationStack.
4. Cliquez sur le nom de la pile que vous souhaitez modifier.
5. Cliquez sur l'onglet Paramètres.
6. Remplacez la valeur de la clé ScrtEndpointUrl par l'URL Mon domaine que vous avez copiée. Par exemple, si votre URL Mon domaine est MyDomainName.my.salesforce.com, la valeur ScrtEndpointUrl est https://MyDomainName.my.salesforce-scrt.com.

Pour mettre à jour l'URL du point de terminaison SCRT dans chaque fonction Lambda impactée :

1. Dans Configuration, saisissez Mon domaine dans la case Recherche rapide, puis sélectionnez Mon domaine.
2. Copiez l'URL Mon domaine actuelle. L'URL doit être « with enhanced domains », ce qui indique que les domaines avancés sont activés.
3. Dans la Console de gestion AWS, accédez au service AWS Lambda, puis sélectionnez Fonctions.
4. Cliquez sur le nom de la fonction dans la liste.
5. Cliquez sur l'onglet Configuration, sélectionnez Variables d'environnement, puis cliquez sur Modifier.
6. Remplacez la valeur de la clé ScrtEndpointUrl par l'URL Mon domaine que vous avez copiée. Par exemple, si votre URL Mon domaine est MyDomainName.my.salesforce.com, la valeur ScrtEndpointUrl est https://MyDomainName.my.salesforce-scrt.com.
7. Cliquez sur Enregistrer.

3. Si vous utilisez des fonctions Lambda qui invoquent le point de terminaison d'API REST Salesforce, mettez les variables d'environnement à jour pour ces fonctions Lambda.
   1. Dans la Console de gestion AWS, accédez au service AWS Lambda, puis sélectionnez Fonctions.
   2. Cliquez sur le nom de la fonction dans la liste.
   3. Cliquez sur l'onglet Configuration, sélectionnez Variables d'environnement, puis cliquez sur Modifier.
   4. Remplacez la valeur Mon domaine SALESFORCE_AUTH_ENDPOINT par l'URL que vous avez copiée, par exemple https://MyDomainName.my.salesforce.com/services/oauth2/token.

Pour vérifier votre nom Mon domaine, dans Salesforce, accédez à Salesforce > Configuration > Mon domaine.

5. Remplacez la valeur Mon domaine SALESFORCE_REST_API_ENDPOINT_BASE par l'URL que vous avez copiée, par exemple https://MyDomainName.my.salesforce.com/services/data/v<##.#>.
6. Cliquez sur Enregistrer.

Service Cloud Voice avec Partner Telephony

Si vous avez initialement configuré Service Cloud Voice avec une téléphonie partenaire différente d'Amazon Connect, exécutez les étapes uniques suivantes une fois les Domaines avancés sont activés. 

1. Activez les domaines avancés s'ils sont désactivés.
2. Provisionnez et déployez le nouveau Mon domaine.
3. Mettez à jour toutes les URL d'API Connect codées en dur, les points de terminaison d'API REST Telephony et les références à l'URL SCRT2 avec les nouvelles URL. Pensez à mettre à jour l'URL de connexion Mon domaine pour la sandbox, car l'URL change avec les domaines avancés. Les utilisateurs ne peuvent pas se connecter si vous ne mettez pas l'URL à jour.
4. Vous pouvez implémenter l'interface Apex service_cloud_voice.UpdateOrgDomainProvider pour être notifié des futurs changements de Mon domaine dans votre organisation. L'interface contient une API qui est appelée dès que l'URL Mon domaine change et envoie les informations sur le domaine mis à jour aux partenaires d'implémentation qui peut ainsi mettre les URL affectées à jour.

Désactivation des domaines avancés

Cette configuration s'applique aux modèles de téléphonie suivants :

• Service Cloud Voice avec Amazon Connect
• Service Cloud Voice avec Partner Telephony d'Amazon Connect
• Service Cloud Voice avec Partner Telephony

Vous pouvez désactiver temporairement les domaines avancés. Cependant, nous recommandons vivement d'activer les domaines avancés bien avant la publication de Winter ‘24 pour avoir le temps de tester votre environnement avec les nouveaux paramètres. 

1. Dans Configuration, saisissez Mon domaine dans la case Recherche rapide, puis sélectionnez Mon domaine.
2. Dans la section Acheminement, cliquez sur Modifier.
3. Désélectionnez Domaines avancés.
4. Désélectionnez Stabiliser les URL Visualforce, Experience Builder, Site.com Studio et de fichier de contenu, si cette case avait été désélectionnée avant la version Spring ’23.
5. Cliquez sur Enregistrer.
6. Cliquez sur Déployer Nouveau domaine.

Annulation d'une mise à jour de fonction AWS Lambda après l'activation des domaines avancés

Cette configuration s'applique aux modèles de téléphonie suivants :

• Service Cloud Voice avec Amazon Connect
• Service Cloud Voice avec Partner Telephony d'Amazon Connect

Si vous avez personnalisé des fonctions AWS Lambda et ne souhaitez pas les remplacer par les toutes dernières versions mises à niveau lorsque les domaines avancés sont activés, vous pouvez annuler la mise à jour Lambda. Pour cela, après avoir effectué l'annulation, mettez manuellement à jour certaines URL de variable d'environnement dans vos fonctions Lambda, pour pointer vers la nouvelle version de l'URL des domaines avancés.

Pour annuler une mise à jour de fonction Lambda déclenchée lors de l'activation des domaines avancés :

1. Suivez les étapes présentées dans Annulation d'une mise à jour Lambda pour annuler les fonctions Lambda.
2. Dans Configuration, saisissez Mon domaine dans la case Recherche rapide, puis sélectionnez Mon domaine.
3. Écrivez l'URL Mon domaine actuelle. L'URL doit être « with enhanced domains », ce qui indique que les domaines avancés sont activés.
4. Dans la console AWS Lambda, sélectionnez Fonctions.
5. Mettez à jour les variables d'environnement de la fonction Lambda avec la nouvelle URL des domaines avancés. Répétez pour chaque fonction Lambda.
   1. Cliquez sur le nom de la fonction pour ouvrir sa page de détails.
   2. Cliquez sur l'onglet Configuration, sélectionnez Variables d'environnement, puis cliquez sur Modifier.
   3. Recherchez les variables d'environnement qui contiennent l'URL du domaine Salesforce ou SCRT2, puis remplacez-les par la version des domaines avancés que vous avez notée.
   4. Enregistrez vos modifications.

Voir aussi :

• Aide de Salesforce : Domaines avancés 
• Article Knowledge : Domaines avancés et leur impact sur Service Cloud Voice
• Developer Guide : Service Cloud Voice for Partner Telephony Apex Reference