🌐 أداة الدردشة عبر الويب
أداة الدردشة عبر الويب هي فقاعة دردشة JavaScript قابلة للتضمين يمكن إضافتها إلى أي موقع إلكتروني. عندما يرسل الزوار رسالة عبر الأداة، تظهر في صندوق الوارد الخاص بـ PulseHub مثل أي قناة أخرى.
إضافة الأداة إلى موقعك
1. إضافة قناة دردشة ويب في PulseHub
- انتقل إلى Channels → Add Channel
- اختر Web Chat Widget
- أدخل اسمًا ورسالة ترحيب/لون اختياري
- انقر على Save Channel
- لاحظ Channel ID من البطاقة
2. تضمين السكريبت
<script
src="https://yourdomain.com/public/js/webchat-widget.js"
data-channel="YOUR_CHANNEL_ID"
data-greeting="Hi! How can we help you today?"
data-color="#10b981">
</script>
خيارات تكوين الأداة
| السمة | القيمة الافتراضية | الوصف |
|---|---|---|
data-channel | مطلوب | معرف UUID للقناة من PulseHub |
data-greeting | Hi! How can we help you? | الرسالة المعروضة عند فتح الدردشة لأول مرة |
data-color | #10b981 | لون سداسي عشري للزر والرسائل المرسلة |
كيف تعمل الجلسات
تخزّن الأداة قيمتين في localStorage:
ph_contact_{channel_id}— معرف UUID لجهة الاتصالph_conv_{channel_id}— معرف UUID للمحادثة
هذا يعني أن الزوار الذين يغلقون علامة التبويب ويعودون يستمرون في نفس المحادثة.
طلبات Cross-Origin
إذا كان PulseHub على نطاق مختلف عن موقعك، أضف رؤوس CORS:
<IfModule mod_headers.c>
Header set Access-Control-Allow-Origin "https://yourwebsite.com"
Header set Access-Control-Allow-Methods "GET, POST, PATCH, DELETE, OPTIONS"
Header set Access-Control-Allow-Headers "Content-Type, X-Webchat-Channel"
</IfModule>
ملاحظة أمنية
تقبل نقاط نهاية API للدردشة عبر الويب طلبات من المستخدمين غير المصادق عليهم عندما يكون رأس X-Webchat-Channel موجودًا. تأكد من تحديد المعدل على مستوى خادم الويب أو جدار الحماية.