Come installare il Messenger Notiondesk sul tuo sito web

Messenger porta il tuo centro assistenza direttamente nel tuo sito web o applicazione web.

I visitatori possono utilizzare Messenger per cercare nel centro assistenza, leggere articoli, chattare con l'assistente IA, visualizzare gli aggiornamenti del registro delle modifiche e contattare il team senza abbandonare il sito web.

Questa guida spiega come installare Notiondesk Messenger su un sito web standard.

Prima di iniziare

Prima di installare Notiondesk Messenger, assicurati di avere:

• Centro assistenza A Notiondesk

• Un Messenger configurato in Notiondesk

• Accesso al codice del tuo sito web o alle impostazioni del codice personalizzato a livello di sito.

• Il tuo snippet di installazione di Messenger univoco Notiondesk

Se desideri che i visitatori utilizzino l'assistente AI all'interno di Messenger, configura anche il chatbot AI Notiondesk. Consulta la sezione Configurare e abilitare il chatbot AI .

Scegli un metodo di installazione

Utilizza il metodo di installazione più adatto al tuo sito web.

Per la maggior parte dei siti web tradizionali, il frammento di codice JavaScript è il metodo di installazione più semplice.

Installa Messenger su un sito web standard

1. Copia il codice di installazione di Messenger

Apri le impostazioni di Messenger in Notiondesk e trova la sezione Installazione .

Copia il frammento di installazione generato per il tuo Messenger.

Il codice ha questo formato:

YOUR_MESSENGER_ID identifica il Messenger che dovrebbe essere caricato sul tuo sito web.

Copia il frammento dalla tua dashboard Notiondesk invece di copiare un ID Messenger da un altro sito web o account.

2. Aggiungi il frammento al tuo sito web

Incolla il frammento di Messenger immediatamente prima del tag di chiusura </body>:

Se il tuo sito web utilizza un layout, un modello, un piè di pagina o una sezione di codice personalizzato condivisa a livello di sito, aggiungi lo snippet una sola volta in modo che Messenger venga caricato su tutto il sito web.

Se Messenger deve apparire solo su pagine specifiche, includi lo snippet solo su quelle pagine.

3. Pubblica le modifiche

Salva e distribuisci o pubblica il tuo sito web dopo aver aggiunto lo snippet.

Il codice di Messenger deve essere presente sul sito web pubblicato. L'aggiunta del codice solo a una versione locale o non pubblicata non renderà Messenger disponibile ai visitatori.

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

Verificare l'installazione

Apri il sito web pubblicato nel tuo browser.

Un'installazione riuscita dovrebbe caricare il launcher di Messenger Notiondesk sulle pagine contenenti il ​​codice di installazione.

Apri Messenger e verifica che venga visualizzato il contenuto previsto Notiondesk.

È possibile eseguire il test:

• Apertura e chiusura di Messenger

• Ricerca nel centro assistenza

• Apertura di un articolo

• Avvio di una conversazione con l'IA se il chatbot IA è abilitato

• Apertura di qualsiasi altra sezione di Messenger che hai abilitato

Se Messenger non viene visualizzato, apri gli strumenti per sviluppatori del tuo browser e verifica se il widget viene caricato correttamente.

React, Next.js, Vue, Nuxt e SPA

React, Next.js, Vue, Nuxt e altre applicazioni a pagina singola dovrebbero utilizzare il pacchetto ufficiale @notiondesk-so/messenger-js-sdk invece di aggiungere manualmente il frammento di script standard.

Installa il pacchetto con:

È possibile installarlo anche con Yarn o pnpm.

L'SDK fornisce integrazioni dedicate per:

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

• JavaScript e TypeScript

• Reagire

• Next.js

• Vue

• Nuxt

L'SDK fornisce anche metodi per mostrare, nascondere, attivare/disattivare, configurare e chiudere Messenger.

Le integrazioni del framework devono inizializzare Notiondesk Messenger sul lato client. Non inizializzare l'SDK di Messenger durante il rendering lato server.

Non installare sia lo snippet standard di Messenger che l'SDK nella stessa applicazione, a meno che tu non gestisca intenzionalmente istanze separate di Messenger.

Per una configurazione completa del framework, consultare la guida Installare Messenger con React e Next.js.

Risoluzione dei problemi