Installazione del widget
Per installare il widget basta uno snippet. Incollalo vicino alla fine della pagina HTML, subito prima del tag di chiusura </body>:
<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:
<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>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:
<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.comconnect-src:https://widget.userjot.com wss://widget.userjot.com https://collect.jotlens.com(l’SDK invia beacon leggeri di telemetria del widget acollect.jotlens.comsugli host non locali)img-src:https://media.userjot.com(ehttps://cdn.userjot.comper le risorse caricate)style-srcefont-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.jsuna volta nel layout radice (ad esempio con<Script strategy="afterInteractive" />in Next.js o inindex.html). Non inserire tag script duplicati quando cambia la route.Chiama
uj.init('YOUR_PROJECT_ID', ...)una volta all’avvio dell’app e chiamauj.identify(...)/uj.logout()quando cambia lo stato di autenticazione.Pulisci tutte le sottoscrizioni
uj.on(...)e gli handleembed.destroy()nella funzione di pulizia del componente (il valore restituito dauseEffect).
Configurazione
Passa le opzioni come secondo argomento a init:
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:
Il pulsante del launcher appare nell’angolo configurato.
Facendo clic, si apre il widget.
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_IDcorrisponda a Impostazioni → Accesso → Segreti.Controlla di non aver passato
widget: falseolauncher: falseininit.Controlla nella console del browser se ci sono errori di Content Security Policy che bloccano
cdn.userjot.comowidget.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.