أداة الدردشة لا تظهر أو لا تتصل
عالج أبرز مشكلات أداة دردشة راية: عدم ظهور الأداة على موقعك، أو توقفها عند «جارٍ الاتصال...»، أو حظرها بسبب مانعات الإعلانات وسياسات CSP.
أبرز مشكلات الأداة وحلولها السريعة
يوضّح الجدول التالي أكثر مشكلات أداة الدردشة شيوعًا وأسبابها المحتملة وأسرع حل لكل منها.
| المشكلة الظاهرة | السبب المحتمل | الحل السريع |
|---|---|---|
| الأداة لا تظهر نهائيًا | كود التضمين مفقود أو موضوع في موضع خاطئ | الصق الكود مباشرةً قبل وسم الإغلاق </body> |
| تظهر الأداة محليًا ولا تظهر على الموقع المنشور | نطاق الموقع الفعلي غير مدرج في النطاقات المسموحة | أضف نطاق موقعك الفعلي في إعدادات الأداة |
| تظهر الأداة ثم تختفي بعد ثوانٍ | نفاد الرصيد يوقف راية مؤقتًا | اشحن رصيدك أو رقِّ خطتك |
| الأداة مخفية في متصفحات معينة | مانع إعلانات أو إضافة خصوصية تحجب الكود | اختبر الموقع في نافذة التصفح المتخفي مع تعطيل الإضافات |
| الأداة عالقة عند «جارٍ الاتصال...» | الشبكة أو ترويسات CSP تحجب اتصال WebSocket | اسمح بالنطاق *.teammates.ai ضمن توجيه connect-src في سياسة CSP |
الأداة لا تظهر على موقعك
إذا لم تظهر أداة دردشة راية على موقعك، اتبع هذه الخطوات بالترتيب؛ إذ تُحل معظم الحالات عند الخطوة الأولى أو الثانية.
- 1
تأكد من تركيب كود التضمين
افتح موقعك وانقر بزر الفأرة الأيمن واختر «عرض مصدر الصفحة»، ثم ابحث عن «teammates». يفترض أن يظهر لك وسم <script> يتضمن معرّف الأداة؛ وإن لم تجده، انسخ الكود من راية > الإعدادات > الدردشة والصقه قبل </body>.
- 2
تحقّق من النطاقات المسموحة
افتح راية > الإعدادات > الدردشة وتأكد من إدراج نطاق موقعك ضمن «النطاقات المسموحة»، وأضف الصيغتين مع www وبدونها عند الحاجة (مثل example.com وwww.example.com).
- 3
تحقّق من رصيدك المتاح
تتوقف راية مؤقتًا عند وصول الرصيد إلى الصفر. افتح إعدادات المؤسسة > الفوترة وتأكد من توفر رصيد كافٍ؛ علمًا بأن الخطة المجانية تمنحك 5 أرصدة ترحيبية لمرة واحدة.
- 4
جرّب في نافذة التصفح المتخفي
افتح موقعك في نافذة تصفح متخفٍ مع تعطيل جميع إضافات المتصفح؛ فإذا ظهرت الأداة، فهذا يعني أن مانع إعلانات أو إضافة خصوصية في متصفحك العادي يحجبها.
- 5
راجع قواعد الإظهار والإخفاء للصفحات
راجع قواعد الإظهار والإخفاء داخل إعدادات الأداة؛ فإذا خصّصت ظهور الأداة لصفحات بعينها، تأكد من مطابقة الصفحة الحالية لتلك القواعد.
الأداة عالقة عند «جارٍ الاتصال...»
إذا ظهرت الأداة لكنها بقيت معلّقة على «جارٍ الاتصال...» دون بدء المحادثة، فالسبب غالبًا في إعدادات الشبكة؛ اتبع الخطوات التالية:
- 1
راجع سياسة أمان المحتوى (CSP)
إذا كان موقعك يطبّق ترويسات CSP، أضف *.teammates.ai إلى توجيهَي connect-src وscript-src؛ فبدونهما يحجب المتصفح اتصال WebSocket اللازم لتشغيل راية.
- 2
تأكد من تفعيل راية
افتح صفحة راية وتأكد أن حالتها «نشطة»؛ فإذا كانت معطّلة أو متوقفة مؤقتًا فلن تتصل الأداة.
- 3
اختبر الاتصال من شبكة أخرى
تحجب بعض جدران الحماية في الشبكات المكتبية اتصالات WebSocket. جرّب فتح الصفحة عبر نقطة اتصال الهاتف أو شبكة أخرى؛ فإذا عملت الأداة، اطلب من فريق تقنية المعلومات لديك السماح بحركة HTTPS وWebSocket الصادرة إلى *.teammates.ai.
- 4
افحص سجل أخطاء المتصفح (Console)
افتح أدوات المطور (F12) وانتقل إلى تبويب Console لرصد أي رسائل خطأ حمراء، مثل «Refused to connect» (بسبب سياسة CSP) أو «WebSocket connection failed» (بسبب الشبكة)، وشاركها مع فريق الدعم عند الحاجة.
طلب مساعدة إضافية
إذا لم تحل الخطوات السابقة مشكلة الأداة، اسأل راية من نافذة الدعم في مركز المساعدة أو راسل فريق الدعم على support@teammates.ai، وأرفق لقطة شاشة لأخطاء Console ومعرّف الأداة ورابط الصفحة التي تظهر فيها المشكلة.
الأسئلة الشائعة
هل تبطّئ أداة دردشة راية سرعة موقعي؟
هل يمكنني تركيب الأداة نفسها على أكثر من موقع؟
لماذا تظهر أداة راية عندي ولا تظهر لزوّار موقعي؟
أدلة ذات صلة
هل كان هذا المقال مفيدًا؟

تحتاج مساعدة إضافية؟
اسألنا أي شيء بأي لغة. راية (الدعم) وآدم (المبيعات) يجيبانك على مدار الساعة بأكثر من 54 لغة و19 لهجة عربية.
