Verifique quem são os seus visitantes
Diga ao chat quem é um visitante com sessão iniciada com Chatixy.identify() e assine o email dele no seu servidor, para que a sua equipa veja uma identidade verificada na conversa.
Como funciona a verificação de identidade
Quando um visitante tem sessão iniciada no seu site, a sua página pode dizer ao chat quem ele é com Chatixy.identify(). O email, o nome e o telefone aparecem então na conversa na sua caixa de entrada, e o chat deixa de lhe pedir o email.
Sem assinatura, identify() funciona como o formulário pré-chat: os dados só preenchem campos vazios e a conversa fica marcada como não verificada. Adicione uma assinatura feita no seu servidor, o user_hash, e o Chatixy marca a identidade como verificada: os dados substituem o que o visitante escreveu e o cartão de contacto na sua caixa de entrada mostra a etiqueta Verificado. O seu agente de suporte só é informado de que a identidade foi verificada quando o foi.
Dicas
- Aplicam-se as regras de campos do formulário pré-chat: um telefone só é guardado quando o seu chat o pede, e um nome a menos que o campo do nome do seu chat esteja desligado.
Encontre o seu segredo de identidade
Cada chat tem o seu próprio Segredo de identidade. Só os administradores do seu espaço de trabalho o podem ver.
Passos
- 1
Abra as definições do chat
No seu projeto, clique em Configurar no site e depois abra Definições avançadas.
- 2
Copie o segredo
Em Segredo de identidade, clique em Mostrar e depois em Copiar.
- 3
Guarde-o no seu servidor
Guarde-o onde só o seu servidor o possa ler, por exemplo na variável de ambiente
CHATIXY_IDENTITY_SECRET.
Importante
- Nunca coloque o segredo de identidade no código da sua página, no seu JavaScript ou num repositório público. Quem o tiver pode fazer qualquer email parecer verificado.
- Gerar novamente cria um segredo novo, e as assinaturas feitas com o antigo deixam de ser verificadas de imediato. Use-o se o segredo puder ter sido divulgado e coloque logo o novo no seu servidor.
Assine o email no seu servidor
A assinatura é um HMAC-SHA256 do email do visitante, feito com o seu segredo de identidade como chave e escrito em hexadecimal minúsculo: 64 caracteres.
Assine exatamente o email que passa a identify(). O Chatixy não altera maiúsculas e minúsculas antes de verificar, por isso Ann@Example.com e ann@example.com dão assinaturas diferentes. Faça a assinatura no seu servidor, ao gerar a página ou ao responder na sua própria API, nunca no navegador.
Node.js
const crypto = require('crypto');
const userHash = crypto
.createHmac('sha256', process.env.CHATIXY_IDENTITY_SECRET)
.update(user.email)
.digest('hex');PHP
$userHash = hash_hmac('sha256', $user->email, getenv('CHATIXY_IDENTITY_SECRET'));Python
import hashlib
import hmac
import os
user_hash = hmac.new(
os.environ['CHATIXY_IDENTITY_SECRET'].encode(),
user.email.encode(),
hashlib.sha256,
).hexdigest()Ruby
require 'openssl'
user_hash = OpenSSL::HMAC.hexdigest('SHA256', ENV.fetch('CHATIXY_IDENTITY_SECRET'), user.email)Passe a identidade ao chat
Chame Chatixy.identify() com o email do visitante e a assinatura como user_hash; name e phone são opcionais. Escreva na página os valores que o seu servidor produziu - o exemplo abaixo mostra marcadores.
Pode chamá-lo assim que a sua página souber quem é o visitante. As chamadas feitas antes de o chat estar pronto esperam e correm quando ele estiver, e uma identidade dada antes da primeira mensagem fica associada à conversa que essa mensagem inicia.
HTML
<script>
window.chatixyAsyncInit = function (Chatixy) {
Chatixy.identify({
email: 'ann@example.com',
name: 'Ann',
user_hash: 'SIGNATURE_FROM_YOUR_SERVER',
});
};
</script>
<script src="https://chatixy.com/source/YOUR_WIDGET_KEY.js" async></script>Se uma assinatura não corresponder
Um user_hash que não corresponde não guarda nada dessa chamada: nem email, nem nome, nem telefone, nem etiqueta Verificado. O chat continua a funcionar normalmente e o visitante não vê nenhum erro.
Uma conversa verificada continua verificada: uma chamada posterior a identify() sem assinatura não a pode desfazer.
Porque é que a etiqueta Verificado não aparece?
Confirme que assina exatamente o email que passa, letra a letra; que usa o segredo deste chat, pois cada chat tem o seu; que a assinatura está escrita em hexadecimal; e que ninguém gerou novamente o segredo depois de o copiar.
Tenho de assinar o email?
Não. identify() sem user_hash continua a passar os dados do visitante para a sua caixa de entrada. Ficam marcados como não verificados e só preenchem campos ainda vazios.