Keptly
القنوات

تركيب ويدجت المحادثة على موقعك

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

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

السكربت

من صفحة الإعدادات في لوحة التحكّم، انسخ السكربت الخاص بك:

<!-- Keptly chat widget -->
<script src="https://wasl.sa/widget.js" data-company="your-company-slug" defer></script>
wasl/dashboard/settings
Settings → Channels → Web widget
<!-- Keptly chat widget -->
<script
src="https://keptly.net/widget.js"
data-company="riyadh-realty"
defer></script>

Paste this just before the closing </body> tag on every page where you want the chat bubble. Most CMS templates have one global footer file.

الخطوة الثالثة — سطر واحد، انسخ والصق

استبدل your-company-slug بالقيمة الظاهرة في صفحة الإعدادات (مُعبّأة هناك أصلاً).

أين تلصقه

أغلب المواقع: قبل وسم </body> الخاتم في كود HTML.

إذا كنت على منصّة بدون كود:

  • WordPress: القالب ← المحرّر ← footer.php (أو إضافة مثل "Insert Headers and Footers")
  • Wix: الإعدادات ← Custom Code ← +Add Custom Code ← الصق في قسم body
  • Webflow: Project Settings ← Custom Code ← Footer Code
  • Shopify: Online Store ← Themes ← Edit code ← theme.liquid ← قبل </body>
  • Squarespace: Settings ← Advanced ← Code Injection ← Footer
  • سلّة / زد (التجارة السعوديّة): المتجر ← السكربتات المخصّصة ← التذييل (Footer)

بعد اللصق، حدّث موقعك. ستظهر فقّاعة محادثة في الزاوية السفليّة (يساراً للغات RTL، يميناً للغات LTR).

your-website.com
R
Riyadh Realty
الخطوة الرابعة — كيف تظهر فقّاعة المحادثة على موقعك

ماذا يحدث بعد ذلك

عندما يضغط الزائر الفقّاعة:

١. الويدجت يُحمَّل في iframe — لا تتعارض واجهته مع موقعك ٢. الزائر يكتب رسالة ويضغط إرسال ٣. وَصل ينشئ محادثة جديدة في صندوق وارد لوحة التحكّم ٤. خلال ~٥ ثوانٍ، نظام الذكاء الاصطناعي يستخرج البيانات المنظّمة (الاسم، الجوّال، البريد، النيّة، درجة العميل) ٥. إذا ربطت نظام إدارة عملاء، فالجهة دُفعت إليه

تخصيص الويدجت

حاليّاً الويدجت يأخذ اسم شركتك وتدرّج ألوان الغروب الأساسي. نعمل على:

  • لون أساسي مخصّص (مخطّط، تواصل مع الدعم لطلبه)
  • رسالة ترحيب مخصّصة (مخطّط)
  • موضع مخصّص (يمين أو يسار، مخطّط)

في الوقت الحالي، الويدجت يعرض تصميم بطاقة زجاجيّة نظيف يعمل على أي خلفيّة.

الخصوصيّة ونظام حماية البيانات الشخصيّة (PDPL)

الويدجت يُحمَّل ضمن iframe من wasl.sa. لا يقرأ DOM موقعك، ولا يتتبّع الزوّار بين الصفحات، ولا يضع كوكيز على نطاقك.

كلّ بيانات المحادثة تُعالَج وتُخزَّن بحسب سياسة الخصوصيّة. رسائل زوّارك تتدفّق إلى:

  • قاعدة بيانات حسابك في وَصل (في منطقة me-south-1 بالبحرين)
  • نظام إدارة العملاء المربوط (إن وُجد)
  • مزوّد الذكاء الاصطناعي للاستخراج (نص فقط؛ لا يُحتفَظ بالبيانات الشخصيّة)

الزوّار لا يحتاجون إلى قبول كوكيز لاستخدام المحادثة — تُضبَط الكوكيز الأساسيّة فقط (مثل كوكيز جلسة المحادثة)، تماشياً مع المادّة ١٥ من نظام حماية البيانات الشخصيّة.

مشاكل شائعة

الفقّاعة لا تظهر.

  • تأكّد أنّ سكربت wasl.sa/widget.js موجود في مصدر الصفحة (View Source → ابحث عنه)
  • تحقّق من رسائل console المتصفّح
  • تأكّد أنّ defer موجود (بدونه قد لا يعمل السكربت على الصفحات بطيئة التحميل)

الفقّاعة تظهر لكن الرسائل لا تُرسَل.

  • تأكّد أنّ قيمة data-company تطابق slug شركتك بالضبط
  • تواصل مع الدعم — يمكننا التتبّع من سجل التدقيق

المحادثات تظهر في الصندوق لكن لا تُستخرَج بيانات الجهة.

  • المستخرِج يعمل بعد كلّ رسالة. انتظر ٥–١٠ ثوانٍ.
  • إن استمرّت المشكلة، تأكّد من رصيد مزوّد الذكاء الاصطناعي لحسابك
  • تواصل مع الدعم — يمكننا إعادة تشغيل الاستخراج من لوحة الإدارة

التالي


هل تحتاج مساعدة؟

إذا لم تجد إجابة سؤالك في الوثائق، تواصل مع فريق الدعم مباشرة.

support@keptly.net
Install the website chat widget — Keptly docs