Skip to content
Ver .md

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:

  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 ​

CampoObrigatórioFormato
subsimO id da pessoa no seu sistema, até 128 caracteres.
namenãoAté 120 caracteres.
emailnãoE-mail.
phonenãoDe 8 a 15 dígitos, com o + do país opcional.
expnãoValidade, 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.