Identificar usuarios

Shayan TaslimActualizado

De forma predeterminada, el widget trata a los visitantes como anónimos. Llama a uj.identify para vincular los comentarios, votos, opiniones, notificaciones y conversaciones a la cuenta de un cliente.

Identificación básica

JavaScript
uj.identify({
  user: {
    id: 'user-123',
    email: 'ada@example.com',
    firstName: 'Ada',
    lastName: 'Lovelace',
    avatar: 'https://example.com/avatar.jpg'
  }
});

user.id es obligatorio. Usa un ID estable de tu base de datos en lugar de una dirección de correo electrónico o un nombre visible que puedan cambiar. email es opcional, aunque se recomienda encarecidamente para que UserJot pueda reconocer al usuario en distintos tableros, reenvíos de correo electrónico y conversaciones. Pasar un email solo vincula la cuenta con una cuenta existente de UserJot cuya dirección de correo electrónico se haya confirmado.

Cuándo llamar a identify

Llama a uj.identify cuando tu aplicación sepa quién ha iniciado sesión. Si vuelves a llamarlo con exactamente la misma carga útil mientras la sesión siga activa, no se realiza ninguna operación. Cuando la sesión expire o cambie algún campo (incluidos el correo electrónico y los atributos), el SDK enviará una nueva solicitud. Si pasas un usuario distinto, la sesión cambiará inmediatamente.

Cuando el usuario cierre sesión en tu aplicación, llama a uj.logout():

JavaScript
if (user) {
  uj.identify({
    user: {
      id: user.id,
      email: user.email,
      firstName: user.firstName,
      lastName: user.lastName
    }
  });
} else {
  uj.logout();
}

Añadir atributos

Los atributos son valores personalizados asociados al perfil de un miembro y se muestran junto a sus solicitudes y conversaciones en el panel.

JavaScript
uj.identify({
  user: {
    id: 'user-123',
    email: 'ada@example.com',
    traits: {
      plan: 'pro',
      seats: 12,
      trialing: false
    }
  }
});

Los valores de los atributos pueden ser cadenas, números, valores booleanos o null (monthlySpend, cuando se envía, debe ser un número no negativo). Las claves reservadas (como id, email, role o companies) se ignoran y se notifican en result.warnings. Consulta la lista completa en la referencia del SDK.

Añadir empresas

En los productos B2B, puedes asociar una o varias empresas al usuario:

JavaScript
uj.identify({
  user: { id: 'user-123', email: 'ada@example.com' },
  companies: [
    {
      id: 'acme',
      name: 'ACME Inc.',
      domain: 'acme.com',
      logo: 'https://acme.com/logo.png',
      traits: { plan: 'enterprise', arr: 24000 }
    }
  ]
});

id es obligatorio para cada empresa. name, domain, logo (URL HTTPS) y traits son opcionales. Si la opción Require signed tokens está habilitada en Settings → Login, las empresas enviadas fuera de un JWT firmado se ignoran y se muestra una advertencia UNSIGNED_COMPANY_IGNORED.

Qué devuelve identify

Una vez cargado el script del SDK, uj.identify devuelve una promesa:

JavaScript
const result = await uj.identify({
  user: { id: 'user-123', email: 'ada@example.com' }
});

result.viewer;        // the identified user, or null
result.identityTrust; // 'signed' or 'unsigned'
result.warnings;      // fields the server ignored or adjusted

Límites de solicitudes y errores

  • Límite de solicitudes y espera del cliente: Las solicitudes de identificación están limitadas a 30 por minuto y 300 por hora por dirección IP y espacio de trabajo. Si se supera el límite por hora, se activa un bloqueo de 1 hora. Después de recibir HTTP 429, el SDK aplica un período de espera local (respeta Retry-After, con un límite de entre 1 segundo y 1 hora y un valor predeterminado de 60 segundos) para que los bucles de reintento fallen localmente sin saturar la API.

  • Llamadas rechazadas: Si el servidor rechaza una llamada de identificación (por ejemplo, por un token no válido, porque Require signed tokens está activado sin un token, por un conflicto de correo electrónico que devuelve 409 o porque un miembro eliminado conforme al RGPD devuelve 403 / member_erased), la promesa se rechaza con IDENTIFY_FAILED y el visitante sigue siendo anónimo.

Identidad y conversaciones

Cuando Conversaciones está activado:

  • Los usuarios identificados no ven la solicitud de datos del visitante y reciben las respuestas del equipo en el correo electrónico de su cuenta.

  • Los visitantes anónimos tienen conversaciones de invitado asociadas al navegador, con la opción de recopilar datos de contacto según la configuración del widget.

En el widget, los visitantes anónimos pueden enviar comentarios y reaccionar a las novedades, mientras que para votar a favor de los comentarios, publicar comentarios y abrir la campana de notificaciones es necesario llamar a uj.identify. Para editar o eliminar publicaciones y comentarios propios en el widget, se requiere una Identidad firmada.

Si Require signed tokens está activado en Settings → Login, las llamadas identify sin firmar se rechazan con HTTP 403 y el visitante sigue siendo anónimo. Usa Signed identity para verificar las cuentas en el servidor.

¿Qué método de autenticación debería usar?

Método

Dónde funciona

Seguridad

Plan

Guía

Sin firma (uj.identify)

Widget integrado en la aplicación

Proporcionado por el navegador (se puede falsificar)

Todos los planes

Este artículo

Identidad firmada (JWT HS256)

Widget integrado en la aplicación (y enlaces al portal público cuando el inicio de sesión automático está activado)

JWT verificado por el servidor

Starter y Professional (para el modo estricto)

Identidad firmada

Inicio de sesión automático

Portal público e inserciones en línea (?token=...)

JWT HS256 verificado por el servidor

Starter y Professional

Inicio de sesión automático

Inicio de sesión único (SSO)

Redirección de inicio de sesión al portal público

JWT HS256 verificado por el servidor

Professional

Inicio de sesión único

SDK de Swift (identify)

Aplicaciones para iOS y macOS

Sin firma o con firma HMAC-SHA256

Starter y Professional (requiere el inicio de sesión automático)

Autenticación del SDK de Swift

Siguiente paso

Verifica las identidades de los usuarios desde tu backend con Identidad firmada.

¿Respondió esto a tu pregunta?