Skip to content
Ver .md

Identificar usuarios conectados ​

¿Tu sitio tiene un área con inicio de sesión? Su servidor puede decirle al píxel quién está conectado. En En vivo, en lugar de "Visitante #a3f2", aparece el nombre de la persona, con insignia de verificado.

Cada identificación va firmada con la clave de identificación del negocio, así nadie puede hacerse pasar por un cliente tuyo.

La clave de identificación ​

Está en Configuración del negocio → Píxel → Identificar usuarios conectados. Ver la clave requiere el permiso Gestionar claves de API.

Guarda la clave solo en el servidor

Trata la clave como una contraseña. Nunca la pongas en el HTML ni en el JavaScript del sitio: quien tenga la clave puede aparecer en En vivo como cualquier cliente tuyo.

Cómo funciona ​

En cada página con sesión iniciada, después del código del píxel, el servidor:

  1. Arma un JWT con el algoritmo HS256, firmado con la clave de identificación.
  2. Escribe en la página una llamada ls("identify", "<jwt>").

Sirve cualquier biblioteca de JWT con HS256.

Campos aceptados ​

CampoObligatorioFormato
subsíEl id de la persona en tu sistema, hasta 128 caracteres.
namenoHasta 120 caracteres.
emailnoCorreo.
phonenoDe 8 a 15 dígitos, con el + del país opcional.
expnoVencimiento, en segundos Unix.

Cualquier otro campo se ignora.

Ejemplo en PHP, sin biblioteca ​

php
$b64 = fn($data) => rtrim(strtr(base64_encode($data), '+/', '-_'), '=');
$header = $b64(json_encode(['alg' => 'HS256', 'typ' => 'JWT']));
$payload = $b64(json_encode([
    'sub' => (string)$usuario['id'],
    'name' => $usuario['nombre'],
    'email' => $usuario['email'],
    'phone' => $usuario['telefono'],
    'exp' => time() + 86400,
]));
$jwt = "$header.$payload." . $b64(hash_hmac('sha256', "$header.$payload", LEADSTALKER_IDENTITY_SECRET, true));

echo '<script>ls("identify", "' . $jwt . '");</script>';

LEADSTALKER_IDENTITY_SECRET es una constante de tu servidor con la clave de identificación.

Reglas ​

  • Firma en el servidor, donde está la clave.
  • Un campo aceptado con formato incorrecto se descarta, pero la identificación vale con los demás.
  • Un paquete cuya firma no coincide, o vencido (exp), no identifica: la persona aparece solo como lead conocido.
  • Llámalo en cada página con sesión iniciada. Quien no inició sesión no necesita identificación: sigue como visitante.
  • El correo y el teléfono solo aparecen en En vivo para quien tiene el permiso Ver datos de contacto en el negocio.