Verificação de identidade: o portal do seu cliente assina e o chat confirma o contato

Faça o chat da Klyro saber que o visitante logado no seu portal é mesmo quem ele diz ser.

Se a sua empresa tem uma loja ou um portal com login, o seu servidor pode assinar um código para o visitante logado. O chat da Klyro confere a assinatura e marca o contato como verificado. O atendente vê um selo verde ao lado do e-mail. Sem código válido, o chat continua funcionando como antes, com um visitante anônimo ou que informou o e-mail.

Não é preciso instalar pacote da Klyro: basta assinar com a biblioteca padrão da sua linguagem.

Passo 1: ligar o recurso

  1. Entre como administrador em Configurações da empresa.
  2. Abra a aba Verificação de identidade.
  3. Ligue Aceitar tokens de identidade assinados. A Klyro gera o primeiro segredo.
  4. Copie o ID da empresa, mostrado na aba. Ele vai no campo c do código.

Passo 2: guardar o segredo no servidor

Use Revelar segredo para ver o segredo e guarde-o numa variável de ambiente do seu servidor. Nunca o coloque no navegador, em aplicativo de celular ou em repositório.

Se achar que o segredo vazou, use Rotacionar segredo e depois Revogar segredo anterior agora. Até desativar, o segredo antigo ainda vale por até 24 horas.

Passo 3: assinar o código no servidor

O código tem o formato v2.<conteúdo>.<assinatura> e vale no máximo 5 minutos. O conteúdo leva:

  • c: ID da empresa.
  • w: ID do widget, que fica no código de instalação do widget.
  • e: e-mail do visitante, em minúsculas e sem espaços nas pontas.
  • n: um número aleatório novo a cada código. Cada um só pode ser usado uma vez.
  • iat e exp: início e fim da validade, em segundos.

A aba Verificação de identidade traz um Exemplo pronto em Node.js, PHP e Python, com o ID da empresa já preenchido e um botão para copiar. Troque YOUR_WIDGET_ID pelo ID do seu widget.

Aba Verificação de identidade em Configurações da empresa: interruptor Aceitar tokens de identidade assinados, ID da empresa e o cartão Exemplo pronto com o código em Node.js.

Passo 4: entregar o código ao chat

No navegador, depois do código de instalação do widget:

KlyroChat.identify(() => fetch("/api/klyro-token").then((r) => r.text()));

A função é chamada de novo quando o chat precisa de um código novo, então uma página aberta por horas não fica sem código válido.

O que o atendente vê

  • Selo verde ao lado do e-mail: o contato foi verificado pelo seu portal.
  • Selo laranja: o e-mail foi apenas informado ou vinculado, sem verificação.

Cabeçalho do chat com o selo verde ao lado do e-mail do contato verificado.

Cabeçalho do chat com o selo laranja e o aviso E-mail não verificado abaixo do e-mail do contato.

Se não funcionar

O chat só responde que o código é inválido; o motivo não aparece para o visitante. Confira:

  1. O e-mail está em minúsculas e sem espaços nas pontas.
  2. O relógio do servidor está certo.
  3. c e w são os IDs corretos.
  4. Cada código tem um número aleatório novo.
  5. O recurso está ligado na aba Verificação de identidade.