التحقق من هوية الزوار

إن كان في موقعك تسجيل دخول للعملاء، تستطيع أن تمرّر اسم العميل وبريده إلى محادثة الموقع، فيرى فريقك من يكلّمه دون أن يسأله. ولكي لا يستطيع أحد أن يدّعي أنه عميل آخر، يرسل موقعك مع بيانات العميل رمزاً سرياً يثبت هويته. هذا الرمز يُحسب على خادم موقعك فقط.

انسخ المفتاح السري

1. افتح الإعدادات ثم قنوات التواصل، واضغط زر الإعدادات بجانب قناة الموقع.
2. افتح تبويب التهيئة، وانزل إلى قسم التحقّق من الهوية.
3. في خانة المفتاح السري (1) اضغط نسخ، وضع المفتاح في إعدادات خادم موقعك.

ملاحظة: لا تضع المفتاح السري في كود الصفحة أو في ملفات JavaScript التي يراها المتصفح. من يملك المفتاح يستطيع انتحال أي عميل.

احسب الرمز على خادمك

الرمز اسمه identifier_hash، وهو قيمة HMAC SHA256 لمعرّف العميل في نظامك (مثل رقم حسابه)، بالمفتاح السري، بصيغة hex. مثال بلغة PHP:

$identifierHash = hash_hmac('sha256', (string) $customer->id, getenv('HADIR_IDENTITY_SECRET'));

ومثال بـ Node.js:

const crypto = require('crypto');
const identifierHash = crypto
  .createHmac('sha256', process.env.HADIR_IDENTITY_SECRET)
  .update(String(customer.id))
  .digest('hex');

مرّر بيانات العميل في الصفحة

بعد أن تجهز المحادثة على الصفحة، استدعِ setUser بالمعرّف نفسه الذي حسبت منه الرمز:

window.addEventListener('hadir:ready', function () {
  window.$hadir.setUser('12345', {
    name: 'اسم العميل',
    email: '[email protected]',
    identifier_hash: 'الرمز الذي حسبه خادمك'
  });
});

• يجب أن يحتوي الكائن على واحد على الأقل من name أو email أو avatar_url.
• حين يسجّل العميل خروجه من موقعك، استدعِ window.$hadir.reset() حتى لا تبقى محادثته ظاهرة لمن يستخدم الجهاز بعده.

اشترط التحقق (اختياري)

شغّل اشترط التحقّق من الهوية في كل المحادثات (2) حين يرسل موقعك الرمز في كل الصفحات. بعدها يُرفض أي تعريف لزائر بلا قيمة identifier_hash صحيحة، فلا يستطيع أحد أن ينتحل صفة عميل آخر. أما الزائر الذي لم يسجّل دخوله فيبقى قادراً على بدء محادثة كزائر مجهول.

تجديد المفتاح

إن ظننت أن المفتاح تسرّب، اضغط تجديد المفتاح ثم جدّد المفتاح. يتوقف المفتاح الحالي عن العمل فوراً، فحدّث كل موقع يستخدمه بالمفتاح الجديد وإلا فشل التحقق.