Weryfikuj, kim są Twoi odwiedzający

Przekaż czatowi przez Chatixy.identify(), kim jest zalogowany odwiedzający, i podpisz jego e-mail na swoim serwerze, aby Twój zespół widział w rozmowie zweryfikowaną tożsamość.

Jak działa weryfikacja tożsamości

Gdy odwiedzający jest zalogowany w Twojej witrynie, strona może przekazać czatowi, kim jest, przez Chatixy.identify(). Jego e-mail, imię i telefon pojawiają się wtedy przy rozmowie w Twojej skrzynce, a czat przestaje pytać o e-mail.

Bez podpisu identify() działa jak formularz przed czatem: dane wypełniają tylko puste pola, a rozmowa jest oznaczona jako niezweryfikowana. Dodaj podpis utworzony na Twoim serwerze, user_hash, a Chatixy oznaczy tożsamość jako zweryfikowaną: dane zastąpią to, co wpisał odwiedzający, a karta kontaktu w Twojej skrzynce pokaże etykietę Zweryfikowany. Twój agent wsparcia dowiaduje się o weryfikacji tożsamości tylko wtedy, gdy rzeczywiście nastąpiła.

Wskazówki

  • Obowiązują zasady pól formularza przed czatem: numer telefonu jest zapisywany tylko wtedy, gdy czat o niego prosi, a imię, o ile pole imienia w czacie nie jest wyłączone.

Znajdź swój sekret tożsamości

Każdy czat ma własny Sekret tożsamości. Widzą go tylko administratorzy Twojego obszaru roboczego.

Kroki

  1. 1

    Otwórz ustawienia czatu

    W projekcie kliknij Konfiguruj przy witrynie, a następnie otwórz Ustawienia zaawansowane.

  2. 2

    Skopiuj sekret

    W sekcji Sekret tożsamości kliknij Pokaż, a potem Kopiuj.

  3. 3

    Przechowuj go na serwerze

    Zapisz go tam, gdzie może go odczytać tylko Twój serwer, na przykład w zmiennej środowiskowej CHATIXY_IDENTITY_SECRET.

Ważne

  • Nigdy nie umieszczaj sekretu tożsamości w kodzie strony, w swoim JavaScripcie ani w publicznym repozytorium. Każdy, kto go ma, może sprawić, że dowolny e-mail będzie wyglądał na zweryfikowany.
  • Wygeneruj ponownie tworzy nowy sekret, a podpisy utworzone starym od razu przestają być uznawane. Użyj tego, jeśli sekret mógł wyciec, i od razu umieść nowy na serwerze.

Podpisz e-mail na swoim serwerze

Podpis to HMAC-SHA256 adresu e-mail odwiedzającego, utworzony z sekretem tożsamości jako kluczem i zapisany jako szesnastkowy małymi literami: 64 znaki.

Podpisuj dokładnie ten e-mail, który przekazujesz do identify(). Chatixy nie zmienia wielkości liter przed sprawdzeniem, więc Ann@Example.com i ann@example.com dają różne podpisy. Twórz podpis na serwerze, przy generowaniu strony lub odpowiedzi własnego API, nigdy w przeglądarce.

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)

Przekaż tożsamość do czatu

Wywołaj Chatixy.identify() z adresem e-mail odwiedzającego i podpisem jako user_hash; name i phone są opcjonalne. Wpisz na stronę wartości wygenerowane przez Twój serwer - przykład poniżej pokazuje symbole zastępcze.

Możesz to wywołać, gdy tylko strona wie, kim jest odwiedzający. Wywołania sprzed gotowości czatu czekają i wykonują się, gdy będzie gotowy, a tożsamość przekazana przed pierwszą wiadomością zostaje przypisana do rozmowy, którą ta wiadomość rozpoczyna.

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>

Gdy podpis się nie zgadza

Niezgodny user_hash nie zapisuje niczego z tego wywołania: ani e-maila, ani imienia, ani telefonu, ani etykiety Zweryfikowany. Sam czat działa normalnie, a odwiedzający nie widzi żadnego błędu.

Zweryfikowana rozmowa pozostaje zweryfikowana: późniejsze wywołanie identify() bez podpisu nie może tego cofnąć.

Dlaczego etykieta Zweryfikowany się nie pojawia?

Sprawdź, czy podpisujesz dokładnie przekazywany e-mail, litera w literę; czy używasz sekretu tego czatu, bo każdy czat ma własny; czy podpis jest zapisany szesnastkowo; i czy nikt nie wygenerował sekretu ponownie po tym, jak go skopiowałeś.

Czy muszę podpisywać e-mail?

Nie. identify() bez user_hash nadal przekazuje dane odwiedzającego do Twojej skrzynki. Są oznaczone jako niezweryfikowane i wypełniają tylko pola, które są jeszcze puste.