Funktionen in Engagement Messenger mit benutzerdefiniertem Code starten

Verwenden Sie den anwenderdefinierten Code, um die Deep-Verknüpfung zu aktivieren und eine Funktion in zu starten Engagement Messenger In Ihre Website integriert.

Vorbereitungen

Engagement Messenger konfigurieren.

Einbetten Engagement Messenger In Ihrer Webanwendung.

Erforderliche Rolle: ec_admin und Website-Administrator

Warum und wann dieser Vorgang ausgeführt wird

Hinweis:

Wenn Sie vorhandenen Code verwenden, stellen Sie sicher, dass Sie das Skript aktualisieren, um es anzuzeigen v=3,1 . Zum Beispiel:

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

Prozedur

1. Navigieren zu Engagement Messenger > Modulean.
2. Öffnen Sie im Modul „Interaktions-Messenger konfigurieren“ die Registerkarte „Implementieren“.
3. Kopieren Sie den Code aus dem Abschnitt „Code einbetten“.
4. Öffnen Sie in einem Texteditor die HTML-Datei der Webseite auf Ihrer Website, auf der Sie integrieren Engagement Messenger.
5. Fügen Sie den Code ein, den Sie vor dem Tag für den schließenden Text kopiert haben.
6. Definieren Sie den Funktionskontext, und geben Sie die Variablen für die Funktion an.
   Verwenden Sie das folgende Format, um einen Funktionskontext zu definieren:

   { 
   	feature: "<feature_name>", 
   	openOnLoad: <true/false>, 
   	params: { 
   		"<param_name>": "<param_value>",
   		"<param_name>": "<param_value> 
   	} 
   }

   Geben Sie im Format die Funktionsvariablen an.

   Funktion

   Der Funktionsname. Weitere Informationen finden Sie unter Funktionskontextparameter werden in unterstützt Engagement Messenger .

   OpenOnLoad

   Schließen Sie diese Option ein, und legen Sie sie nur auf „wahr“ fest, wenn Sie möchten Engagement Messenger Zum automatischen Öffnen. Die Standardeinstellung für diese Option ist für Engagement Messenger Nicht automatisch öffnen.

   <param_name>“: „<param_value>

   Name und Wert eines Parameters, der der Funktion zugeordnet ist. Weitere Informationen finden Sie unter Funktionskontextparameter werden in unterstützt Engagement Messenger.

7. Erstellen Sie eine anwenderdefinierte Wrapper-Funktion, um den Funktionskontext an zu übergeben SN_CSM_EC.init Funktion des Einbettungscodes.
   Der folgende Code verwendet beispielsweise ChatFeatureContext() Anwenderdefinierte Wrapper-Funktion für den Kontext der Chat-Funktion.

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

8. Ersetzen Sie SN_CSM_EC.LOADEMFEATURE() Funktion mit einer anwenderdefinierten Wrapper-Funktion, die Sie in erstellt haben Schritt 7 .
   Beispiel: Im folgenden Code ChatFeatureContext() Wrapper-Funktion wird als Wert von übergeben LoadFeature Attribut.

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

9. Speichern Sie die Datei.
10. Wahlweise: Stellen Sie sicher, dass die angegebene Funktion gestartet wird.
    1. Öffnen Sie die Website, in die Sie eingebettet haben Engagement Messenger.
    2. Wählen Sie das Startprogramm-Symbol aus.
    3. Überprüfen Sie das Engagement Messenger Startet die Funktion, die Sie im Einbettungscode konfiguriert haben.

Ergebnisse

Die Funktion, die Sie im Einbettungscode angegeben haben, wird standardmäßig gestartet, wenn Engagement Messenger Wird auf der Website geöffnet, in die es eingebettet ist.

Beispiel

Der folgende Code initiiert standardmäßig die Chat-Funktion. Zeigt auch, wie ausgelöst wird Virtual Agent Thema standardmäßig, wenn der Chat durch Übergabe des Systembezeichners (sys_ID) des Themas geladen wird. Sie können auch eine Sprache angeben, um den Chat in dieser Sprache zu initiieren.

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

Funktion

ChatFeatureContext() : Die Wrapper-Funktion für den Chat-Kontext.

Funktion

CHAT : Die Chat-Funktion zum Initiieren Virtual Agent Oder Servicemitarbeiter Chat.

OpenOnLoad

Falsch : Automatischen Start von deaktivieren Engagement Messenger.

Thema_ID

8708db281bd5b81080df6247b04bcb79 : Der Modulsystembezeichner (sys_ID).

language

fr : Legt die standardmäßige Chatsprache auf Französisch fest.