Central de Ajuda | tawk.to | Como usar setAttributes() com um hash em JavaScript

Como usar setAttributes() com um hash em JavaScript

As instruções abaixo são apenas para desktops e laptops.

Você pode usar a função setAttributes() em nossa API para modificar os detalhes dos clientes, como nome e endereço de e-mail, através da sua ferramenta do chat tawk.to.

Usar um hash com a função setAttributes() é uma ótima maneira de proteger os dados dos clientes. Um hash é um recurso de segurança poderoso que consiste em uma combinação criptografada da sua Chave e do ID do usuário.

Neste guia, mostramos como obter sua Chave, gerar um hash e usá-lo com a função setAttributes() em nossa API.

Primeiro, obtenha a Chave

Siga estas etapas para obter sua Chave:

1. Faça login na sua conta tawk.to.

2. No seu Painel de controle, selecione a propriedade para a qual você precisa da Chave. Passe o mouse sobre o nome da propriedade para garantir que selecionou a correta.

3. Clique no ícone de configurações (⚙️) no menu superior para acessar o painel de Administração.

4. No menu de Administração, selecione Visão geral.

5. Role para baixo até JavaScript API.

6. Habilite Modo de segurança.

7. Clique no ícone a seguir para Copiar a Chave:

Você precisará desta Chave na próxima seção, onde geraremos o hash.

Gerar o hash

O hash é gerado por um serviço que aceita uma combinação da sua Chave e do ID do usuário e os criptografa em uma sequência de caracteres que partes não autorizadas não podem ler.

Você pode usar qualquer serviço de criptografia de sua escolha para gerar o hash. Neste exemplo, mostramos como fazer isso usando o Crypto.js. As bibliotecas relevantes estão disponíveis em:

https://cryptojs.gitbook.io/docs

https://www.npmjs.com/package/crypto-js

Siga estas etapas para gerar o hash:

1. Copie o código a seguir na seção do HTML do seu site:

2. Copie a função a seguir no seu arquivo JavaScript. Esta função lida com a geração do valor do hash.

3. Substitua secretKey pela Chave copiada do seu Painel de controle tawk.to.

var hash = CryptoJS.HmacSHA256(userID, secretKey);

Em seguida, vamos usar o hash com a função setAttributes().

Usando setAttributes() com hash

Siga estas etapas para usar setAttributes() com hash:

1. Copie a função setAttributes() da nossa API JavaScript para o seu esquema de API.

OBSERVAÇÃO: Se você estiver usando a propriedade de telefone com setAttributes(), certifique-se de que o número de telefone siga o formato internacional E.164 (por exemplo, +1234567890).

2. Copie o hash que você gerou para o campo hash.

3. Certifique-se de que o valor no campo userID corresponda ao ID do usuário usado nas etapas de criptografia acima.

OBSERVAÇÃO: Pode levar alguns segundos para que os dados dos seus clientes sejam atualizados.

Códigos de erro

Estes são os possíveis códigos de erro que você pode encontrar:

Código de erro	Descrição
400	Bad Request Error Isso indica um erro nos atributos da sua função. Verifique seu código e envie a solicitação novamente.
401	Unauthorized Error Isso indica que O ID do usuário não corresponde ao valor de hash criptografado, ou Modo de segurança não está habilitado no seu painel de controle tawk.to. Verifique seu código e envie a solicitação novamente.
500	Internal Server Error Isso indica que nossos servidores estão ocupados no momento. Tente reenviar a solicitação.

Estes códigos de erro aparecerão no console de desenvolvedor do seu navegador web.

Com estas etapas, você reforçou ainda mais a segurança da sua ferramenta do chat tawk.to, proporcionando aos seus clientes uma experiência mais segura e robusta.

Se você encontrar qualquer dificuldade ou tiver mais perguntas, entre em contato conosco.

Se você tiver sugestões sobre este artigo ou precisar de mais ajuda:

Clique no ícone verde de chat ao vivo
Agende uma chamada conosco
Visite nossa comunidade

Este artigo foi útil?

3 de 6 gostaram deste artigo