ثبّت على أي موقع

يعمل ودجت UCrew على أي موقع، بغض النظر عن المنصة أو الـ framework. انسخ كودًا واحدًا والصقه قبل وسم الإغلاق </body> .

الكود الموحد

انسخ الكود أدناه والصقه في الـ HTML الخاص بك، قبل </body>:

HTML — paste before </body>

<!-- UCrew Chat Widget -->
<script>
  (function() {
    var s = document.createElement('script');
    s.src = 'https://ucrew.ai/widget/v1.js';
    s.setAttribute('data-project-id', 'YOUR_PROJECT_ID');
    s.async = true;
    document.head.appendChild(s);
  })();
</script>

استبدل YOUR_PROJECT_ID بالـ ID من لوحة تحكم UCrew ← إعدادات المشروع ← تبويب الودجت.

خيارات التخصيص الكاملة

خصّص باستخدام data attributes على وسم السكريبت:

html (with all options)

<script
  src="https://ucrew.ai/widget/v1.js"
  data-project-id="YOUR_PROJECT_ID"
  data-position="bottom-right"
  data-theme="dark"
  data-primary-color="#004741"
  data-greeting="Hi! How can I help? 👋"
  data-bot-name="Aria"
  data-open-delay="3000"
  async>
</script>

الخاصية	الافتراضي	القيم
data-position	bottom-right	bottom-right \| bottom-left
data-theme	dark	dark \| light \| auto
data-primary-color	#004741	أي لون hex (#RRGGBB)
data-greeting	Hello!	النص الذي يظهر عند فتح الودجت
data-bot-name	AI Assistant	الاسم في رأس نافذة المحادثة
data-open-delay	0	تأخير الفتح التلقائي بالميلي ثانية (0 = معطّل)
data-hide-on-mobile	false	true \| false

React / Next.js

في تطبيق React أو Next.js، استخدم مكوّن Script أو useEffect لتحميل الودجت:

Next.js (app/layout.tsx)

import Script from 'next/script';

export default function RootLayout({ children }) {
  return (
    <html>
      <body>
        {children}
        <Script
          src="https://ucrew.ai/widget/v1.js"
          data-project-id="YOUR_PROJECT_ID"
          strategy="lazyOnload"
        />
      </body>
    </html>
  );
}

استخدم strategy="lazyOnload" لتحميل الودجت بعد جهوزية الصفحة — فهذا يحافظ على سرعة تطبيقك.

أفضل الممارسات

ضع السكريبت دائمًا قبل </body> — لا في <head> — حتى لا يعطّل رسم الصفحة
تضمن خاصية async تحميل الودجت في الخلفية دون إبطاء موقعك
اختبر على سطح المكتب والهاتف بعد التثبيت
استخدم data-hide-on-mobile="true" إذا أردت الودجت على سطح المكتب فقط

Squarespace العودة إلى صفحة التوثيق الرئيسية