كيفية استخدام setAttributes() مع hash في JavaScript

التعليمات أدناه مخصصة لأجهزة الكمبيوتر المكتبية والمحمولة فقط.

يمكنك استخدام دالة setAttributes() في API الخاصة بنا لتعديل تفاصيل العملاء مثل الاسم وعنوان البريد الإلكتروني عبر واجهة الدردشة Chat Widget الخاصة بـ tawk.to.


استخدام hash مع دالة setAttributes() طريقة رائعة لحماية بيانات العملاء. الـ hash هو ميزة أمان قوية تمثل مزيجًا مشفرًا من مفتاحك السري (Key) ومعرف المستخدم.


في هذا الدليل، سنوضح لك كيفية الحصول على مفتاحك السري (Key)، إنشاء hash، واستخدامه مع دالة setAttributes() في API الخاصة بنا.

أولاً، احصل على المفتاح السري (Key)

اتبع هذه الخطوات للحصول على مفتاحك السري (Key):


1. قم بتسجيل الدخول إلى حسابك في tawk.to.

2. في لوحة التحكم (Dashboard)، حدد الخاصية التي تحتاج إلى المفتاح لها. حرّك المؤشر فوق اسم الخاصية للتأكد من اختيارك الصحيح.

3. اضغط على رمز الترس (gear icon) في القائمة العلوية للانتقال إلى لوحة الإدارة (Administration).
4. في قائمة الإدارة، اختر نظرة عامة (Overview).
5. انتقل لأسفل إلى JavaScript API.
6. فعّل وضع آمن (Secure Mode).
7. اضغط على الرمز التالي لنسخ المفتاح (Key):

ستحتاج هذا المفتاح في القسم التالي حيث سنقوم بإنشاء hash.

إنشاء الـ hash

يتم إنشاء hash بواسطة خدمة تقبل مزيجًا من مفتاحك السري (Key) ومعرف المستخدم، وتشفّرها إلى سلسلة من الأحرف التي لا يمكن للأطراف غير المصرح لها قراءتها.


يمكنك استخدام أي خدمة تشفير من اختيارك لإنشاء hash. في هذا المثال، سنوضح لك كيفية القيام بذلك باستخدام Crypto.js. المكتبات ذات الصلة متاحة على:

https://cryptojs.gitbook.io/docs

https://www.npmjs.com/package/crypto-js

اتبع هذه الخطوات لإنشاء hash:


1. انسخ الكود التالي في قسم من HTML الخاص بموقعك:

2. انسخ الدالة التالية في ملف JavaScript الخاص بك. هذه الدالة تتولى إنشاء قيمة الـ hash.

3. استبدل secretKey بالمفتاح (Key) المنسوخ من لوحة التحكم (Dashboard) الخاصة بـ tawk.to.

بعد ذلك، لنستخدم الـ hash مع دالة setAttributes().

استخدام setAttributes() مع hash

اتبع هذه الخطوات لاستخدام setAttributes() مع hash:


1. انسخ دالة setAttributes() من API الخاصة بنا إلى مخطط API الخاص بك.

ملاحظة: إذا كنت تستخدم الخاصية phone مع setAttributes()، تأكد من أن رقم الهاتف يتبع التنسيق الدولي E.164 (مثل +1234567890).


2. انسخ الـ hash الذي أنشأته في حقل hash.

3. تأكد من أن القيمة في حقل userID تطابق معرف المستخدم المستخدم في خطوات التشفير أعلاه.

ملاحظة: قد يستغرق الأمر بضع ثوانٍ لتحديث بيانات العملاء.

رموز الأخطاء

 فيما يلي رموز الأخطاء المحتملة التي قد تواجهها:

رمز الخطأالوصف
400Bad Request Error
هذا يشير إلى وجود خطأ في سمات دالتك. تحقق من الكود وأعد إرسال الطلب.
401Unauthorized Error
وهذا يدل على أن
  • معرف المستخدم لا يتطابق مع قيمة التجزئة المشفرة، أو
  • لم يتم تمكين الوضع الآمن في لوحة معلومات tawk.to الخاصة بك.

تحقق من الكود وأعد إرسال الطلب.
500Internal Server Error
يشير هذا إلى أن خوادمنا مشغولة حاليًا. حاول إعادة إرسال الطلب.

ستظهر هذه الرموز في وحدة تحكم المطور (Developer Console) في متصفح الويب الخاص بك.

مع هذه الخطوات، تكون قد عززت أمان واجهة الدردشة Chat Widget الخاصة بـ tawk.to، مما يوفر لعملائك تجربة أكثر أمانًا وقوة.


إذا واجهت أي تحديات أو كانت لديك أسئلة إضافية، يرجى التواصل معنا.


إذا كان لديك ملاحظات حول هذه المقالة، أو إذا كنت بحاجة إلى مزيد من المساعدة:


هل كان هذا المقال مفيداً؟

3 من 6 أعجب بهذا المقال