Identificar o visitante logado no widget

Como o seu site envia uma identidade assinada, o que a Klyro valida e o que acontece se der errado.

A identificação por token permite que o widget saiba quem é o visitante que já está logado no seu site. O seu servidor gera um token assinado e o widget o envia para a Klyro. É um recurso para quem tem uma equipe técnica.

Como o token funciona?

  • O token tem o formato v2.<dados>.<assinatura> e é assinado com o segredo do widget (HMAC-SHA256).
  • O token pode ter até 2.048 caracteres.
  • Cada token carrega um e-mail, um horário de emissão, um horário de expiração e um código de uso único (nonce).

O que a Klyro valida?

ItemRegra
AssinaturaPrecisa bater com o segredo ativo do widget.
ValidadeA diferença entre expiração e emissão é de no máximo 300 segundos (5 minutos).
RelógioAceita até 60 segundos de diferença entre o seu servidor e a Klyro.
NonceDe 16 a 64 caracteres. Cada nonce vale uma única vez por empresa.
E-mailJá deve estar em minúsculas e sem espaços nas pontas.

E se o token for inválido?

O chat nunca é bloqueado. O visitante simplesmente continua anônimo, como se não houvesse identificação. Por isso, se os contatos não aparecem identificados, confira o relógio do servidor, o segredo e o formato do e-mail.

Como trocar o segredo?

  • Ao girar o segredo, o anterior continua válido por 24 horas, para você trocar sem derrubar a identificação.
  • Se houve vazamento, use a opção desativar o anterior para invalidá-lo na hora.
  • Gerenciar a identificação exige ser administrador com verificação em duas etapas (MFA) válida.

Resumo: token assinado, de até 5 minutos, com código de uso único. Se falhar, o visitante fica anônimo e o chat funciona normalmente.

Checklist rápido

  • Gere o token no servidor, nunca no navegador.
  • Use um nonce novo a cada token.
  • Sincronize o relógio do servidor.
  • Troque o segredo com calma: o anterior vale por 24 horas.