# Identificar usuários logados

Seu site tem área logada? O servidor dele pode dizer ao pixel quem está logado. No **Ao Vivo**, no lugar de "Visitante #a3f2", aparece o nome da pessoa, com selo de verificado.

Cada identificação vai assinada com a **chave de identificação** do negócio, então ninguém consegue se passar por um cliente seu.

## A chave de identificação

Fica em **Configurações do negócio → Pixel → Identificar usuários logados**. Ver a chave exige a permissão **Gerenciar chaves de API**.

::: danger Guarde a chave só no servidor
Trate a chave como uma senha. Nunca coloque no HTML ou no JavaScript do site: quem tiver a chave consegue aparecer no Ao Vivo como qualquer cliente seu.
:::

## Como funciona

Em toda página logada, depois do código do pixel, o servidor:

1. Monta um JWT com o algoritmo **HS256**, assinado com a chave de identificação.
2. Escreve na página uma chamada `ls("identify", "<jwt>")`.

Qualquer biblioteca de JWT com HS256 serve.

## Campos aceitos

| Campo | Obrigatório | Formato |
|---|---|---|
| `sub` | sim | O id da pessoa no seu sistema, até 128 caracteres. |
| `name` | não | Até 120 caracteres. |
| `email` | não | E-mail. |
| `phone` | não | De 8 a 15 dígitos, com o `+` do país opcional. |
| `exp` | não | Validade, em segundos Unix. |

Qualquer outro campo é ignorado.

## Exemplo em PHP, sem 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['nome'],
    'email' => $usuario['email'],
    'phone' => $usuario['telefone'],
    '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` é uma constante do seu servidor com a chave de identificação.

## Regras

- Assine no servidor, onde fica a chave.
- Campo aceito com formato errado é descartado, mas a identificação vale com os outros.
- Pacote com assinatura que não bate, ou vencido (`exp`), não identifica: a pessoa aparece só como lead conhecido.
- Chame em toda página logada. Quem não está logado não precisa de identificação: continua como visitante.
- E-mail e telefone só aparecem no Ao Vivo para quem tem a permissão **Ver dados de contato** no negócio.
