---
sourceDocument: Gestion du service clientèle Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/xanadu/customer-service-management

 Release :

    - xanadu

ft:locale :

    - fr-FR

ft:publication_title :

    - Gestion du service clientèle Xanadu

ft:clusterId :

    - csm

bundleId :

    - csm

workflow :

    - Customer and Industry


---

# Lancer une fonctionnalité dans Engagement Messenger à l'aide de code personnalisé

# Lancer une fonctionnalité dans Engagement Messenger à l'aide de code personnalisé {#ariaid-title1}

* Rversion finale: Xanadu
* 
* Mis à jour 1 août 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 minutes de lecture

Utilisez du code personnalisé pour activer les liens profonds et lancer une fonctionnalité dans Engagement Messenger intégrée à votre site Web.

## Avant de commencer

[Configurer Engagement Messenger](https://servicenow-prod.fluidtopics.net/AkWoPYPyLYYcHWYYCu76Nw "Créez le module Engagement Messenger et configurez son comportement, son apparence et son style. En créant un module de messagerie, vous pouvez personnaliser l'apparence et le comportement en fonction de la personnalisation de votre organisation et des besoins de vos clients.").

[Incorporer Engagement Messenger dans votre application Web](https://servicenow-prod.fluidtopics.net/tJiYuVoo50EnL2q5~LNX7w "Incorporez le code source du module de messagerie que vous avez configuré dans votre site Web afin de permettre à vos clients d'utiliser Engagement Messenger sur votre site Web.").

Rôle requis : ec_admin et administrateur de sites Web

## Pourquoi et quand exécuter cette tâche

Remarque :  
Si vous utilisez le code existant, assurez-vous de mettre à jour le script pour afficher `v=3.1`. Par exemple :  

    <script src="https://example.service-now.com/scripts/sn_csm_ec.js?v=3.1"></script>
    <script>
    SN_CSM_EC.init({
          moduleID: "https://example.service-now.com/#aeff0547dd393010f87734cef087e2ba",
          loadFeature: SN_CSM_EC.loadEMFeature()
    });
    </script>

## Procédure

1. Accédez à la Engagement MessengerModules.
2. Dans Configurer le module Engagement Messenger, ouvrez l'onglet Implémenter.
3. Copiez le code à partir de la section Code intégré.
4. Dans un éditeur de texte, ouvrez le fichier HTML de la page Web sur votre site Web où vous intégrez Engagement Messenger.
5. Collez le code que vous avez copié avant la balise de fermeture du corps.
6. Définissez le contexte de la fonctionnalité et spécifiez ses variables.  
   Utilisez le format suivant pour définir un contexte de fonctionnalité :

       { 
       	feature: "<var class="keyword varname">&lt;feature_name&gt;</var>", 
       	openOnLoad: <var class="keyword varname">&lt;true/false&gt;</var>, 
       	params: { 
       		"<var class="keyword varname">&lt;param_name&gt;</var>": "<var class="keyword varname">&lt;param_value&gt;</var>",
       		"<var class="keyword varname">&lt;param_name&gt;</var>": "<var class="keyword varname">&lt;param_value&gt;</var> 
       	} 
       }

   Dans ce format, spécifiez les variables de fonctionnalité.

   fonctionnalité
   :   Nom de la fonctionnalité. Pour en savoir plus, consultez [Paramètres de contexte de fonctionnalité pris en charge dans Engagement Messenger](https://servicenow-prod.fluidtopics.net/x_SA8nbZAXQim_Ir4jAODQ "Les fonctionnalités de lancement contextuel vous permettent de définir l'écran de lancement par défaut dans Engagement Messenger.") .

   openOnLoad
   :   Incluez cette option et définissez-la sur true uniquement si vous souhaitez que Engagement Messenger s'ouvre automatiquement. Par défaut, cette option est définie de façon à que Engagement Messenger ne s'ouvre pas automatiquement.

   \<param_name\>": "\<param_value\>
   :   Nom et valeur d'un paramètre associé à la fonctionnalité. Pour plus d'informations, voir [Paramètres de contexte de fonctionnalité pris en charge dans Engagement Messenger](https://servicenow-prod.fluidtopics.net/x_SA8nbZAXQim_Ir4jAODQ "Les fonctionnalités de lancement contextuel vous permettent de définir l'écran de lancement par défaut dans Engagement Messenger.").
7. Créez une fonction de couche personnalisée pour transmettre le contexte de fonctionnalité à la fonction `SN_CSM_EC.init` du code intégré.  
   Par exemple, le code suivant utilise la fonction de couche personnalisée `chatFeatureContext()` pour le contexte de fonctionnalité de messagerie instantanée.


       function chatFeatureContext(){ 
       	return { 
       			feature: "CHAT",
       			openOnLoad: false,
       			params: { 
       				"topic_id": "8708db281bd5b81080df6247b04bcb79",
       				"language": "fr"		
       				} 
       		  } 
       }

   {#contextual-launch-using-script-engagement-messenger__wrapper-creation}
{#contextual-launch-using-script-engagement-messenger__wrapper-creation}
8. Remplacez la fonction `SN_CSM_EC.loadEMFeature()` par la fonction de couche personnalisée que vous avez créée à l'[étape 7](https://servicenow-prod.fluidtopics.net/AFrwwUkUj8A~3lPUWMDTTg "Utilisez du code personnalisé pour activer les liens profonds et lancer une fonctionnalité dans Engagement Messenger intégrée à votre site Web.").  
   Par exemple, dans le code suivant, la fonction `wrapper chatFeatureContext()` est transmise en tant que valeur de l'attribut `loadFeature ` .

       SN_CSM_EC.init({ 
       		moduleID: "https://example.service-now.com/#<module_id>", 
       		loadFeature: <var class="keyword varname">chatFeatureContext</var>()
       }); 

9. Enregistrez le fichier.
10. **Facultatif :** Vérifiez que la fonctionnalité désignée se lance.
    1. Ouvrez le site Web dans lequel vous avez intégré Engagement Messenger.
    2. Cliquez sur l'icône de lanceur.
    3. Vérifiez que Engagement Messenger lance la fonctionnalité que vous avez configurée dans le code intégré.
    {#contextual-launch-using-script-engagement-messenger__substeps_gjt_cts_4qb}

## Résultats

La fonctionnalité que vous avez spécifiée dans le code intégré est lancée par défaut lors de l'ouverture de Engagement Messenger sur le site Web dans lequel il est incorporé.

## Exemple

Le code suivant lance la fonctionnalité de messagerie instantanée par défaut. Il montre également comment déclencher une rubrique Agent virtuel par défaut lorsque la messagerie instantanée est chargée en transmettant l'identificateur système (sys_id) de la rubrique. Vous pouvez également spécifier une langue pour lancer la messagerie instantanée dans cette langue.

    <script src="https://example.servicenow.com/scripts/sn_csm_ec.js?v=3.1"></script>
    <script>
    function chatFeatureContext(){ 
    	return { 
    			feature: "CHAT",
    			openOnLoad: false,
    			params: { 
    				"topic_id": "8708db281bd5b81080df6247b04bcb79",
    				"language": "fr"		
    				} 
    		  } 
    }

    SN_CSM_EC.init({
    	moduleID: "https://example.service-now.com/#d27c94d6db403810a2a6a0ced39619da",
    	loadFeature: chatFeatureContext()
    });
    </script>

function
:   <var class="keyword varname">chatFeatureContext()</var> : la fonction de couche pour le contexte de messagerie instantanée.

fonctionnalité
:   <var class="keyword varname">CHAT</var> : la fonctionnalité de messagerie instantanée permettant de lancer la messagerie instantanée Agent virtuel ou Agent actif.

openOnLoad
:   <var class="keyword varname">false</var> : désactivez le lancement automatique de Engagement Messenger.

topic_id
:   <var class="keyword varname">8708db281bd5b81080df6247b04bcb79 </var> : l'identificateur du système de module (sys_id).

langue
:   <var class="keyword varname">fr</var> : définit la langue de messagerie instantanée par défaut sur Français.