Hoe installeer je de Notiondesk Messenger op je website?

Messenger brengt uw helpcentrum rechtstreeks naar uw website of webapplicatie.

Bezoekers kunnen Messenger gebruiken om in uw helpcentrum te zoeken, artikelen te lezen, te chatten met uw AI-assistent, wijzigingen te bekijken en contact op te nemen met uw team, allemaal zonder uw website te verlaten.

Deze handleiding legt uit hoe je Messenger installeert op een standaardwebsite.

Voordat je begint

Voordat je Messenger installeert, zorg ervoor dat je het volgende hebt:

• Een Notiondesk helpcentrum

• Een Messenger geconfigureerd in Notiondesk

• Toegang tot de code van uw website of tot de instellingen voor aangepaste code die voor de hele website gelden.

• Uw unieke installatiecode voor Messenger Notiondesk

Als je wilt dat bezoekers de AI-assistent in Messenger gebruiken, configureer dan ook de AI-chatbot Notiondesk. Zie De AI-chatbot instellen en inschakelen .

Kies een installatiemethode

Gebruik de installatiemethode die het beste bij uw website past.

Voor de meeste traditionele websites is het JavaScript-fragment de eenvoudigste installatiemethode.

Installeer Messenger op een standaardwebsite.

1. Kopieer je Messenger-installatiecode

Open je Messenger-instellingen in Notiondesk en zoek het gedeelte Installatie .

Kopieer het installatiefragment dat voor uw Messenger is gegenereerd.

De code heeft dit formaat:

YOUR_MESSENGER_ID geeft aan welke Messenger op uw website geladen moet worden.

Kopieer het fragment van je eigen Notiondesk dashboard in plaats van een Messenger ID van een andere website of account te kopiëren.

2. Voeg het codefragment toe aan uw website.

Plak het Messenger-fragment direct vóór de afsluitende </body>-tag:

Als uw website gebruikmaakt van een gedeelde lay-out, sjabloon, voettekst of een gedeelte met aangepaste code dat voor de hele website geldt, voeg het codefragment daar dan eenmalig toe, zodat Messenger op de hele website wordt geladen.

Als Messenger alleen op specifieke pagina's moet verschijnen, voeg het fragment dan alleen op die pagina's toe.

3. Publiceer je wijzigingen

Sla het codefragment op en publiceer of implementeer uw website nadat u het hebt toegevoegd.

De Messenger-code moet aanwezig zijn op de gepubliceerde website. Het toevoegen van de code aan een lokale of niet-gepubliceerde versie zorgt ervoor dat Messenger niet beschikbaar is voor bezoekers.

<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>

Controleer de installatie.

Open de gepubliceerde website in uw browser.

Een succesvolle installatie zou de Messenger-launcher Notiondesk moeten laden op pagina's die de installatiecode bevatten.

Open Messenger en controleer of de verwachte inhoud Notiondesk verschijnt.

Je kunt het testen:

• Messenger openen en sluiten

• Zoeken in uw helpcentrum

• Een artikel openen

• Een AI-gesprek starten als de AI-chatbot is ingeschakeld.

• Het openen van andere Messenger-secties die u hebt ingeschakeld

Als Messenger niet verschijnt, open dan de ontwikkelaarstools van je browser en controleer of de widget correct wordt geladen.

React, Next.js, Vue, Nuxt en SPA's

React, Next.js, Vue, Nuxt en andere single-page applicaties zouden het officiële @notiondesk-so/messenger-js-sdk pakket moeten gebruiken in plaats van handmatig het standaard scriptfragment toe te voegen.

Installeer het pakket met:

Je kunt het ook installeren met Yarn of pnpm.

De SDK biedt specifieke integraties voor:

npm install @notiondesk-so/messenger-js-sdk

• JavaScript en TypeScript

• Reageren

• Next.js

• Vue

• Nuxt

De SDK biedt ook methoden voor het weergeven, verbergen, in- en uitschakelen, configureren en verwijderen van Messenger.

Frameworkintegraties moeten Messenger aan de clientzijde initialiseren. Initialiseer de Messenger SDK niet tijdens server-side rendering.

Installeer niet zowel het standaard Messenger-codefragment als de SDK in dezelfde applicatie, tenzij u bewust aparte Messenger-instanties beheert.

Voor een complete installatie van het framework, zie de handleiding Notiondesk Messenger installeren met React en Next.js.

Probleemoplossing