Configurer l’expérience intégrée dans Salesforce

Vous pouvez intégrer Service dans les agents Microsoft 365 Copilot directement dans le bureau Salesforce avec une connaissance contextuelle de la plateforme sous-jacente. Cette intégration permet aux assistants IA de fournir de meilleures réponses et de rationaliser davantage le flux de travail de vos représentants du service clientèle.

Prérequis

Avant de commencer, vous devez disposer de la console et des environnements suivants :

Un service dans une instance Microsoft 365 Copilot connecté à un environnement Salesforce.
Un environnement de production ou un environnement d’essai Salesforce avec accès à la console de service Salesforce.

De plus, pour que vos représentants de service puissent utiliser le service dans Microsoft 365 Copilot dans Salesforce, vous devez leur attribuer les rôles d’Utilisateur de base et d’agent omnicanal. Pour en savoir plus, voir Attribuer un rôle de sécurité à un utilisateur.

Intégrer les agents de service préconfigurés

Suivez les étapes de la section Navigation pour copier l’URL du widget intégrable Copilot en commençant après <iframe src=>. Par exemple, https://copilotforservice-test.azureedge.net/widget/index.html?dynamicsUrl=https://XXXXXX.crm10.dynamics.com Enregistrez l’URL localement, où vous pouvez la copier et la coller dans le champ URL de l’adaptateur CTI si vous utilisez le téléphone logiciel CTI ou dans CFS_WIDGET_URL si vous utilisez le composant personnalisé.

Vous pouvez intégrer des agents de service préconfigurés dans Salesforce de l’une des manières suivantes.

Téléphone logiciel CTI
Composant personnalisé

Ouvrez la console de service Salesforce, puis sélectionnez l’icône Configurer (engrenage) dans le coin supérieur droit.
Dans le champ de recherche, saisissez Centre d’appels, puis dans les résultats de recherche, sélectionnez Centres d’appels.
Si vous configurez ce widget pour la première fois, vous verrez peut-être une page avec un message indiquant : Dites bonjour au centre d’appels Salesforce.
Sélectionnez Continuer.

Ouvrez un éditeur de texte, puis copiez-y le code XML suivant et enregistrez-le localement sous CopilotForServiceConfig.xml.

  <callCenter>
  <section sortOrder="0" name="reqGeneralInfo" label="General Information">
  <item sortOrder="0" name="reqInternalName" label="InternalName">CopilotForService</item>
  <item sortOrder="1" name="reqDisplayName" label="Display Name">Copilot For Service</item>
  <item sortOrder="2" name="reqAdapterUrl" label="CTI Adapter URL">https://TobeUpdated.ms</item>
  <item sortOrder="3" name="reqUseApi" label="Use CTI API">true</item>
  <item sortOrder="4" name="reqSoftphoneHeight" label="Softphone Height">600</item>
  <item sortOrder="5" name="reqSoftphoneWidth" label="Softphone Width">450</item>
  <item sortOrder="6" name="reqSalesforceCompatibilityMode" label="Salesforce Compatibility Mode">Classic_and_Lightning</item>
  </section>
 </callCenter>

Sélectionnez Importer>Choisir un fichier, puis accédez au fichier CopilotForServiceConfig.xml que vous avez enregistré à l’étape 4 et sélectionnez-le.
Cliquez sur Importer.
Sélectionnez Modifier, puis dans le champ URL de l’adaptateur CTI, collez l’URL du widget de service que vous avez enregistrée à l’étape 1.
Sélectionnez Enregistrer.
Procédez comme suit pour ajouter des utilisateurs Salesforce :
1. Dans la console de service Salesforce, sélectionnez Gérer les utilisateurs du centre d’appels>Ajouter plus d’utilisateurs.
2. Ajoutez chaque utilisateur Salesforce que vous souhaitez accéder au service dans le widget Microsoft 365 Copilot.
Procédez comme suit pour ajouter l’utilitaire de téléphonie logicielle :
1. Sélectionnez Configurer, puis recherchez et sélectionnez Gestionnaire d’application.
2. Recherchez l’application Console de service, sélectionnez le triangle inversé sur la même ligne, puis sélectionnez Modifier.
3. Sélectionnez Éléments utilitaires>Ajouter un élément utilitaire.
4. Recherchez et sélectionnez Ouvrir le téléphone logiciel CTI.
5. Tapez un nom pour votre widget, par exemple « Service dans Microsoft 365 Copilot ».
6. Définissez la largeur sur 450 et la hauteur sur 600.
7. Sélectionnez Enregistrer.
Procédez comme suit pour activer les fenêtres contextuelles :
1. Dans Salesforce, accédez à la console de service depuis la page Applications.
2. Activez les fenêtres contextuelles en sélectionnant Toujours autoriser les fenêtres contextuelles et les redirections depuis <url>.
3. Cliquez sur Terminé.
4. Actualisez votre navigateur. Le service dans l’extension Microsoft 365 Copilot devrait désormais être disponible dans la barre d’outils de votre console d’agent.

Effectuez les étapes suivantes pour configurer le service dans le widget Microsoft 365 Copilot dans Salesforce :

Ouvrez la console de service Salesforce et sélectionnez l’icône d’engrenage.
Sélectionnez la Console de développeur dans le menu déroulant. Si elle ne se charge pas, copiez l’URL depuis la fenêtre contextuelle et ouvrez-la dans un nouvel onglet.
Dans la Console de développeur, sélectionnez Fichier>Nouveau>Classe Apex. Spécifiez le nom en tant que ObjectService et sélectionnez Créer, puis collez le code suivant dans l’éditeur :
```
public class ObjectService {
  @AuraEnabled
  public static String getObjectType(String objectId) {
    Id conId = objectId;
    return String.valueOf(conId.getSobjectType());
  }
}
```

