Varmista, keitä kävijäsi ovat

Kerro chatille Chatixy.identify()-kutsulla, kuka kirjautunut kävijä on, ja allekirjoita hänen sähköpostiosoitteensa palvelimellasi, niin tiimisi näkee keskustelussa vahvistetun henkilöllisyyden.

Näin henkilöllisyyden vahvistus toimii

Kun kävijä on kirjautunut sivustollesi, sivusi voi kertoa chatille hänen henkilöllisyytensä kutsulla Chatixy.identify(). Sähköposti, nimi ja puhelinnumero näkyvät silloin keskustelussa saapuneissa, eikä chat enää kysy sähköpostia.

Ilman allekirjoitusta identify() toimii kuten chatia edeltävä lomake: tiedot täyttävät vain tyhjät kentät, ja keskustelu merkitään vahvistamattomaksi. Lisää palvelimellasi tehty allekirjoitus, user_hash, niin Chatixy merkitsee henkilöllisyyden vahvistetuksi: tiedot korvaavat sen, mitä kävijä kirjoitti, ja saapuneiden yhteystietokortissa näkyy merkki Vahvistettu. Tukiagentillesi kerrotaan henkilöllisyyden olevan vahvistettu vain, kun se on.

Vinkit

  • Lomakkeen kenttäsäännöt pätevät: puhelinnumero tallennetaan vain, kun chatisi kysyy sitä, ja nimi, ellei chatisi nimikenttä ole pois päältä.

Löydä tunnistussalaisuutesi

Jokaisella chatilla on oma Tunnistussalaisuus. Vain työtilasi ylläpitäjät näkevät sen.

Vaiheet

  1. 1

    Avaa chatin asetukset

    Napsauta projektissasi sivuston kohdalla Määritä ja avaa sitten Edistyneet asetukset.

  2. 2

    Kopioi salaisuus

    Napsauta kohdassa Tunnistussalaisuus Näytä ja sitten Kopioi.

  3. 3

    Säilytä se palvelimella

    Tallenna se paikkaan, josta vain palvelimesi voi lukea sen, esimerkiksi ympäristömuuttujaan CHATIXY_IDENTITY_SECRET.

Tärkeää

  • Älä koskaan laita tunnistussalaisuutta sivusi koodiin, JavaScriptiin tai julkiseen repositorioon. Kuka tahansa, jolla se on, voi saada minkä tahansa sähköpostin näyttämään vahvistetulta.
  • Luo uudelleen luo uuden salaisuuden, ja vanhalla tehdyt allekirjoitukset lakkaavat heti kelpaamasta. Käytä sitä, jos salaisuus on voinut vuotaa, ja vie uusi salaisuus heti palvelimellesi.

Allekirjoita sähköposti palvelimellasi

Allekirjoitus on kävijän sähköpostiosoitteen HMAC-SHA256, joka tehdään tunnistussalaisuus avaimena ja kirjoitetaan pienin kirjaimin heksadesimaalina: 64 merkkiä.

Allekirjoita täsmälleen se sähköpostiosoite, jonka annat kutsulle identify(). Chatixy ei muuta kirjainkokoa ennen tarkistusta, joten Ann@Example.com ja ann@example.com antavat eri allekirjoitukset. Tee allekirjoitus palvelimellasi, kun muodostat sivun tai oma API:si vastaa, älä koskaan selaimessa.

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)

Välitä henkilöllisyys chatille

Kutsu Chatixy.identify() kävijän sähköpostilla ja allekirjoituksella kentässä user_hash; name ja phone ovat vapaaehtoisia. Kirjoita sivulle palvelimesi tuottamat arvot - alla oleva esimerkki näyttää paikkamerkit.

Voit kutsua sitä heti, kun sivusi tietää, kuka kävijä on. Ennen chatin valmistumista tehdyt kutsut odottavat ja suoritetaan, kun se on valmis, ja ennen ensimmäistä viestiä annettu henkilöllisyys liitetään keskusteluun, jonka se viesti aloittaa.

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>

Jos allekirjoitus ei täsmää

Täsmäämätön user_hash ei tallenna kutsusta mitään: ei sähköpostia, nimeä, puhelinnumeroa eikä merkkiä Vahvistettu. Chat toimii tavalliseen tapaan, eikä kävijä näe virhettä.

Vahvistettu keskustelu pysyy vahvistettuna: myöhempi identify()-kutsu ilman allekirjoitusta ei voi kumota sitä.

Miksi merkki Vahvistettu ei näy?

Tarkista, että allekirjoitat täsmälleen antamasi sähköpostin kirjain kirjaimelta; että käytät tämän chatin salaisuutta, koska jokaisella chatilla on omansa; että allekirjoitus on kirjoitettu heksadesimaalina; ja ettei kukaan ole luonut salaisuutta uudelleen sen jälkeen, kun kopioit sen.

Onko sähköposti pakko allekirjoittaa?

Ei. identify() ilman user_hash-kenttää välittää kävijän tiedot silti saapuneisiin. Ne merkitään vahvistamattomiksi ja täyttävät vain vielä tyhjät kentät.