Como verificar usuários logados no widget de chat

Assine no seu servidor a identidade dos usuários logados e passe o token ao widget do Sell Whisper AI para que o agente saiba com quem está falando. A partir do Starter.

Passos

Siga esta ordem

  1. Gere o segredo de identidade

    Abra o agente, vá em Configurações (Settings), depois em Segurança (Security), e clique em Gerar segredo (Generate secret) no card Verificação de identidade (Identity verification). Mantenha o segredo somente no seu servidor. A verificação de identidade está disponível a partir do Starter.

    Configurações de segurança do agente
  2. Assine o usuário no seu servidor

    Quando um usuário estiver logado, crie um JSON Web Token assinado com o segredo usando HS256. Inclua user_id (ou sub) e uma expiração. Adicione o e-mail e o nome do usuário, se você os tiver; qualquer outra claim é salva como atributo no perfil do usuário.

  3. Chame identify na página

    Depois que o widget carregar, chame SellWhisperWidget.identify com o token. Chame-o com null quando o usuário sair da conta, para que a próxima pessoa nesse navegador comece como anônima.

  4. Confira uma conversa verificada

    Abra uma conversa desse usuário em Registros de conversas (Chat logs). Ela traz um selo Verificado (Verified) com o ID e os atributos do usuário, e o usuário tem uma entrada em Perfis (Profiles).

Por que verificar

Sem verificação, o widget só sabe o que o visitante digita. Qualquer pessoa pode digitar o endereço de e-mail de outra. Um token assinado no seu servidor prova que o seu próprio site autenticou essa pessoa, então o agente pode tratar o ID e os atributos do usuário como fatos.

O que vai no token

ClaimObrigatóriaSignificado
user_id ou subSimO seu ID estável para o usuário
expSimMomento de expiração; mantenha-o curto e emita um novo token a cada carregamento de página
email, nameNãoExibidos com a conversa
Qualquer outra claimNãoSalva como atributo no perfil do usuário, por exemplo o nome de um plano

Assine-o com HS256 e com o segredo das configurações de Segurança (Security) do agente. Se você não puder emitir um JSON Web Token, passe um user_id com um user_hash, um HMAC do ID do usuário gerado com o mesmo segredo.

Regras a seguir

  • O segredo fica no seu servidor. Nunca o coloque no código do seu site, em um app mobile ou em um repositório público. Se ele vazar, faça a rotação dele no mesmo card.
  • Assine por usuário, por sessão. Crie o token quando a página for renderizada para um usuário logado.
  • Limpe-o no logout. Chame identify(null) para que um computador compartilhado não leve a identidade adiante.

O que você ganha

  • Um selo Verificado (Verified) na conversa em Registros de conversas (Chat logs).
  • Um perfil por usuário em Perfis (Profiles), com os atributos que você enviou.
  • Atributos que você pode inserir em ações personalizadas, para que uma chamada à sua API leve o ID do usuário verificado.

Um usuário verificado não é um login na loja: as ações do Shopify e do WooCommerce continuam dependendo da loja para confirmar o cliente.

Os exemplos em Node.js e Python para assinar o token e os trechos de código para a página estão em Verificação de identidade.

Perguntas frequentes

Dúvidas comuns

Um usuário verificado conta como login na loja?
Não. As ações do Shopify, do WooCommerce e outras protegidas por login continuam pedindo à loja que verifique o cliente. A verificação de identidade informa ao agente quem o seu próprio site diz que o usuário é.
O que acontece com um token forjado ou expirado?
Ele é ignorado e a conversa continua como anônima. Nenhum erro é mostrado ao seu cliente.
Posso usar os dados do usuário em ações?
Sim. Os atributos do perfil podem ser inseridos na requisição de uma ação personalizada; assim, uma chamada à sua API pode levar o ID ou o plano do usuário verificado.

Documentação relacionada

Comece agora

Coloque os passos em prática

Comece grátis, sem cartão de crédito.