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

أخبر الدردشة بهوية الزائر الذي سجّل دخوله باستخدام Chatixy.identify()، ووقّع بريده الإلكتروني على خادمك، ليرى فريقك هوية موثّقة في المحادثة.

كيف يعمل التحقق من الهوية

عندما يكون الزائر مسجّل الدخول في موقعك، يمكن لصفحتك أن تخبر الدردشة بهويته باستخدام Chatixy.identify(). يظهر عندها بريده الإلكتروني واسمه وهاتفه في المحادثة داخل صندوق الوارد، وتتوقف الدردشة عن طلب بريده الإلكتروني.

بدون توقيع، يعمل identify() مثل نموذج ما قبل الدردشة: تملأ البيانات الحقول الفارغة فقط، وتُعلَّم المحادثة على أنها غير موثّقة. أضف توقيعًا يُنشأ على خادمك، وهو user_hash، فيعلّم Chatixy الهوية على أنها موثّقة: تحل البيانات محل ما كتبه الزائر، وتعرض بطاقة جهة الاتصال في صندوق الوارد شارة موثّق. لا يُبلَّغ وكيل الدعم بأن الهوية موثّقة إلا عندما تكون كذلك فعلًا.

نصائح

  • تنطبق قواعد حقول نموذج ما قبل الدردشة: لا يُحفظ رقم الهاتف إلا إذا طلبته الدردشة، ويُحفظ الاسم ما لم يكن حقل الاسم في الدردشة متوقفًا.

العثور على سر الهوية

لكل دردشة سر الهوية خاص بها. لا يراه إلا مسؤولو مساحة العمل لديك.

الخطوات

  1. 1

    افتح إعدادات الدردشة

    في مشروعك، انقر على تهيئة بجانب الموقع، ثم افتح الإعدادات المتقدمة.

  2. 2

    انسخ السر

    ضمن سر الهوية، انقر على إظهار ثم نسخ.

  3. 3

    احفظه على خادمك

    احفظه في مكان لا يقرؤه إلا خادمك، مثل متغير البيئة CHATIXY_IDENTITY_SECRET.

مهم

  • لا تضع سر الهوية أبدًا في كود صفحتك أو في JavaScript الخاص بك أو في مستودع عام. أي شخص يملكه يمكنه جعل أي بريد إلكتروني يبدو موثّقًا.
  • إعادة التوليد ينشئ سرًا جديدًا، وتتوقف التواقيع المصنوعة بالسر القديم عن القبول فورًا. استخدمه إذا كان السر قد تسرّب، وضع السر الجديد على خادمك فورًا.

وقّع البريد الإلكتروني على خادمك

التوقيع هو HMAC-SHA256 لبريد الزائر الإلكتروني، يُحسب باستخدام سر الهوية كمفتاح ويُكتب بالنظام الست عشري بأحرف صغيرة: 64 حرفًا.

وقّع البريد الإلكتروني نفسه تمامًا الذي تمرّره إلى identify(). لا يغيّر Chatixy حالة الأحرف قبل التحقق، لذا يعطي Ann@Example.com وann@example.com توقيعين مختلفين. أنشئ التوقيع على خادمك عند إنشاء الصفحة أو عند رد واجهتك البرمجية، ولا تنشئه أبدًا في المتصفح.

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)

مرّر الهوية إلى الدردشة

استدعِ Chatixy.identify() مع بريد الزائر الإلكتروني والتوقيع في user_hash؛ الحقلان name وphone اختياريان. اكتب في الصفحة القيم التي أنتجها خادمك - يعرض المثال أدناه قيمًا مؤقتة.

يمكنك استدعاؤه بمجرد أن تعرف صفحتك هوية الزائر. الاستدعاءات التي تسبق جاهزية الدردشة تنتظر وتُنفَّذ عند جاهزيتها، والهوية المعطاة قبل الرسالة الأولى تُربط بالمحادثة التي تبدؤها تلك الرسالة.

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>

إذا لم يتطابق التوقيع

لا يحفظ user_hash غير المتطابق أي شيء من ذلك الاستدعاء: لا بريد إلكتروني ولا اسم ولا هاتف ولا شارة موثّق. تستمر الدردشة في العمل كالمعتاد، ولا يرى الزائر أي خطأ.

تبقى المحادثة الموثّقة موثّقة: لا يمكن لاستدعاء لاحق لـ identify() بدون توقيع أن يلغي ذلك.

لماذا لا تظهر شارة موثّق؟

تأكد من أنك توقّع البريد الإلكتروني الذي تمرّره نفسه حرفًا بحرف؛ وأنك تستخدم سر هذه الدردشة، لأن لكل دردشة سرها؛ وأن التوقيع مكتوب بالنظام الست عشري؛ وأن أحدًا لم يُعد توليد السر بعد أن نسخته.

هل يجب أن أوقّع البريد الإلكتروني؟

لا. يمرّر identify() بدون user_hash بيانات الزائر إلى صندوق الوارد على أي حال. تُعلَّم على أنها غير موثّقة ولا تملأ إلا الحقول التي لا تزال فارغة.