Controleer wie je bezoekers zijn

Vertel de chat met Chatixy.identify() wie een ingelogde bezoeker is en onderteken zijn e-mailadres op je server, zodat je team een geverifieerde identiteit bij het gesprek ziet.

Zo werkt identiteitsverificatie

Is een bezoeker ingelogd op je website, dan kan je pagina de chat met Chatixy.identify() vertellen wie hij is. Zijn e-mailadres, naam en telefoonnummer staan dan bij het gesprek in je inbox, en de chat vraagt niet meer om zijn e-mailadres.

Zonder handtekening werkt identify() zoals het pre-chatformulier: de gegevens vullen alleen lege velden en het gesprek staat als niet geverifieerd. Voeg een handtekening toe die je server maakt, de user_hash, en Chatixy markeert de identiteit als geverifieerd: de gegevens vervangen wat de bezoeker typte, en de contactkaart in je inbox toont het label Geverifieerd. Je supportagent hoort alleen dat de identiteit geverifieerd is als dat echt zo is.

Tips

  • De veldregels van het pre-chatformulier gelden: een telefoonnummer wordt alleen bewaard als je chat erom vraagt, en een naam tenzij het naamveld van je chat uit staat.

Je identiteitsgeheim vinden

Elke chat heeft een eigen Identiteitsgeheim. Alleen beheerders van je werkruimte kunnen het zien.

Stappen

  1. 1

    Open de instellingen van de chat

    Klik in je project bij de site op Configureren en open daarna Geavanceerde instellingen.

  2. 2

    Kopieer het geheim

    Klik onder Identiteitsgeheim op Tonen en daarna op Kopiëren.

  3. 3

    Bewaar het op je server

    Bewaar het waar alleen je server het kan lezen, bijvoorbeeld in de omgevingsvariabele CHATIXY_IDENTITY_SECRET.

Belangrijk

  • Zet het identiteitsgeheim nooit in de code van je pagina, in je JavaScript of in een openbare repository. Wie het heeft, kan elk e-mailadres er geverifieerd laten uitzien.
  • Opnieuw genereren maakt een nieuw geheim, en handtekeningen met het oude worden meteen niet meer geaccepteerd. Gebruik het als het geheim uitgelekt kan zijn, en zet het nieuwe direct op je server.

Onderteken het e-mailadres op je server

De handtekening is een HMAC-SHA256 van het e-mailadres van de bezoeker, gemaakt met je identiteitsgeheim als sleutel en geschreven als hexadecimaal in kleine letters: 64 tekens.

Onderteken precies het e-mailadres dat je aan identify() doorgeeft. Chatixy past hoofdletters en kleine letters niet aan voordat het controleert, dus Ann@Example.com en ann@example.com geven verschillende handtekeningen. Maak de handtekening op je server, als je de pagina opbouwt of je eigen API antwoordt, nooit in de 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)

Geef de identiteit door aan de chat

Roep Chatixy.identify() aan met het e-mailadres van de bezoeker en de handtekening als user_hash; name en phone zijn optioneel. Zet de waarden die je server maakte in de pagina - het voorbeeld hieronder toont plaatshouders.

Je kunt het aanroepen zodra je pagina weet wie de bezoeker is. Aanroepen voordat de chat klaar is, wachten en lopen zodra hij klaar is, en een identiteit die vóór het eerste bericht is gegeven, hoort bij het gesprek dat dat bericht begint.

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>

Als een handtekening niet klopt

Een user_hash die niet klopt, bewaart niets uit die aanroep: geen e-mailadres, geen naam, geen telefoonnummer en geen label Geverifieerd. De chat zelf werkt gewoon door en de bezoeker ziet geen fout.

Een geverifieerd gesprek blijft geverifieerd: een latere aanroep van identify() zonder handtekening kan dat niet ongedaan maken.

Waarom verschijnt het label Geverifieerd niet?

Controleer dat je precies het doorgegeven e-mailadres ondertekent, letter voor letter; dat je het geheim van deze chat gebruikt, want elke chat heeft een eigen; dat de handtekening hexadecimaal is geschreven; en dat niemand het geheim opnieuw heeft gegenereerd nadat je het kopieerde.

Moet ik het e-mailadres ondertekenen?

Nee. identify() zonder user_hash geeft de gegevens van de bezoeker toch door aan je inbox. Ze staan als niet geverifieerd en vullen alleen velden die nog leeg zijn.