Ziyaretçilerinizin kim olduğunu doğrulayın

Oturum açmış bir ziyaretçinin kim olduğunu Chatixy.identify() ile sohbete bildirin ve e-postasını sunucunuzda imzalayın; ekibiniz konuşmada doğrulanmış bir kimlik görsün.

Kimlik doğrulama nasıl çalışır

Bir ziyaretçi sitenizde oturum açmışsa sayfanız Chatixy.identify() ile sohbete onun kim olduğunu söyleyebilir. E-postası, adı ve telefonu gelen kutunuzdaki konuşmada görünür ve sohbet artık e-postasını sormaz.

İmza olmadan identify() sohbet öncesi form gibi çalışır: bilgiler yalnızca boş alanları doldurur ve konuşma doğrulanmamış olarak işaretlenir. Sunucunuzda oluşturulan bir imza, yani user_hash ekleyin; Chatixy kimliği doğrulanmış olarak işaretler: bilgiler ziyaretçinin yazdıklarının yerini alır ve gelen kutunuzdaki kişi kartında Doğrulandı etiketi görünür. Destek temsilcinize kimliğin doğrulandığı yalnızca gerçekten doğrulandığında söylenir.

İpuçları

  • Sohbet öncesi formun alan kuralları geçerlidir: telefon numarası yalnızca sohbetiniz isterse, ad ise sohbetinizin ad alanı kapalı değilse kaydedilir.

Kimlik sırrınızı bulun

Her sohbetin kendi Kimlik sırrı değeri vardır. Bunu yalnızca çalışma alanınızın yöneticileri görebilir.

Adımlar

  1. 1

    Sohbet ayarlarını açın

    Projenizde sitenin yanındaki Yapılandır düğmesine tıklayın, ardından Gelişmiş ayarlar bölümünü açın.

  2. 2

    Sırrı kopyalayın

    Kimlik sırrı altında Göster, ardından Kopyala düğmesine tıklayın.

  3. 3

    Sunucunuzda saklayın

    Yalnızca sunucunuzun okuyabileceği bir yerde saklayın, örneğin CHATIXY_IDENTITY_SECRET ortam değişkeninde.

Önemli

  • Kimlik sırrını asla sayfa kodunuza, JavaScript'inize veya herkese açık bir depoya koymayın. Ona sahip olan herkes herhangi bir e-postayı doğrulanmış gibi gösterebilir.
  • Yeniden oluştur yeni bir sır oluşturur ve eskisiyle yapılan imzalar hemen kabul edilmez olur. Sır sızmış olabilirse kullanın ve yeni sırrı hemen sunucunuza koyun.

E-postayı sunucunuzda imzalayın

İmza, ziyaretçinin e-postasının kimlik sırrınız anahtar olarak kullanılarak oluşturulan ve küçük harfli onaltılık olarak yazılan HMAC-SHA256 değeridir: 64 karakter.

identify() çağrısına verdiğiniz e-postayı tam olarak imzalayın. Chatixy kontrol etmeden önce büyük-küçük harfi değiştirmez; bu yüzden Ann@Example.com ve ann@example.com farklı imzalar verir. İmzayı sayfayı oluştururken veya kendi API'niz yanıt verirken sunucunuzda oluşturun, asla tarayıcıda değil.

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)

Kimliği sohbete iletin

Chatixy.identify() çağrısını ziyaretçinin e-postası ve user_hash olarak imzayla yapın; name ve phone isteğe bağlıdır. Sunucunuzun ürettiği değerleri sayfaya yazın - aşağıdaki örnek yer tutucular gösterir.

Sayfanız ziyaretçinin kim olduğunu bildiği anda çağırabilirsiniz. Sohbet hazır olmadan yapılan çağrılar bekler ve hazır olduğunda çalışır; ilk mesajdan önce verilen kimlik, o mesajın başlattığı konuşmaya eklenir.

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>

İmza eşleşmezse

Eşleşmeyen bir user_hash o çağrıdan hiçbir şey kaydetmez: ne e-posta, ne ad, ne telefon, ne de Doğrulandı etiketi. Sohbetin kendisi her zamanki gibi çalışır ve ziyaretçi hiçbir hata görmez.

Doğrulanmış bir konuşma doğrulanmış kalır: imzasız sonraki bir identify() çağrısı bunu geri alamaz.

Doğrulandı etiketi neden görünmüyor?

Verdiğiniz e-postayı harfi harfine imzaladığınızı; her sohbetin kendi sırrı olduğundan bu sohbetin sırrını kullandığınızı; imzanın onaltılık yazıldığını; ve siz kopyaladıktan sonra kimsenin sırrı yeniden oluşturmadığını kontrol edin.

E-postayı imzalamak zorunda mıyım?

Hayır. user_hash olmadan identify() yine de ziyaretçinin bilgilerini gelen kutunuza iletir. Bunlar doğrulanmamış olarak işaretlenir ve yalnızca hâlâ boş olan alanları doldurur.