أداة دردشة الويب

أداة الدردشة سكربت JS تُضمّنه في موقعك (تسويقي، دعم، تطبيق). وهي تفتح نافذة محادثة تُشغّلها إحدى pipelines betool لديك؛ وتظهر ردود الوكيل تدريجيًا أثناء توليدها (streaming).

الميزات

• مقتطف واحد لِلَصقه في صفحتك. لا يوجد اعتماد npm؛ وتعيش الأداة داخل Shadow DOM، فلا تُشوّهها أنماط CSS الخاصة بموقعك (والعكس صحيح).
• رمز مميّز عام — قابل لإعادة التوليد في أي وقت من المحرّر. لا يوجد أي سرّ على جانب العميل.
• استمرارية لكل تبويب — يُحفَظ مُعرِّف المحادثة في sessionStorage: إعادة تحميل الصفحة تستأنف المحادثة، وإغلاق التبويب يُنهيها. ولا تضع الأداة أي ملف تعريف ارتباط (cookie).
• 8 لغات — تتبع واجهة الأداة لغة متصفّح الزائر.
• ضوابط مكافحة إساءة الاستخدام مفعّلة افتراضيًا — 20 رسالة في الدقيقة لكل IP، و10 جلسات جديدة في الدقيقة لكل IP، و4 000 حرف كحدّ أقصى لكل رسالة (قابلة للضبط؛ 0 يُعطّل الحماية المعنية). كما يحجب سقفٌ إجمالي لكل أداة (20 ضعف الحدّ لكل IP) موجات الإغراق الموزّعة على عدّة عناوين IP.

الإعداد

1. في محرّر النموذج، هيّئ عقدة Start بمستقبِل دردشة (أداة ويب).
2. عند الحفظ، يولّد betool الرمز المميّز العام ويعرض مقتطف التضمين جاهزًا للنسخ:

<script src="https://platform.betool.ai/widget/v1/widget.js"></script>
<script>
  BetoolChat.init({ token: "<token-public-du-widget>" });
</script>

3. الصق هذا المقتطف داخل وسم <body> في موقعك. تظهر الأداة تلقائيًا، في الزاوية السفلية اليمنى افتراضيًا.

التخصيص

من تهيئة المستقبِل:

• المظهر — العنوان المعروض، اللون الأساسي، الموضع (الزوايا الأربع)، شكل زرّ الإطلاق (تبويب أو فقاعة) وتسميته.
• النصوص — رسالة الترحيب، نصّ حقل الإدخال، نصّ الحالة (أو عرض «متّصل» مترجَمًا).
• العرض — عرض markdown في الردود (مفعّل افتراضيًا).
• سياق الصفحة — يُرسل مع كل رسالة أصل الصفحة الحالية ومسارها (وليس سلسلة الاستعلام أبدًا). مفعّل افتراضيًا، ويمكن تعطيله.
• النطاق — تقييد الأصول (origins) المسموح بها.

الأمان

الـtoken عام بحكم التصميم: لا يتيح سوى التحدّث إلى النموذج الذي يحمل هذا المستقبِل. وإذا أدرجت أصولًا مسموحًا بها، يُرفَض على جانب الخادم أي طلب آتٍ من أصل آخر (403)؛ أما القائمة الفارغة (أو *) فلا تفرض أي قيد — ويُستحسن قصرها على التطوير. ولإبطال رمز مميّز مخترَق: زرّ إعادة التوليد بجوار عنوان URL العام، في تهيئة المستقبِل (تتوقّف عندئذٍ كل المقتطفات المنشورة في الإنتاج عن العمل).

القيود

• لا يوجد تصفّح مشترك (co-browsing): لا يرى الوكيل صفحة المستخدم، بل أصلها ومسارها فقط (إذا كان سياق الصفحة مفعّلًا).
• لا يوجد إرسال للمرفقات من الأداة. ولاستقبال ملفات، استخدم pipeline بريد إلكتروني أو webhook.
• لا استئناف للمحادثة من زيارة إلى أخرى: إغلاق التبويب يُنهي المحادثة.