Procédez comme suit pour créer un composant d’éclairage :

Sélectionnez Fichier>Nouveau>Composant d’éclairage.
Spécifiez un nom pour le composant. Par exemple, CopilotForService.
Sélectionnez Contrôleur dans le volet du pack qui s’affiche lors de la création du composant, puis collez le code suivant :

({
  onTabFocused : function(component, event, helper) {
    var currentTabId = event.getParam('currentTabId');
    var previousTabId = event.getParam('previousTabId');
    var workspaceAPI = component.find("workspace");
    if(currentTabId) {       
      workspaceAPI.getTabInfo({
        tabId : currentTabId
      }).then(function(response) {
        var action = component.get("c.getObjectType");
        var recordId = response.recordId;
        action.setParams({"objectId": recordId});
        action.setCallback(this, function(response) {
          var state = response.getState();
          if(state === "SUCCESS") {
            component.set("v.objectType",response.getReturnValue());
            var type = response.getReturnValue();          
            console.log("Object details:", recordId, type);
            var objectType = 0;
            if (type == 'Case') {
              objectType = 1;
            } else if (type == 'EmailMessage') {
              objectType = 2;
            } else if (type == "LiveChatTranscript") {
              objectType = 8;
            }

            console.log("iframe: ", document.querySelector('iframe.CFSLightning'));
            // Invoke adapter to navigate based on objectid and objecttype
            document.querySelector('iframe.CFSLightning').contentWindow.postMessage({
              messageType: "onPageNavigateFromSFLightningComponent",
              messageData: JSON.stringify({
                value: JSON.stringify({
                  objectId: recordId,
                  objectType: objectType,
                  sourceId: "b54abfa8-3d78-4aa0-ae3f-1e2ffbc56850"
                })
              })
            }, "*");
          } else {
            console.log('Problem updating the case, response state: ' + state);
          }
        });
        $A.enqueueAction(action);
      });
    } else {
      // When user navigates to the entity list page, switch to global session
      console.log("global!");
      document.querySelector('iframe.CFSLightning').contentWindow.postMessage({
        messageType: "onPageNavigateFromSFLightningComponent",
        messageData: JSON.stringify({
          value: JSON.stringify({
            objectId: "",
            objectType: 0,
            sourceId: "b54abfa8-3d78-4aa0-ae3f-1e2ffbc56850"
          })
        })
      }, "*");
    }
  }
})

Sélectionnez Enregistrer.
Sélectionnez Composant, puis copiez le code suivant :

<aura:component controller="ObjectService" implements="force:lightningQuickAction,force:hasRecordId,flexipage:availableForAllPageTypes" access="global">
  <aura:attribute name="recordId" type="Id" />
  <aura:attribute name="objectType" type="String" />
  <lightning:workspaceAPI aura:id="workspace" />        
  <aura:handler event="lightning:tabFocused" action="{! c.onTabFocused }"/>
  <iframe class="CFSLightning" src="{! '{CFS_WIDGET_URL}'}" width="100%" height="100%" />   
</aura:component>

Mettez à {CFS_WIDGET_URL} jour l’URL du service dans l’URL du widget Microsoft Copilot que vous avez enregistrée à l’étape précédente.

Procédez comme suit pour ajouter le composant personnalisé à la barre d’utilitaires :
1. Sélectionnez Configurer, puis recherchez et sélectionnez Gestionnaire d’application.
2. Recherchez, puis sélectionnez l’application Console de service. Cliquez sur Modifier.
3. Sélectionnez Éléments utilitaires>Ajouter un élément utilitaire.
4. Recherchez et sélectionnez le composant d’éclairage personnalisé dans Personnalisé, CopilotForService dans notre exemple.
5. Spécifiez un nom pour le widget. Par exemple, Service dans Microsoft 365 Copilot.
6. Définissez la largeur sur 450 et la hauteur sur 600.
7. Sélectionnez Enregistrer.
Procédez comme suit pour activer les fenêtres contextuelles :
1. Dans Salesforce, accédez à la console de service depuis la page Applications.
2. Activez les fenêtres contextuelles en sélectionnant Toujours autoriser les fenêtres contextuelles et les redirections depuis <url>.
3. Cliquez sur Terminé.
4. Actualisez votre navigateur. Le service dans l’extension Microsoft 365 Copilot devrait désormais être disponible dans la barre d’outils de votre console d’agent.
Effectuez les étapes suivantes pour permettre la liste du service dans le widget Microsoft 365 Copilot :
1. Recherchez les URL approuvées dans la zone de recherche de Configuration, puis sélectionnez URL approuvées.
2. Sélectionnez Nouvelle URL approuvée pour ajouter une nouvelle URL approuvée.
  - Spécifiez CopilotforService comme nom d’API et « *.azureedge.net » comme URL
3. Cochez toutes les cases dans Directives CSP, puis sélectionnez Enregistrer.

Rétroaction

Cette page a-t-elle été utile ?

Last updated on 2025-12-11

Partager via

Configurer l’expérience intégrée dans Salesforce

Prérequis

Intégrer les agents de service préconfigurés

Rétroaction

Ressources additionnelles