Instalación del widget
Para instalar el widget, solo necesitas un fragmento de código. Pégalo cerca del final de tu página HTML, justo antes de la etiqueta de cierre </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>Busca YOUR_PROJECT_ID en Configuración → Inicio de sesión, dentro de Claves secretas (o copia el fragmento de código rellenado previamente desde la página Compartir de tu panel). Una vez cargado, el botón de acceso aparece en la esquina inferior derecha de la página.
El fragmento insertado configura un proxy window.uj que pone en cola las llamadas de tipo fire-and-forget (init, open, close, toggle, identify, logout, setTheme, setLocale, destroy) hasta que termina de cargarse el SDK y luego las reproduce.
El orden de las llamadas no importa
Puedes poner en cola init, identify y open en el mismo ciclo antes de que termine de cargarse el SDK:
<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>El proxy previo a la carga devuelve undefined en cada llamada. Si necesitas valores de retorno o promesas, como await uj.identify(...), uj.createEmbed(...), uj.on(...) o uj.getState(), espera a que se cargue el script del SDK antes de llamarlos.
Sin scripts insertados en línea (CSP estricta)
Si tu sitio bloquea los scripts insertados directamente en la página, usa la instalación con una sola etiqueta y data-project para que el SDK se inicialice por sí solo:
<script
type="module"
async
src="https://cdn.userjot.com/sdk/v3/uj.js"
data-project="YOUR_PROJECT_ID"
></script>Aun así, puedes llamar a los métodos de window.uj desde tu propio paquete una vez cargado el script. Si tu código también llama a uj.init(...), esa llamada explícita tiene prioridad sobre data-project.
Directivas de la Política de seguridad de contenido (CSP)
Si tu aplicación aplica una Política de seguridad de contenido, permite estos orígenes de UserJot:
script-src:https://cdn.userjot.comconnect-src:https://widget.userjot.com wss://widget.userjot.com https://collect.jotlens.com(el SDK envía señales ligeras de telemetría del widget acollect.jotlens.comen hosts que no son locales)img-src:https://media.userjot.com(yhttps://cdn.userjot.compara los recursos subidos)style-srcyfont-src:https://cdn.userjot.com(las fuentes se alojan en el propio sitio; no es necesario permitir Google Fonts)frame-src:https://<your-workspace>.userjot.com(o tu dominio personalizado) si usas inserciones integradas
React, Next.js y aplicaciones de una sola página
Carga
https://cdn.userjot.com/sdk/v3/uj.jsuna sola vez en el diseño raíz (por ejemplo, con<Script strategy="afterInteractive" />en Next.js o enindex.html). No insertes etiquetas de script duplicadas al cambiar de ruta.Llama a
uj.init('YOUR_PROJECT_ID', ...)una sola vez al iniciar la aplicación y llama auj.identify(...)/uj.logout()cuando cambie el estado de autenticación.Limpia todas las suscripciones de
uj.on(...)y los manejadores deembed.destroy()en la función de limpieza de tu componente (el retorno deuseEffect).
Configuración
Pasa las opciones como segundo argumento 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
});Todas las opciones son opcionales. Configura launcher: false para abrir el widget desde tu propio botón en lugar de usar el botón de acceso predeterminado. Consulta Controlar el widget para ver ejemplos.
Verifica la instalación
Después de cargar la página:
El botón de acceso aparece en la esquina configurada.
Al hacer clic en él, se abre el widget.
Puedes explorar Inicio y Comentarios (incluida la Hoja de ruta cuando esté habilitada) dentro del widget, además de Actualizaciones cuando esté habilitado tu registro público de cambios.
Si el Centro de ayuda está activo o las Conversaciones están habilitadas, las pestañas Ayuda y Mensajes aparecen automáticamente, sin necesidad de cambiar el script.
Problemas habituales
El widget no aparece
Confirma que estén presentes las dos etiquetas de script (o la etiqueta única con
data-project).Verifica que
YOUR_PROJECT_IDcoincida con Configuración → Inicio de sesión → Claves secretas.Comprueba que no hayas pasado
widget: falsenilauncher: falseainit.Comprueba si hay errores de la Política de seguridad de contenido en la consola del navegador que bloqueen
cdn.userjot.comowidget.userjot.com.
Las llamadas parecen no hacer nada
Si uj.open() o uj.identify(...) no hacen nada, confirma que uj.init(...) se haya ejecutado en la página. Las llamadas puestas en cola antes de init esperan hasta que se ejecute init, y el SDK muestra una advertencia en la consola si quedan llamadas en cola sin init.
Siguiente paso
Conecta el widget con los usuarios que hayan iniciado sesión en Identificar usuarios.