أداة الموقع
يشرح دليل أداة الموقع خطوات الإعداد، وهذه الصفحة هي المرجع الفني.
شيفرة التضمين
Section titled “شيفرة التضمين”<script src="https://api.backcrew.ai/v1/widget.js" data-widget-key="wk_…" async></script>حمّلها مرة واحدة في كل صفحة، قبل </body> مباشرة أو في القالب المشترك لموقعك.
| المنصة | موضع اللصق |
|---|---|
| HTML عادي | قبل </body> في كل صفحة |
| WordPress | إضافة لشيفرات الترويسة والتذييل، أو ملف footer.php في قالبك |
| Shopify | المتجر الإلكتروني ← القوالب ← تعديل الشيفرة ← theme.liquid، قبل </body> |
| Webflow وWix وSquarespace | إعداد الشيفرة المخصصة للموقع بالكامل، في التذييل |
| Google Tag Manager | وسم HTML مخصص على جميع الصفحات |
| React وNext.js وVue | قالب HTML الجذري، أو مكوّن السكربت في إطار عملك |
المواقع المسموح بها
Section titled “المواقع المسموح بها”يُفحص كل طلب وفق المواقع التي أدرجتها: يجب أن تطابق ترويسة Origin في المتصفح، وإلا رُفض الطلب حتى مع مفتاح صالح.
| ما تُدخله | ما يسمح به |
|---|---|
shop.example.com |
https://shop.example.com فقط |
*.example.com |
أي نطاق فرعي لـ example.com، دون النطاق نفسه |
http://localhost:8080 |
الاختبار المحلي، ويجب أن يطابق البروتوكول والمنفذ تمامًا |
لا يُسمح بالمسارات، فالأداة تعمل في جميع صفحات الموقع المسموح به.
الاختبار المحلي
Section titled “الاختبار المحلي”احفظ ملفًا يضم الشيفرة باسم index.html، وشغّل المجلد بالأمر python3 -m http.server 8080، وأضف http://localhost:8080 إلى المواقع المسموح بها ثم افتح ذلك العنوان. تُرفض دائمًا الصفحة المفتوحة مباشرة من القرص (file://).
حل المشكلات
Section titled “حل المشكلات”| المشكلة | الحل |
|---|---|
| لا تظهر الفقاعة | افتح وحدة تحكم المتصفح: يوضح سطر يبدأ بـ [backcrew] السبب، كأن يكون الموقع غير مسموح به أو الدردشة متوقفة أو المفتاح خاطئًا. |
تعمل على www دون النطاق المجرد |
هما موقعان مختلفان، فأدرج كليهما. |
| “هذا المساعد غير متاح حاليًا” | الوكيل غير منشور، أو نفدت أرصدة مساحة العمل. |
| “طلبات كثيرة جدًا” | تجيب الأداة عن 30 رسالة في الدقيقة كحد أقصى لجميع الزوار. |