Engagement Messenger in Webanwendung einbetten

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.
• Erforderliche Rolle: sn_csm_ec.ec_admin

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 Alle > Engagement Messenger > Module.
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	Schreiben Sie Code für die Funktion getTokenCallBack(). 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. 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.
   SAML-basiert	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. 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.

   Hinweis:

   Weitere Informationen zum Setup der OIDC- und SAML-basierten Authentifizierung finden Sie im Artikel Setup von automatischer Anmeldung und Abmeldung für Engagement Messenger [KB1560205] in der Knowledge Base Now Support.
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.

   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.

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
• Engagement Messenger mit Now Mobile SDK [KB1587611] in eine native Android-App einbetten