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

Rversion finale: Australia

Mis à jour 12 mars 2026

2 minutes de lecture

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

Avant de commencer

Configurer Engagement Messenger.

Incorporer Engagement Messenger dans votre application 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

Accédez à la Engagement Messenger > Modules.
Dans le module Configurer Engagement Messenger, ouvrez l’onglet Implémenter.
Copiez le code depuis la section Code intégré.
Dans un éditeur de texte, ouvrez le fichier HTML de la page Web de votre site Web sur lequel vous intégrez Engagement Messenger.
Collez le code que vous avez copié avant la balise de corps de fermeture.
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: "<feature_name>", 
	openOnLoad: <true/false>, 
	params: { 
		"<param_name>": "<param_value>",
		"<param_name>": "<param_value> 
	} 
}
```
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

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.
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"		
				} 
		  } 
}
```
Remplacez la fonction SN_CSM_EC.loadEMFeature() par une fonction de couche personnalisée que vous avez créée à l’étape 7.
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: chatFeatureContext()
}); 
```
Enregistrez le fichier.
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.

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: chatFeatureContext() : fonction wrapper pour le contexte de chat.
fonctionnalité: MESSAGERIE INSTANTANÉE : fonctionnalité de messagerie instantanée permettant d’initier une conversation par messagerie Agent actif instantanéeAgent virtuel.
openOnLoad: false : désactivez le lancement automatique de Engagement Messenger.
topic_id: 8708db281bd5b81080df6247b04bcb79 : identificateur système du module (sys_id).
language: fr : définit la langue de messagerie instantanée par défaut sur le français.