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.
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:
- Monta um JWT com o algoritmo HS256, assinado com a chave de identificação.
- 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
$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.