Verifica chi sono i tuoi visitatori
Comunica al chat chi è un visitatore che ha effettuato l'accesso con Chatixy.identify() e firma la sua email sul tuo server, così il tuo team vede un'identità verificata nella conversazione.
Come funziona la verifica dell'identità
Quando un visitatore ha effettuato l'accesso al tuo sito, la tua pagina può dire al chat chi è con Chatixy.identify(). Email, nome e telefono compaiono allora nella conversazione nella tua casella, e il chat smette di chiedergli l'email.
Senza firma, identify() funziona come il modulo pre-chat: i dati riempiono solo i campi vuoti e la conversazione è segnata come non verificata. Aggiungi una firma creata sul tuo server, lo user_hash, e Chatixy segna l'identità come verificata: i dati sostituiscono ciò che il visitatore ha scritto e la scheda contatto nella tua casella mostra l'etichetta Verificato. Al tuo agente di supporto viene detto che l'identità è verificata solo quando lo è davvero.
Suggerimenti
- Valgono le regole dei campi del modulo pre-chat: un numero di telefono viene salvato solo se il tuo chat lo chiede, e un nome a meno che il campo nome del tuo chat sia disattivato.
Trova il tuo segreto di identità
Ogni chat ha il proprio Segreto di identità. Solo gli amministratori del tuo spazio di lavoro possono vederlo.
Passaggi
- 1
Apri le impostazioni del chat
Nel tuo progetto, fai clic su Configura sul sito, poi apri Impostazioni avanzate.
- 2
Copia il segreto
In Segreto di identità, fai clic su Mostra, poi su Copia.
- 3
Conservalo sul server
Salvalo dove solo il tuo server può leggerlo, ad esempio nella variabile d'ambiente
CHATIXY_IDENTITY_SECRET.
Importante
- Non mettere mai il segreto di identità nel codice della pagina, nel tuo JavaScript o in un repository pubblico. Chi lo possiede può far sembrare verificata qualsiasi email.
- Rigenera crea un nuovo segreto e le firme fatte con il vecchio smettono subito di essere verificate. Usalo se il segreto potrebbe essere trapelato e metti subito il nuovo sul tuo server.
Firma l'email sul tuo server
La firma è un HMAC-SHA256 dell'email del visitatore, creato con il tuo segreto di identità come chiave e scritto in esadecimale minuscolo: 64 caratteri.
Firma esattamente l'email che passi a identify(). Chatixy non cambia maiuscole e minuscole prima del controllo, quindi Ann@Example.com e ann@example.com danno firme diverse. Crea la firma sul tuo server, quando generi la pagina o rispondi con la tua API, mai nel browser.
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)Passa l'identità al chat
Chiama Chatixy.identify() con l'email del visitatore e la firma come user_hash; name e phone sono facoltativi. Scrivi nella pagina i valori prodotti dal tuo server - l'esempio qui sotto mostra dei segnaposto.
Puoi chiamarlo appena la tua pagina sa chi è il visitatore. Le chiamate fatte prima che il chat sia pronto attendono e vengono eseguite quando lo è, e un'identità fornita prima del primo messaggio viene associata alla conversazione che quel messaggio avvia.
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 una firma non corrisponde
Uno user_hash che non corrisponde non salva nulla di quella chiamata: niente email, nome, telefono né etichetta Verificato. Il chat continua a funzionare normalmente e il visitatore non vede alcun errore.
Una conversazione verificata resta verificata: una chiamata successiva a identify() senza firma non può annullarla.
Perché l'etichetta Verificato non compare?
Controlla di firmare esattamente l'email che passi, lettera per lettera; di usare il segreto di questo chat, perché ogni chat ha il suo; che la firma sia scritta in esadecimale; e che nessuno abbia rigenerato il segreto dopo che lo hai copiato.
Devo per forza firmare l'email?
No. identify() senza user_hash passa comunque i dati del visitatore alla tua casella. Sono segnati come non verificati e riempiono solo i campi ancora vuoti.