Funktionen in Engagement Messenger mit benutzerdefiniertem Code starten

  • Freigeben Version: Xanadu
  • Aktualisiert 1. August 2024
  • 2 Minuten Lesedauer

    • Verwenden Sie benutzerdefinierten 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 bereits vorhandenen Code verwenden, müssen Sie das Skript so aktualisieren, dass es v=3.1 angibt. 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 > Module.
    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 kopierten Code vor dem schließenden Tag des Textes ein.
    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 die Funktion SN_CSM_EC.loadEMFeature() durch die benutzerdefinierte Wrapper-Funktion, die Sie in Schritt 7 erstellt 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()
});
    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. Klicken Sie auf 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 eingebetteten Code angegeben haben, wird standardmäßig gestartet, wenn Engagement Messenger auf der Website geöffnet wird, in der 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 Service Desk-Mitarbeiter-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.