Bekräfta vilka dina besökare är
Berätta för chatten vem en inloggad besökare är med Chatixy.identify() och signera besökarens e-post på din server, så att ditt team ser en verifierad identitet på konversationen.
Så fungerar identitetsverifiering
När en besökare är inloggad på din webbplats kan din sida berätta för chatten vem hen är med Chatixy.identify(). E-post, namn och telefon visas då på konversationen i din inkorg, och chatten slutar be om e-postadressen.
Utan signatur fungerar identify() som formuläret före chatten: uppgifterna fyller bara tomma fält och konversationen markeras som ej verifierad. Lägg till en signatur som din server skapar, user_hash, så markerar Chatixy identiteten som verifierad: uppgifterna ersätter det besökaren skrev, och kontaktkortet i din inkorg visar märket Verifierad. Din supportagent får bara veta att identiteten är verifierad när den är det.
Tips
- Formulärets fältregler gäller: ett telefonnummer sparas bara när din chatt frågar efter ett, och ett namn om inte namnfältet i din chatt är avstängt.
Hitta din identitetshemlighet
Varje chatt har sin egen Identitetshemlighet. Bara administratörer i din arbetsyta kan se den.
Steg
- 1
Öppna chattens inställningar
Klicka på Konfigurera vid webbplatsen i ditt projekt och öppna sedan Avancerade inställningar.
- 2
Kopiera hemligheten
Under Identitetshemlighet klickar du på Visa och sedan Kopiera.
- 3
Förvara den på din server
Spara den där bara din server kan läsa den, till exempel i miljövariabeln
CHATIXY_IDENTITY_SECRET.
Viktigt
- Lägg aldrig identitetshemligheten i sidans kod, i ditt JavaScript eller i ett publikt repository. Den som har den kan få vilken e-postadress som helst att se verifierad ut.
- Generera om skapar en ny hemlighet, och signaturer gjorda med den gamla slutar genast att godkännas. Använd den om hemligheten kan ha läckt, och lägg in den nya på din server direkt.
Signera e-postadressen på din server
Signaturen är en HMAC-SHA256 av besökarens e-postadress, skapad med din identitetshemlighet som nyckel och skriven som hexadecimal med små bokstäver: 64 tecken.
Signera exakt den e-postadress du skickar till identify(). Chatixy ändrar inte stora och små bokstäver innan den kontrollerar, så Ann@Example.com och ann@example.com ger olika signaturer. Skapa signaturen på din server, när du bygger sidan eller ditt eget API svarar, aldrig i webbläsaren.
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)Skicka identiteten till chatten
Anropa Chatixy.identify() med besökarens e-postadress och signaturen som user_hash; name och phone är valfria. Skriv in värdena som din server tog fram på sidan - exemplet nedan visar platshållare.
Du kan anropa den så snart din sida vet vem besökaren är. Anrop som görs innan chatten är redo väntar och körs när den är det, och en identitet som ges före det första meddelandet kopplas till konversationen som meddelandet startar.
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>Om en signatur inte stämmer
En user_hash som inte stämmer sparar ingenting från det anropet: ingen e-post, inget namn, ingen telefon och inget märke Verifierad. Själva chatten fungerar som vanligt, och besökaren ser inget fel.
En verifierad konversation förblir verifierad: ett senare anrop till identify() utan signatur kan inte ångra det.
Varför visas inte märket Verifierad?
Kontrollera att du signerar exakt den e-postadress du skickar, bokstav för bokstav; att du använder den här chattens hemlighet, eftersom varje chatt har sin egen; att signaturen är skriven hexadecimalt; och att ingen har genererat om hemligheten efter att du kopierade den.
Måste jag signera e-postadressen?
Nej. identify() utan user_hash skickar ändå besökarens uppgifter till din inkorg. De markeras som ej verifierade och fyller bara fält som fortfarande är tomma.