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.

Engagement Messenger in Webanwendung einbetten.

Erforderliche Rolle: ec_admin und Website-Administrator

Warum und wann dieser Vorgang ausgeführt wird

Hinweis:

Wenn Sie vorhandenen Code verwenden, überprüfen Sie, ob 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 in „Engagement Messenger-Modul konfigurieren“ die Registerkarte „Implementieren“.
3. Kopieren Sie den Code aus dem Abschnitt „Eingebetteter Code“.
4. Öffnen Sie die HTML-Datei der Webseite auf der Website, auf der Sie Engagement Messenger integrieren, in einem Texteditor.
5. Fügen Sie den Code ein, den Sie vor dem Tag „Abschlusstext“ kopiert haben.
6. Legen Sie den Kontext der Funktion fest, und geben Sie die Variablen für die Funktion an.
   Geben Sie den Kontext der Funktion im folgenden Format an:

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

   Geben Sie im Format die Variablen der Funktion an.

   feature

   Der Name der Funktion. Weitere Informationen finden Sie unter In Engagement Messenger unterstützte Funktions-Kontextparameter .

   openOnLoad

   Sie sollten diese Option nur dann einbeziehen und als „true“ festlegen, wenn Engagement Messenger automatisch geöffnet werden soll. Die Standardeinstellung für diese Option ist, dass Engagement Messenger nicht automatisch geöffnet wird.

   <param_name>": "<param_value>

   Name und Wert eines der Funktion zugeordneten Parameters. Weitere Informationen finden Sie unter In Engagement Messenger unterstützte Funktions-Kontextparameter.

7. Erstellen Sie eine benutzerdefinierte Wrapper-Funktion, um den Kontext der Funktion an die Funktion SN_CSM_EC.init des eingebetteten Codes zu übergeben.
   Der folgende Code verwendet beispielsweise die benutzerdefinierte Wrapper-Funktion chatFeatureContext() 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: Vergewissern Sie sich, dass die angegebene Funktion startet.
    1. Öffnen Sie die Website, in die Sie Engagement Messenger eingebettet haben.
    2. Wählen Sie das Startprogramm-Symbol aus.
    3. Vergewissern Sie sich, dass Engagement Messenger die Funktion startet, die Sie im eingebetteten Code 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

Standardmäßig wird die Chat-Funktion durch den folgenden Code initiiert. Er zeigt auch, wie beim Laden des Chats standardmäßig durch Übergabe des entsprechenden Systembezeichners (sys_id) ein Virtual Agent-Thema ausgelöst wird. Sie können auch angeben, in welcher Sprache der Chat initiiert werden soll.

<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(): Die Wrapper-Funktion für den Chat-Kontext.

feature

CHAT: Die Chat-Funktion zum Initiieren eines Virtual Agent- oder Servicemitarbeiter-Chats.

openOnLoad

false: Deaktiviert den automatischen Start von Engagement Messenger.

topic_id

8708db281bd5b81080df6247b04bcb79: Der Modulsystembezeichner (sys_id).

language

fr: Legt die Standardsprache für den Chat auf Französisch fest.