# 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**.

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

| Campo | Obligatorio | Formato |
|---|---|---|
| `sub` | sí | El id de la persona en tu sistema, hasta 128 caracteres. |
| `name` | no | Hasta 120 caracteres. |
| `email` | no | Correo. |
| `phone` | no | De 8 a 15 dígitos, con el `+` del país opcional. |
| `exp` | no | Vencimiento, 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.
