Bekræft, hvem dine besøgende er

Fortæl chatten med Chatixy.identify(), hvem en logget ind besøgende er, og signér vedkommendes e-mail på din server, så dit team ser en bekræftet identitet på samtalen.

Sådan virker identitetsbekræftelse

Når en besøgende er logget ind på dit website, kan din side fortælle chatten, hvem vedkommende er, med Chatixy.identify(). E-mail, navn og telefon vises så på samtalen i din indbakke, og chatten holder op med at bede om e-mailen.

Uden signatur virker identify() som før-chat-formularen: oplysningerne udfylder kun tomme felter, og samtalen markeres som ikke bekræftet. Tilføj en signatur lavet på din server, user_hash, og Chatixy markerer identiteten som bekræftet: oplysningerne erstatter det, den besøgende skrev, og kontaktkortet i din indbakke viser mærket Verificeret. Din supportagent får kun at vide, at identiteten er bekræftet, når den er det.

Tips

  • Før-chat-formularens feltregler gælder: et telefonnummer gemmes kun, når din chat beder om et, og et navn, medmindre navnefeltet i din chat er slået fra.

Find din identitetshemmelighed

Hver chat har sin egen Identitetshemmelighed. Kun administratorer i dit arbejdsområde kan se den.

Trin

  1. 1

    Åbn chattens indstillinger

    Klik på Konfigurer ved sitet i dit projekt, og åbn derefter Avancerede indstillinger.

  2. 2

    Kopiér hemmeligheden

    Under Identitetshemmelighed klikker du på Vis og derefter Kopiér.

  3. 3

    Gem den på din server

    Gem den, hvor kun din server kan læse den, for eksempel i miljøvariablen CHATIXY_IDENTITY_SECRET.

Vigtigt

  • Læg aldrig identitetshemmeligheden i din sides kode, dit JavaScript eller et offentligt repository. Enhver, der har den, kan få enhver e-mail til at se bekræftet ud.
  • Generér igen laver en ny hemmelighed, og signaturer lavet med den gamle holder straks op med at blive godkendt. Brug den, hvis hemmeligheden kan være lækket, og læg den nye på din server med det samme.

Signér e-mailen på din server

Signaturen er en HMAC-SHA256 af den besøgendes e-mail, lavet med din identitetshemmelighed som nøgle og skrevet som hexadecimal med små bogstaver: 64 tegn.

Signér præcis den e-mail, du sender til identify(). Chatixy ændrer ikke store og små bogstaver, før den tjekker, så Ann@Example.com og ann@example.com giver forskellige signaturer. Lav signaturen på din server, når du danner siden eller svarer fra dit eget API, aldrig i browseren.

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)

Giv identiteten til chatten

Kald Chatixy.identify() med den besøgendes e-mail og signaturen som user_hash; name og phone er valgfrie. Skriv de værdier, din server lavede, ind på siden - eksemplet nedenfor viser pladsholdere.

Du kan kalde den, så snart din side ved, hvem den besøgende er. Kald, der kommer før chatten er klar, venter og kører, når den er klar, og en identitet givet før den første besked knyttes til den samtale, som beskeden 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 passer

En user_hash, der ikke passer, gemmer intet fra det kald: ingen e-mail, intet navn, ingen telefon og intet mærke Verificeret. Selve chatten virker som normalt, og den besøgende ser ingen fejl.

En bekræftet samtale forbliver bekræftet: et senere kald til identify() uden signatur kan ikke fortryde det.

Hvorfor vises mærket Verificeret ikke?

Tjek, at du signerer præcis den e-mail, du sender, bogstav for bogstav; at du bruger denne chats hemmelighed, da hver chat har sin egen; at signaturen er skrevet hexadecimalt; og at ingen har genereret hemmeligheden igen, efter du kopierede den.

Skal jeg signere e-mailen?

Nej. identify() uden user_hash sender stadig den besøgendes oplysninger til din indbakke. De markeres som ikke bekræftede og udfylder kun felter, der stadig er tomme.