Identificar usuarios
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
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():
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.
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:
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:
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 adjustedLí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 (respetaRetry-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
409o porque un miembro eliminado conforme al RGPD devuelve403/member_erased), la promesa se rechaza conIDENTIFY_FAILEDy 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 ( | 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) | |
Inicio de sesión automático | Portal público e inserciones en línea ( | JWT HS256 verificado por el servidor | Starter y Professional | |
Inicio de sesión único (SSO) | Redirección de inicio de sesión al portal público | JWT HS256 verificado por el servidor | Professional | |
SDK de Swift ( | Aplicaciones para iOS y macOS | Sin firma o con firma HMAC-SHA256 | Starter y Professional (requiere el inicio de sesión automático) |
Siguiente paso
Verifica las identidades de los usuarios desde tu backend con Identidad firmada.