Funktionen in Engagement Messenger mit benutzerdefiniertem Code starten

Freigeben Version: Yokohama

Aktualisiert 30. Januar 2025

2 Minuten Lesedauer

Verwenden Sie den anwenderdefinierten Code, um Deep Links zu aktivieren und eine in Ihre Website integrierte Funktion in Engagement Messenger zu starten.

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, stellen Sie sicher, dass Sie das Skript so aktualisieren, dass v=3.1angezeigt wird. 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

Navigieren zu Engagement Messenger > Module.
Öffnen Sie in „Engagement Messenger-Modul konfigurieren“ die Registerkarte „Implementieren“.
Kopieren Sie den Code aus dem Abschnitt „Eingebetteter Code“.
Öffnen Sie die HTML-Datei der Webseite auf der Website, auf der Sie Engagement Messenger integrieren, in einem Texteditor.
Fügen Sie den kopierten Code vor dem schließenden Textkörper-Tag ein.
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.
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"		
				} 
		  } 
}
```
Ersetzen Sie die Funktion SN_CSM_EC.loadEMFeature() durch eine anwenderdefinierte Wrapper-Funktion, die Sie in Schritt 7erstellt haben.
Im folgenden Code wird beispielsweise die Wrapperfunktion chatFeatureContext() als Wert des Attributs loadFeature übergeben.
```
SN_CSM_EC.init({ 
		moduleID: "https://example.service-now.com/#<module_id>", 
		loadFeature: chatFeatureContext()
}); 
```
Speichern Sie die Datei.
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.
3. Vergewissern Sie sich, dass Engagement Messenger die Funktion startet, die Sie im eingebetteten Code konfiguriert haben.

Ergebnisse

Die Funktion, die Sie im Code für die Einbettung angegeben haben, wird standardmäßig gestartet, wenn Engagement Messenger auf der Website geöffnet wird, in die sie 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.