[Guia para desenvolvedores] Como autenticar o Huggy Chat

Calebe Ribeiro

Atualizado em

A autenticação do Huggy Chat (Widget) é um recurso destinado a sistemas que gerenciam o acesso de seus clientes.

Isso é comum em lojas virtuais, áreas de membros, sistemas SaaS e portais de clientes em geral.

Ao implementar a autenticação, o Huggy Chat pode proporcionar uma experiência superior, garantindo:

• Persistência: O chat mantém seu contexto mesmo que o cliente feche ou limpe os dados do navegador.
• Segurança: É possível carregar o histórico e os dados do cliente sabendo que eles pertencem àquele usuário.
• Experiência melhorada: Não há necessidade de solicitar repetidamente dados pessoais dos clientes.
• Continuidade em diferentes dispositivos: O usuário pode trocar de dispositivo (celular para desktop, por exemplo) e retomar a conversa exatamente do ponto em que parou.

Para quem é destinada a autenticação

Os recursos apresentados neste artigo são disponibilizados pela Huggy para que seu próprio time de desenvolvimento possa gerar um token criptografado e por meio dele validar as credenciais dos seus clientes no chat.

Vídeo prático

Confira o vídeo para ver os recursos disponíveis sendo aplicados na prática.

A estrutura do token de autenticação

O token de autenticação é um JWT (JSON Web Token) assinado usando o algoritmo HMAC-SHA256.

Para que o processo funcione, você precisará de dois componentes principais:

1. userIdentifier, o ID único do seu cliente, como um e-mail ou CPF.
2. Chave secreta do seu Huggy Chat, fornecida pela Huggy.

Autenticação pelo Backend

A implementação final em produção deve ser feita no seu Backend (servidor). A chave secreta jamais deve ser exposta no código do lado do cliente.

Como aplicar o token no Frontend

Após o seu Backend gerar o userHash com sucesso, o Frontend tem duas maneiras de inicializar o Huggy Chat com o usuário autenticado:

1. Variável global huggyData

É o método mais comum, ideal para injetar os dados antes do script de inicialização do widget.

window.huggyData = {
    userIdentifier: 'seu@email.com', // Dado único do cliente, gerenciado por você
    userHash: 'eyJ0eXAiOiJKV1QiLC...' // O token JWT gerado pelo Backend
java};

2. Método Huggy.login()

Útil para autenticar o usuário dinamicamente, após o widget já ter sido carregado (por exemplo, após um login sem recarregar a página).

Huggy.login({
        userIdentifier: 'seu@email.com',
        userHash: 'eyJ0eXAiOiJKV1QiLC...' 
});

Documentação completa

Clique aqui para acessar a documentação que detalha todos os recursos da API do Huggy chat incluindo a autenticação.

Esse artigo tirou suas dúvidas?

Artigos Relacionados

• [Guia para desenvolvedores] Como configurar o Widget da Huggy
• [Guia para desenvolvedores] Como alterar o layout do botão do Widget
• [Guia para desenvolvedores] Personalize o comportamento do Widget