--- 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 --- # Engagement Messenger in Webanwendung einbetten # Engagement Messenger in Webanwendung einbetten {#ariaid-title1} * Freigeben Version: Xanadu * * Aktualisiert 1. August 2024 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 3 Minuten Lesedauer 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. ## Vorbereitungen * [Engagement Messenger-Module aktivieren](https://servicenow-prod.fluidtopics.net/RJRN9su4HaD96lqBiOv3fw "Aktivieren Sie das Engagement Messenger-Modul, das Sie so konfiguriert haben, sodass Sie es in Ihre Website einbetten können."). * Erforderliche Rolle: sn_csm_ec.ec_admin {#embed-engagement-messenger-code-in-your-web-application__ul_kvl_4pf_g4b} ## Warum und wann dieser Vorgang ausgeführt wird Kopieren Sie den Quellcode des von Ihnen aktivierten Messenger-Moduls und fügen Sie ihn in die HTML-Datei der Website ein, auf der Sie den Messenger bereitstellen möchten. Als Nächstes müssen Sie je nach Authentifizierungstyp, den Sie für das konfigurierte Messenger-Modul ausgewählt haben, Code für Funktionen schreiben, um das ID-Token abzurufen und die Sitzung für einen im Messenger angemeldeten Benutzer zu starten bzw. zu beenden. ## Prozedur 1. Navigieren zu AlleEngagement MessengerModule. 2. Klicken Sie in der Spalte „Modul bearbeiten" des Messenger-Moduls, das Sie auf Ihrer Website installieren möchten, auf Bearbeiten. Die Ansicht der Konfiguration mit Anleitung wird angezeigt. 3. Klicken Sie auf die Registerkarte Implementieren. 4. Wenn Sie Änderungen am Abschnitt „Sicherheitseinstellungen" vorgenommen haben, klicken Sie auf Speichern. Der Code des Engagement Messenger-Moduls wird aktualisiert. 5. Scrollen Sie nach unten zum Abschnitt „Embed code" (Code einbetten), und klicken Sie auf Copy code (Code kopieren). 6. Öffnen Sie die HTML-Datei Ihrer Website, und fügen Sie den kopierten Code vor dem schließenden Text-Tag ein. 7. Nehmen Sie für ein Messenger-Modul mit OIDC-basierter oder SAML-basierter Authentifizierung die folgende Konfiguration vor. | Authentifizierungstyp | Aktion | | OIDC-basiert | 1. Schreiben Sie Code für die Funktion getTokenCallBack(). 2. Rufen Sie die Funktion SN_CSM_EC.onLogin() immer dann auf, wenn sich Benutzer bei Ihrer Website anmelden. Diese Funktion ermöglicht authentifizierten Benutzern die nahtlose Anmeldung bei Engagement Messenger, wenn sie sich bei Ihrer Website anmelden. 3. Rufen Sie die Funktion SN_CSM_EC.onLogout() immer dann auf, wenn sich Benutzer bei Ihrer Website abmelden. Diese Funktion ermöglicht authentifizierten Benutzern die nahtlose Abmeldung von Engagement Messenger und von Ihrer Website. {#embed-engagement-messenger-code-in-your-web-application__ol_dns_wtl_p4b} | | SAML-basiert | 1. Rufen Sie die Funktion SN_CSM_EC.onLogin() immer dann auf, wenn sich Benutzer bei Ihrer Website anmelden. Diese Funktion ermöglicht authentifizierten Benutzern die nahtlose Anmeldung bei Engagement Messenger, wenn sie sich bei Ihrer Website anmelden. 2. Rufen Sie die Funktion SN_CSM_EC.onLogout() immer dann auf, wenn sich Benutzer bei Ihrer Website abmelden. Diese Funktion ermöglicht authentifizierten Benutzern die nahtlose Abmeldung von Engagement Messenger und von Ihrer Website. {#embed-engagement-messenger-code-in-your-web-application__ol_cmk_25l_p4b} | |-|-| {#embed-engagement-messenger-code-in-your-web-application__choicetable_vhq_vtl_p4b} 8. Wenn Sie die Walk-up-Funktion für nicht authentifizierte Benutzer aktiviert haben, entfernen Sie den Kommentar zur //guestWalkupBaseUrl-Codezeile, und schließen Sie die Konfiguration ab, indem Sie die Basis-URL Ihres Kundensupportportals eingeben. Wenn Ihr Kundensupport-Portal beispielsweise https://www.example.com/support ist, aktualisieren Sie den Code zu guestWalkupBaseUrl = https://www.example.com/support. Abbildung : 1. Engagement Messenger-Code kopieren 9. **Wahlweise:** Führen Sie einen der folgenden Schritte aus, um den eingebetteten Code zu ändern und so die bevorzugte Sprache festzulegen, in der Engagement Messenger angezeigt wird. | Optionen | Beschreibung | | `lang: {ISO-Gebietsschemacode}` | Ermöglicht das Laden von Engagement Messenger mit einer festen Sprache. | | `setLang : getEMLanguage` | Ermöglicht das dynamische Wechseln der Sprache, in der Engagement Messenger angezeigt wird. Der Wert `getEMLanguage` kann einen beliebigen ISO-Gebietsschemacode zurückgeben, der für die Messenger-Sprache verwendet werden kann. | |-|-| {#embed-engagement-messenger-code-in-your-web-application__choicetable_gmq_3zs_f5b} Wenn beide Parameter verfügbar sind, hat die Funktion `setLang : getEMLanguage` Vorrang. Wenn der Benutzer jedoch die bevorzugte Sprache in der Tabelle \[sys_user_preference\] festgelegt hat, wird Engagement Messenger in dieser Sprache angezeigt. Hinweis: Ab dem Xanadu-Release können Upgrade-Kunden auch den eingebetteten Code ändern, um einen Wechsel der Sprache zu ermöglichen. 10. **Wahlweise:** Öffnen Sie die Website, der Sie den Engagement Messenger-Code hinzugefügt haben. Vergewissern Sie sich, dass das Startsymbol verfügbar ist, und klicken Sie es an, um sicherzugehen, dass dadurch Engagement Messenger gestartet wird. 11. **Wahlweise:** Ändern Sie den eingebetteten Code von Engagement Messenger, um proaktive Empfehlungen auf einer Webseite zu integrieren. Weitere Informationen zur Verwendung von Engagement Messenger zur Integration proaktiver Empfehlungen auf einer Webseite finden Sie unter [Verwenden Sie den Code zum Einbetten von Engagement Messenger, um proaktive Empfehlungen auf einer Webseite zu integrieren](https://servicenow-prod.fluidtopics.net/SdW8mW6leLQVruypDuVT_Q "Ändern Sie den Einbettungscode von Engagement Messenger, um Empfehlungen zu aktivieren und die Suchabfrage für Empfehlungen basierend auf KI-Suchezu übergeben."). ## Nächste Maßnahme Öffnen Sie die Website, der Sie den Engagement Messenger-Code hinzugefügt haben, und stellen Sie sicher, dass das Startsymbol des Messengers verfügbar ist. Klicken Sie auf das Symbol, um den Engagement Messenger zu starten. Sie können Engagement Messenger auch mit dem Now Mobile SDK in Ihre nativen iOS- und Android-Anwendungen einbetten: * [Engagement Messenger mit Now Mobile SDK \[KB1587276\] in eine native iOS-App einbetten](https://support.servicenow.com/kb_view.do?sysparm_article=KB1587276) * [Engagement Messenger mit Now Mobile SDK \[KB1587611\] in eine native Android-App einbetten](https://support.servicenow.com/kb_view.do?sysparm_article=KB1587611) {#embed-engagement-messenger-code-in-your-web-application__ul_w2c_2vq_21c}