Jak zainstalować komunikator Notiondesk na swojej stronie internetowej

Zainstaluj Notiondesk Messenger na swojej stronie internetowej za pomocą fragmentu kodu JavaScript lub zestawu SDK. Dowiedz się, gdzie dodać kod, zweryfikuj konfigurację i rozwiąż typowe problemy z instalacją.

4 min czytania

Notiondesk Messenger przenosi centrum pomocy Notiondesk bezpośrednio do Twojej witryny lub aplikacji internetowej.

Użytkownicy mogą używać Messengera do przeszukiwania centrum pomocy, czytania artykułów, czatowania z asystentem AI, przeglądania aktualizacji rejestru zmian i kontaktowania się z zespołem bez opuszczania Twojej witryny.

W tym przewodniku wyjaśniono, jak zainstalować program Notiondesk Messenger na standardowej stronie internetowej.

Zanim zaczniesz

Przed zainstalowaniem programu Notiondesk Messenger upewnij się, że posiadasz:

  • Centrum pomocy Notiondesk
  • Komunikator skonfigurowany w Notiondesk
  • Dostęp do kodu Twojej witryny lub ustawień kodu niestandardowego dla całej witryny
  • Twój unikalny fragment kodu instalacyjnego Notiondesk Messenger
Jeśli chcesz, aby odwiedzający korzystali z asystenta AI w Messengerze, skonfiguruj również chatbota AI Notiondesk. Zobacz Konfigurowanie i włączanie chatbota AI .

Wybierz metodę instalacji

Użyj metody instalacji odpowiadającej Twojej witrynie.

Typ witryny Zalecana metoda
Standardowa witryna HTML lub wielostronicowa Fragment kodu JavaScript
Zareagować Notiondesk Zestaw SDK Messenger
Następny.js Notiondesk Zestaw SDK Messenger
Widok Notiondesk Zestaw SDK Messenger
Nuxt Notiondesk Zestaw SDK Messenger
Inna aplikacja jednostronicowa Notiondesk Zestaw SDK Messenger

W przypadku większości tradycyjnych witryn internetowych fragment kodu JavaScript jest najprostszą metodą instalacji.

Zainstaluj Messengera na standardowej stronie internetowej

1. Skopiuj kod instalacyjny Messengera

Otwórz ustawienia Messengera w Notiondesk i znajdź sekcję Instalacja .

Skopiuj fragment kodu instalacyjnego wygenerowany dla Messengera.

Kod ma następujący format:

YOUR_MESSENGER_ID identyfikuje program Messenger, który powinien zostać załadowany na Twojej stronie internetowej.

Skopiuj fragment kodu z własnego pulpitu Notiondesk zamiast kopiować identyfikator Messengera z innej witryny lub konta.

2. Dodaj fragment kodu do swojej witryny

Wklej fragment kodu komunikatora Messenger tuż przed zamykającym znacznikiem </body>:

Jeśli Twoja witryna korzysta ze współdzielonego układu, szablonu, stopki lub sekcji kodu niestandardowego dla całej witryny, dodaj tam fragment kodu, aby Messenger ładował się w całej witrynie.

Jeśli komunikator Messenger ma pojawiać się tylko na określonych stronach, dołącz fragment kodu tylko na tych stronach.

3. Opublikuj swoje zmiany

Po dodaniu fragmentu kodu zapisz i wdróż lub opublikuj swoją witrynę.

Kod Messengera musi znajdować się na opublikowanej stronie internetowej. Dodanie kodu tylko do wersji lokalnej lub nieopublikowanej nie spowoduje udostępnienia Messengera odwiedzającym.

<script
  async
  src="https://static.notiondesk.help/messenger/widget.js"
  data-messenger-id="YOUR_MESSENGER_ID">
</script>
<body>
  <!-- Your website -->

  <script
    async
    src="https://static.notiondesk.help/messenger/widget.js"
    data-messenger-id="YOUR_MESSENGER_ID">
  </script>
</body>

Zweryfikuj instalację

Otwórz opublikowaną stronę internetową w przeglądarce.

Pomyślna instalacja powinna spowodować załadowanie programu uruchamiającego Notiondesk Messenger na stronach zawierających kod instalacyjny.

Otwórz program Messenger i sprawdź, czy wyświetla się oczekiwana zawartość Notiondesk.

