---
sourceDocument: Gestion du service à la clientèle de Yokohama
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/yokohama/customer-service-management

 Release :

    - yokohama

ft:locale :

    - fr-FR

ft:publication_title :

    - Gestion du service à la clientèle de Yokohama

ft:clusterId :

    - csm

bundleId :

    - csm

workflow :

    - Customer and Industry


---

# Lancer une fonctionnalité à Engagement Messenger l'aide d'un code personnalisé

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

* Rversion finale: Yokohama
* 
* Mis à jour 30 janv. 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 minutes de lecture

Utilisez le code personnalisé pour activer le lien profond et lancer une fonctionnalité intégrée Engagement Messenger à votre site Web.

## Avant de commencer

[Configurer Engagement Messenger](https://servicenow-prod.fluidtopics.net/Z7PJVYdXRzlyZ_NvYibweQ "Créez un Engagement Messenger module 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 l’image de marque de votre organisation et des besoins de vos clients.").

[Incorporer Engagement Messenger dans votre application Web](https://servicenow-prod.fluidtopics.net/Ovjj6gGcJVfFV_rY1Pvjeg "Intégrez le code source du module de messagerie que vous avez configuré dans votre site Web afin de permettre à vos clients de commencer à l’utiliser Engagement Messenger sur votre site Web.").

Rôle requis : administrateur ec_admin et site web

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

Remarque :  
Si vous utilisez du code existant, vérifiez que vous mettez à 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 à Engagement MessengerModules.
2. Dans le module Configurer Engagement Messenger, ouvrez l'onglet Implémenter.
3. Copiez le code depuis la section Code intégré.
4. Dans un éditeur de texte, ouvrez le fichier HTML de la page Web de votre site Web sur lequel vous intégrez Engagement Messenger.
5. Collez le code que vous avez copié avant la balise de corps de fermeture.
6. Définissez le contexte de la fonctionnalité et spécifiez les variables pour la fonctionnalité.  
   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 le format, spécifiez les variables de fonctionnalité.

   fonctionnalité
   :   Nom de la fonctionnalité. Pour plus d'informations, reportez-vous à .[Paramètres de contexte de fonctionnalité pris en charge dans Engagement Messenger](https://servicenow-prod.fluidtopics.net/yPyJ~FScUtiKF3ZPvgCIwQ "Les fonctionnalités de l’option 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 vrai uniquement si vous souhaitez Engagement Messenger l'ouvrir automatiquement. Le paramètre par défaut de cette option est de Engagement Messenger ne pas s'ouvrir automatiquement.

   \<param_name\> \>\> : \<\< \<param_value\>
   :   Nom et valeur d'un paramètre associé à la fonctionnalité. Pour plus d'informations, consultez [Paramètres de contexte de fonctionnalité pris en charge dans Engagement Messenger](https://servicenow-prod.fluidtopics.net/yPyJ~FScUtiKF3ZPvgCIwQ "Les fonctionnalités de l’option de lancement contextuel vous permettent de définir l’écran de lancement par défaut dans Engagement Messenger.").
7. Créez une fonction wrapper personnalisée pour transmettre le contexte de la fonctionnalité à la fonction `SN_CSM_EC.init` du code d'intégration.  
   Par exemple, le code suivant utilise la fonction de couche personnalisée `chatFeatureContext()` pour le contexte de la 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 une fonction de couche personnalisée que vous avez créée à [l'étape 7](https://servicenow-prod.fluidtopics.net/T9tFqXSz1beNcskTvPv_kA "Utilisez le code personnalisé pour activer le lien profond et lancer une fonctionnalité intégrée Engagement Messenger à 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. Sélectionnez l'icône du lanceur.
    3. Vérifiez que lance la fonctionnalité que Engagement Messenger vous avez configurée dans le code d'intégration.
    {#contextual-launch-using-script-engagement-messenger__substeps_gjt_cts_4qb}

## Résultats

La fonctionnalité que vous avez spécifiée dans le code d'intégration est lancée par défaut lorsqu'elle Engagement Messenger est ouverte sur le site web dans lequel elle est intégrée.

## Exemple

Le code suivant lance la fonctionnalité de messagerie instantanée par défaut. Elle montre également comment déclencher une Agent virtuel rubrique par défaut lors du chargement de la messagerie instantanée en transmettant l'identificateur système (sys_id) de la rubrique. Vous pouvez également spécifier une langue pour lancer la conversation 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> : fonction wrapper pour le contexte de chat.

fonctionnalité
:   <var class="keyword varname">MESSAGERIE INSTANTANÉE</var> : fonctionnalité de messagerie instantanée permettant d'initier une conversation par messagerie Agent actif instantanéeAgent virtuel.

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

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

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