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

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 : ec_admin et administrateur de sites 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 à la Engagement Messenger > Modules.
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 corps de fermeture.
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: "<feature_name>", 
   	openOnLoad: <true/false>, 
   	params: { 
   		"<param_name>": "<param_value>",
   		"<param_name>": "<param_value> 
   	} 
   }

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

   fonctionnalité

   Nom de la fonctionnalité. Pour en savoir plus, reportez-vous à Paramètres de contexte de fonctionnalité pris en charge 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.

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"		
   				} 
   		  } 
   }

8. Remplacez la fonction SN_CSM_EC.loadEMFeature() par une fonction wrapper 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()
   }); 
   

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 de lanceur.
    3. Vérifiez que Engagement Messenger lance la fonctionnalité que vous avez configurée dans le code intégré.

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. 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

chatFeatureContext() : la fonction de couche pour le contexte de messagerie instantanée.

fonctionnalité

CHAT : la fonctionnalité de messagerie instantanée permettant de lancer la messagerie instantanée Agent virtuel ou Agent actif.

openOnLoad

false : désactivez le lancement automatique de Engagement Messenger.

topic_id

8708db281bd5b81080df6247b04bcb79  : l'identificateur du système de module (sys_id).

langue

fr : définit la langue de messagerie instantanée par défaut sur Français.