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?
| Item | Regra |
|---|---|
| Assinatura | Precisa bater com o segredo ativo do widget. |
| Validade | A diferença entre expiração e emissão é de no máximo 300 segundos (5 minutos). |
| Relógio | Aceita até 60 segundos de diferença entre o seu servidor e a Klyro. |
| Nonce | De 16 a 64 caracteres. Cada nonce vale uma única vez por empresa. |
| Já 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.