---
sourceDocument: Xanadu: Customer Service Management
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/xanadu/customer-service-management

 Release :

    - xanadu

ft:locale :

    - de-DE

ft:publication_title :

    - Xanadu: Customer Service Management

ft:clusterId :

    - csm

bundleId :

    - csm

workflow :

    - Customer and Industry


---

# Funktionen in Engagement Messenger mit benutzerdefiniertem Code starten

# Funktionen in Engagement Messenger mit benutzerdefiniertem Code starten {#ariaid-title1}

* Freigeben Version: Xanadu
* 
* Aktualisiert 1. August 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 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](https://servicenow-prod.fluidtopics.net/syIFLYZPWyFrVyDP0LLpTA "Erstellen Sie ein Engagement Messenger-Modul, und konfigurieren Sie sein Verhalten, seine Darstellung und seinen Stil. Durch die Erstellung eines Messenger-Moduls können Sie das Erscheinungsbild und das Verhalten entsprechend Ihrem Branding in der Organisation und an Ihre Kundenbedürfnisse anpassen.").

[Engagement Messenger in Webanwendung einbetten](https://servicenow-prod.fluidtopics.net/tNEbbb~sB93959K8LtyyQw "Betten Sie den Quellcode des von Ihnen konfigurierten Messenger-Moduls in Ihre Website ein, damit Sie Ihren Kunden die Verwendung von Engagement Messenger auf Ihrer Website ermöglichen können.").

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 MessengerModule.
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: "<var class="keyword varname">&lt;feature_name&gt;</var>", 
       	openOnLoad: <var class="keyword varname">&lt;true/false&gt;</var>, 
       	params: { 
       		"<var class="keyword varname">&lt;param_name&gt;</var>": "<var class="keyword varname">&lt;param_value&gt;</var>",
       		"<var class="keyword varname">&lt;param_name&gt;</var>": "<var class="keyword varname">&lt;param_value&gt;</var> 
       	} 
       }

   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](https://servicenow-prod.fluidtopics.net/1kw8~8tWeAiANUS5OHgs8g "Mit Funktionen für die kontextbezogene Startfunktionalität können Sie den Standardstartbildschirm in Engagement Messenger festlegen.") .

   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](https://servicenow-prod.fluidtopics.net/1kw8~8tWeAiANUS5OHgs8g "Mit Funktionen für die kontextbezogene Startfunktionalität können Sie den Standardstartbildschirm in Engagement Messenger festlegen.").
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"		
       				} 
       		  } 
       }

   {#contextual-launch-using-script-engagement-messenger__wrapper-creation}
{#contextual-launch-using-script-engagement-messenger__wrapper-creation}
8. Ersetzen Sie die Funktion `SN_CSM_EC.loadEMFeature()` durch die benutzerdefinierte Wrapper-Funktion, die Sie in [Schritt 7](https://servicenow-prod.fluidtopics.net/rQZPhWJyEG71aemoRKJK_A "Verwenden Sie benutzerdefinierten Code, um Deep-Links zu aktivieren und eine in Ihre Website integrierte Funktion in Engagement Messenger zu starten.") 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: <var class="keyword varname">chatFeatureContext</var>()
       }); 

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.
    {#contextual-launch-using-script-engagement-messenger__substeps_gjt_cts_4qb}

## 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
:   <var class="keyword varname">chatFeatureContext()</var>: Die Wrapper-Funktion für den Chat-Kontext.

feature
:   <var class="keyword varname">CHAT</var>: Die Chat-Funktion zum Initiieren eines Virtual Agent- oder Service Desk-Mitarbeiter-Chats.

openOnLoad
:   <var class="keyword varname">false</var>: Deaktiviert den automatischen Start von Engagement Messenger.

topic_id
:   <var class="keyword varname">8708db281bd5b81080df6247b04bcb79</var>: Der Modulsystembezeichner (sys_id).

language
:   <var class="keyword varname">fr</var>: Legt die Standardsprache für den Chat auf Französisch fest.