Installazione del widget

Shayan TaslimAggiornato

Per installare il widget basta uno snippet. Incollalo vicino alla fine della pagina HTML, subito prima del tag di chiusura </body>:

HTML
<script>
  window.uj ||= new Proxy(
    {},
    {
      get: (_, p) =>
        p == 'then'
          ? 0
          : (...a) => {
              (window.$ujq ||= []).push([p, ...a]);
            }
    }
  );
  uj.init('YOUR_PROJECT_ID');
</script>
<script type="module" async src="https://cdn.userjot.com/sdk/v3/uj.js"></script>

Trova YOUR_PROJECT_ID in Impostazioni → Accesso alla voce Segreti (oppure copia lo snippet precompilato dalla pagina Condividi nella dashboard). Una volta caricato, il launcher appare nell’angolo in basso a destra della pagina.

Lo snippet inline configura un proxy window.uj che accoda le chiamate fire-and-forget (init, open, close, toggle, identify, logout, setTheme, setLocale, destroy) finché l’SDK non termina il caricamento, per poi riprodurle.

L'ordine delle chiamate non è importante

Puoi accodare init, identify e open nello stesso tick, prima che l’SDK termini il caricamento:

HTML
<script>
  window.uj ||= new Proxy(
    {},
    {
      get: (_, p) =>
        p == 'then'
          ? 0
          : (...a) => {
              (window.$ujq ||= []).push([p, ...a]);
            }
    }
  );
  uj.init('YOUR_PROJECT_ID');
  uj.identify({ user: { id: 'user-123', email: 'user@example.com' } });
</script>
<script type="module" async src="https://cdn.userjot.com/sdk/v3/uj.js"></script>
Note

Il proxy pre-caricamento restituisce undefined per ogni chiamata. Se ti servono valori di ritorno o promise, come await uj.identify(...), uj.createEmbed(...), uj.on(...) o uj.getState(), attendi il caricamento dello script dell’SDK prima di chiamarli.

Nessuno script inline (CSP rigorosa)

Se il tuo sito blocca gli script inline, usa l’installazione con un solo tag e data-project per inizializzare automaticamente l’SDK:

HTML
<script
  type="module"
  async
  src="https://cdn.userjot.com/sdk/v3/uj.js"
  data-project="YOUR_PROJECT_ID"
></script>

Puoi comunque chiamare i metodi window.uj dal tuo bundle una volta caricato lo script. Se il tuo codice chiama anche uj.init(...), la chiamata esplicita ha la precedenza su data-project.

Direttive Content Security Policy (CSP)

Se la tua app applica una Content Security Policy, autorizza queste origini di UserJot:

  • script-src: https://cdn.userjot.com

  • connect-src: https://widget.userjot.com wss://widget.userjot.com https://collect.jotlens.com (l’SDK invia beacon leggeri di telemetria del widget a collect.jotlens.com sugli host non locali)

  • img-src: https://media.userjot.com (e https://cdn.userjot.com per le risorse caricate)

  • style-src e font-src: https://cdn.userjot.com (i font sono ospitati autonomamente; non è necessario autorizzare Google Fonts)

  • frame-src: https://<your-workspace>.userjot.com (o il tuo dominio personalizzato) se usi incorporamenti inline

React, Next.js e app a pagina singola

  • Carica https://cdn.userjot.com/sdk/v3/uj.js una volta nel layout radice (ad esempio con <Script strategy="afterInteractive" /> in Next.js o in index.html). Non inserire tag script duplicati quando cambia la route.

  • Chiama uj.init('YOUR_PROJECT_ID', ...) una volta all’avvio dell’app e chiama uj.identify(...) / uj.logout() quando cambia lo stato di autenticazione.

  • Pulisci tutte le sottoscrizioni uj.on(...) e gli handle embed.destroy() nella funzione di pulizia del componente (il valore restituito da useEffect).

Configurazione

Passa le opzioni come secondo argomento a init:

JavaScript
uj.init('YOUR_PROJECT_ID', {
  widget: {
    position: 'right', // 'left' or 'right'
    theme: 'auto', // 'auto', 'light', or 'dark'
    launcher: true // false hides the default button
  },
  locale: 'en-US' // optional override
});

Tutte le opzioni sono facoltative. Imposta launcher: false per aprire il widget da un tuo pulsante invece che dal launcher predefinito. Per alcuni esempi, consulta Controllare il widget.

Verificare l'installazione

Dopo aver caricato la pagina:

  1. Il pulsante del launcher appare nell’angolo configurato.

  2. Facendo clic, si apre il widget.

  3. Puoi esplorare Home e Feedback (inclusa la Roadmap, se abilitata) all’interno del widget, oltre a Aggiornamenti quando è abilitato il changelog pubblico.

Se il Centro assistenza è attivo o Conversazioni è abilitato, le schede Assistenza e Messaggi appaiono automaticamente, senza bisogno di modificare gli script.

Problemi comuni

Il widget non compare

  • Verifica che siano presenti entrambi i tag script (oppure il tag singolo con data-project).

  • Verifica che YOUR_PROJECT_ID corrisponda a Impostazioni → Accesso → Segreti.

  • Controlla di non aver passato widget: false o launcher: false in init.

  • Controlla nella console del browser se ci sono errori di Content Security Policy che bloccano cdn.userjot.com o widget.userjot.com.

Le chiamate sembrano non fare nulla

Se uj.open() o uj.identify(...) non fa nulla, verifica che uj.init(...) sia stato eseguito nella pagina. Le chiamate accodate prima di init attendono l’esecuzione di init; se restano chiamate in coda senza init, l’SDK registra un avviso nella console.

Passaggio successivo

Collega il widget agli utenti che hanno effettuato l’accesso in Identificare gli utenti.

Ha risposto alla tua domanda?