Instalación del widget

Shayan TaslimActualizado

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

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>

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:

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

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:

HTML
<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.com

  • connect-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 a collect.jotlens.com en hosts que no son locales)

  • img-src: https://media.userjot.com (y https://cdn.userjot.com para los recursos subidos)

  • style-src y font-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.js una sola vez en el diseño raíz (por ejemplo, con <Script strategy="afterInteractive" /> en Next.js o en index.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 a uj.identify(...) / uj.logout() cuando cambie el estado de autenticación.

  • Limpia todas las suscripciones de uj.on(...) y los manejadores de embed.destroy() en la función de limpieza de tu componente (el retorno de useEffect).

Configuración

Pasa las opciones como segundo argumento 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
});

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:

  1. El botón de acceso aparece en la esquina configurada.

  2. Al hacer clic en él, se abre el widget.

  3. 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_ID coincida con Configuración → Inicio de sesión → Claves secretas.

  • Comprueba que no hayas pasado widget: false ni launcher: false a init.

  • Comprueba si hay errores de la Política de seguridad de contenido en la consola del navegador que bloqueen cdn.userjot.com o widget.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.

¿Respondió esto a tu pregunta?