Możesz przetestować:

  • Otwieranie i zamykanie Messengera
  • Przeszukiwanie centrum pomocy
  • Otwieranie artykułu
  • Rozpoczęcie rozmowy z wykorzystaniem AI, jeśli włączony jest AI Chatbot
  • Otwieranie innych sekcji Messengera, które włączyłeś

Jeśli Messenger się nie pojawia, otwórz narzędzia programistyczne w przeglądarce i sprawdź, czy widget ładuje się prawidłowo.

React, Next.js, Vue, Nuxt i aplikacje SPA

React, Next.js, Vue, Nuxt i inne aplikacje jednostronicowe powinny używać oficjalnego pakietu @notiondesk-so/messenger-js-sdk zamiast ręcznie dodawać standardowy fragment skryptu.

Zainstaluj pakiet za pomocą:

Można go również zainstalować za pomocą Yarn lub pnpm.

Zestaw SDK zapewnia dedykowane integracje dla:

npm install @notiondesk-so/messenger-js-sdk
  • JavaScript i TypeScript
  • Zareagować
  • Następny.js
  • Widok
  • Nuxt

Zestaw SDK udostępnia również metody wyświetlania, ukrywania, przełączania, konfigurowania i usuwania programu Messenger.

Integracje frameworka muszą inicjalizować Notiondesk Messenger po stronie klienta. Nie inicjalizuj pakietu Messenger SDK podczas renderowania po stronie serwera.

Nie instaluj standardowego fragmentu kodu Messenger i zestawu SDK w tej samej aplikacji, chyba że celowo zarządzasz osobnymi instancjami Messenger.

Aby zapoznać się z pełną konfiguracją infrastruktury, zapoznaj się z przewodnikiem Instalacja Notiondesk Messenger za pomocą React i Next.js.

Rozwiązywanie problemów


Komunikator się nie pojawia

Sprawdź następujące elementy:

  1. Potwierdź, że fragment kodu Messengera znajduje się na stronie
  1. Potwierdź, że fragment zawiera prawidłowy data-messenger-id
  1. Potwierdź, że najnowsze zmiany na Twojej stronie internetowej zostały opublikowane
  1. Odśwież stronę po wdrożeniu
  1. Sprawdź konsolę przeglądarki pod kątem błędów JavaScript lub zasad bezpieczeństwa treści
  1. Sprawdź panel Sieć i upewnij się, że widget.js nie jest blokowany

Messenger pojawia się na niektórych stronach, ale nie na innych

Notiondesk Messenger ładuje się tylko na stronach zawierających kod instalacyjny.

Jeśli Messenger ma pojawiać się na każdej stronie, przenieś fragment kodu do globalnego układu, szablonu lub stopki witryny.

Pojawia się zły Messenger

data-messenger-id określa, który komunikator Notiondesk jest załadowany.

Skopiuj ponownie fragment instalacyjny z prawidłowego komunikatora Messenger w panelu Notiondesk.

Komunikator jest blokowany przez Politykę bezpieczeństwa treści

Restrykcyjna polityka bezpieczeństwa treści może uniemożliwić ładowanie skryptów JavaScript lub żądań sieciowych innych firm. Jeśli skrypt Messengera jest obecny, ale się nie ładuje, sprawdź konsolę przeglądarki pod kątem błędów CSP.

Polityka bezpieczeństwa treści Twojej witryny musi dopuszczać zasoby wymagane przez Notiondesk Messenger.

Messenger działa po odświeżeniu, ale nie podczas nawigacji SPA

Aplikacje jednostronicowe nie wykonują pełnego przeładowania strony podczas normalnej nawigacji.

Użyj @notiondesk-so/messenger-js-sdk w przypadku aplikacji React, Next.js, Vue, Nuxt i innych aplikacji opartych na SPA zamiast polegać na standardowym fragmencie kodu instalacyjnego.

Zidentyfikowany użytkownik nie jest rozpoznawany

Sprawdź, czy Twój system zaplecza generuje prawidłowy i nieprzeterminowany token użytkownika Notiondesk.

Nie generuj tokena w kodzie przeglądarki.

Gdy użytkownik się wyloguje, usuń token użytkownika z konfiguracji Messenger lub zniszcz instancję Messenger przed rozpoczęciem kolejnej sesji użytkownika.

Komunikator jest ukryty za innym elementem

Pakiet Messenger SDK obsługuje niestandardową konfigurację zIndex.

Zwiększ wartość układania Messengera, jeśli nad programem uruchamiającym lub panelem Messenger wyświetlany jest inny stały lub ruchomy element.

Powiązane artykuły

Czy ta strona była pomocna?