Einbetten Engagement MessengerIn Ihrer Webanwendung

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 3 Minuten Lesedauer
  • Betten Sie den Quellcode des Messenger-Moduls ein, das Sie in Ihrer Website konfiguriert haben, damit Sie Ihren Kunden die Verwendung ermöglichen können Engagement MessengerAuf Ihrer Website.

    Vorbereitungen

    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 Ihr konfiguriertes Messenger-Modul ausgewählt haben, möglicherweise Code für Funktionen schreiben, um das ID-Token abzurufen und die Sitzung für einen angemeldeten Anwender im Messenger zu starten und zu stoppen.

    Prozedur

    1. Navigieren zu Alle > Engagement Messenger > Modulean.
    2. Klicken Sie in der Spalte Modul bearbeiten des Messenger-Moduls, das Sie auf Ihrer Website installieren möchten, auf Bearbeiten .
      Die geführte Konfigurationsansicht wird angezeigt.
    3. Klicken Sie auf Implementieren Registerkarte.
    4. Wenn Sie Änderungen am Abschnitt „Sicherheitseinstellungen“ vorgenommen haben, klicken Sie auf Speichern .
      Der Code von Engagement MessengerModul wird aktualisiert.
    5. Scrollen Sie nach unten zum Abschnitt „Code einbetten“, und klicken Sie auf 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. Schließen Sie für ein Messenger-Modul mit OIDC- oder SAML-basierter Authentifizierung die folgende Konfiguration ab.
      AuthentifizierungstypAktion
      OIDC-basiert
      1. Schreiben Sie Code für GetTokenCallBack() Funktion.
      2. Rufen Sie an SN_CSM_EC.ONLOGIN() Funktion, wenn sich Anwender bei Ihrer Website anmelden.

        Mit dieser Funktion können sich authentifizierte Anwender bei anmelden Engagement MessengerNahtlos, wenn sie sich bei Ihrer Website anmelden.

      3. Rufen Sie an SN_CSM_EC.ONLOGOUT() Funktion, wenn sich Anwender von Ihrer Website abmelden.

        Mit dieser Funktion können sich authentifizierte Anwender nahtlos von abmelden Engagement MessengerUnd Ihre Website.

      SAML-basiert
      1. Rufen Sie an SN_CSM_EC.ONLOGIN() Funktion, wenn sich Anwender bei Ihrer Website anmelden.

        Mit dieser Funktion können sich authentifizierte Anwender bei anmelden Engagement MessengerNahtlos, wenn sie sich bei Ihrer Website anmelden.

      2. Rufen Sie an SN_CSM_EC.ONLOGOUT() Funktion, wenn sich Anwender von Ihrer Website abmelden.

        Mit dieser Funktion können sich authentifizierte Anwender nahtlos von abmelden Engagement MessengerUnd Ihre Website.

    8. Wenn Sie die Walk-up-Funktion für nicht authentifizierte Anwender aktiviert haben, heben Sie den Kommentar auf //guestWalkupBaseUrlCodezeile und schließen Sie die Konfiguration ab, indem Sie die Basis-URL Ihres Kundensupportportals eingeben.

      Beispiel: Wenn Ihr Kundensupportportal lautet https://www.example.com/support , Aktualisieren Sie dann den Code auf Guest WalkupBaseUrl = https://www.example.com/support

      Abbildung : 1. Kopieren Sie den InteraktionsMessenger-Code
      Konfigurieren Sie das Modul „Interaktions-Messenger“ mithilfe der hervorgehobenen Schritte. Verwenden Sie für die Implementierung den Einbettungscode, um nicht authentifizierte Anwenderprobleme zu beheben.
    9. Wahlweise: Zum Ändern des Einbettungscodes, um die bevorzugte Sprache festzulegen, in der Engagement MessengerWird angezeigt. Führen Sie einen der folgenden Schritte aus.
      OptionBeschreibung
      sprache: {ISO-locale-Code} Ermöglicht das Laden Engagement MessengerMit einer festen Sprache.
      SetLang : GetEMLanguage Ermöglicht Ihnen das dynamische Wechseln der Sprache in welcher Engagement MessengerWird angezeigt. Die GetEMLanguage Wert kann jeden ISO-Gebietsschemacode zurückgeben, der für die Messenger-Sprache verwendet werden kann.
      Die SetLang : GetEMLanguage Die Funktion hat eine Einstellung, wenn beide Parameter verfügbar sind. Wenn der Anwender jedoch die bevorzugte Sprache in der Tabelle [sys_user_preferences] festgelegt hat, Engagement MessengerWird in dieser Sprache angezeigt.
      Hinweis:
      Beginnend mit YokohamaRelease können die aktualisierten Kunden auch den Einbettungscode ändern, um den Sprachwechsel zu ermöglichen.
    10. Wahlweise: Öffnen Sie die Website, der Sie hinzugefügt haben Engagement MessengerCode, um zu überprüfen, ob das Startprogramm-Symbol verfügbar ist, und klicken Sie auf das Symbol, um sicherzustellen, dass es gestartet wird Engagement Messenger.
    11. Wahlweise: Ändern Sie den Einbettungscode von Engagement MessengerDient zur Integration proaktiver Empfehlungen auf einer Webseite.
      Für weitere Informationen zur Verwendung Engagement MessengerInformationen zum Integrieren proaktiver Empfehlungen auf einer Webseite finden Sie unter Verwenden Engagement MessengerBetten Sie Code ein, um proaktive Empfehlungen auf einer Webseite zu integrieren.

    Nächste Maßnahme

    Öffnen Sie die Website, die Sie hinzugefügt haben Engagement MessengerCodieren Sie, und überprüfen Sie, ob das Startprogramm-Symbol des Messenger verfügbar ist. Klicken Sie auf das Symbol, um zu starten Engagement Messenger.