Bekreft hvem de besøkende er
Fortell chatten hvem en innlogget besøkende er med Chatixy.identify(), og signer e-postadressen på serveren din, slik at teamet ditt ser en bekreftet identitet på samtalen.
Slik fungerer identitetsbekreftelse
Når en besøkende er logget inn på nettstedet ditt, kan siden din fortelle chatten hvem vedkommende er med Chatixy.identify(). E-post, navn og telefon vises da på samtalen i innboksen din, og chatten slutter å be om e-postadressen.
Uten signatur fungerer identify() som skjemaet før chatten: opplysningene fyller bare tomme felt, og samtalen merkes som ikke bekreftet. Legg til en signatur laget på serveren din, user_hash, så merker Chatixy identiteten som bekreftet: opplysningene erstatter det den besøkende skrev, og kontaktkortet i innboksen viser merket Verifisert. Supportagenten din får bare vite at identiteten er bekreftet når den er det.
Tips
- Feltreglene fra skjemaet før chatten gjelder: et telefonnummer lagres bare når chatten din ber om det, og et navn med mindre navnefeltet i chatten er slått av.
Finn identitetshemmeligheten din
Hver chat har sin egen Identitetshemmelighet. Bare administratorer i arbeidsområdet ditt kan se den.
Trinn
- 1
Åpne innstillingene for chatten
Klikk på Konfigurer ved nettstedet i prosjektet ditt, og åpne deretter Avanserte innstillinger.
- 2
Kopier hemmeligheten
Under Identitetshemmelighet klikker du på Vis og deretter Kopier.
- 3
Oppbevar den på serveren
Lagre den der bare serveren din kan lese den, for eksempel i miljøvariabelen
CHATIXY_IDENTITY_SECRET.
Viktig
- Legg aldri identitetshemmeligheten i sidens kode, i JavaScriptet ditt eller i et offentlig repository. Den som har den, kan få hvilken som helst e-postadresse til å se bekreftet ut.
- Generer på nytt lager en ny hemmelighet, og signaturer laget med den gamle slutter straks å bli godtatt. Bruk den hvis hemmeligheten kan ha lekket, og legg den nye inn på serveren med en gang.
Signer e-postadressen på serveren din
Signaturen er en HMAC-SHA256 av den besøkendes e-postadresse, laget med identitetshemmeligheten din som nøkkel og skrevet som heksadesimal med små bokstaver: 64 tegn.
Signer nøyaktig den e-postadressen du sender til identify(). Chatixy endrer ikke store og små bokstaver før den sjekker, så Ann@Example.com og ann@example.com gir ulike signaturer. Lag signaturen på serveren din, når du bygger siden eller ditt eget API svarer, aldri i nettleseren.
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)Gi identiteten til chatten
Kall Chatixy.identify() med den besøkendes e-postadresse og signaturen som user_hash; name og phone er valgfrie. Skriv verdiene serveren din laget inn på siden - eksempelet nedenfor viser plassholdere.
Du kan kalle den så snart siden din vet hvem den besøkende er. Kall som kommer før chatten er klar, venter og kjøres når den er klar, og en identitet gitt før den første meldingen knyttes til samtalen den meldingen starter.
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>Hvis en signatur ikke stemmer
En user_hash som ikke stemmer, lagrer ingenting fra det kallet: ingen e-post, ikke noe navn, ingen telefon og ikke noe merke Verifisert. Selve chatten fungerer som vanlig, og den besøkende ser ingen feil.
En bekreftet samtale forblir bekreftet: et senere kall til identify() uten signatur kan ikke angre det.
Hvorfor vises ikke merket Verifisert?
Sjekk at du signerer nøyaktig den e-postadressen du sender, bokstav for bokstav; at du bruker hemmeligheten til denne chatten, siden hver chat har sin egen; at signaturen er skrevet heksadesimalt; og at ingen har generert hemmeligheten på nytt etter at du kopierte den.
Må jeg signere e-postadressen?
Nei. identify() uten user_hash sender fortsatt den besøkendes opplysninger til innboksen din. De merkes som ikke bekreftet og fyller bare felt som fortsatt er tomme.