أضف الشات بوت إلى موقعك
الشات بوت يُضاف إلى موقعك بسطر كود واحد. اختر المنصة التي يعمل عليها موقعك بالأسفل لتظهر لك الخطوات بالتفصيل. معظم التركيبات تستغرق حوالي خمس دقائق.
قبل أن تبدأ
أنت مسجّل الدخول. كل الأكواد في هذه الصفحة فيها مفتاحك الخاص بالفعل. استخدم أزرار نسخ، بدون أي تعديل.
- انسخ كود الويدجت. في لوحة تحكم ردّ، افتح الربط ← كود الويدجت واضغط نسخ الكود. يبدو هكذا، مع مفتاحك بدلاً من
pk_YOUR_KEY:أو انسخه من هنا مباشرة. هذا هو كودك:
انسخه دائماً من لوحة التحكم بدلاً من كتابته بيدك، حتى يكون المفتاح صحيحاً تماماً.<script src="https://agent.voxent.us/widget.js" data-key="pk_YOUR_KEY" async></script> - تأكد أن منصتك تسمح بإضافة كود. بعض المنصات تسمح بذلك في الباقات المدفوعة فقط. المتطلبات مكتوبة في أول قسم كل منصة بالأسفل.
- اختياري: النطاقات المسموح بها. لو قصرت الويدجت على مواقع معيّنة (كود الويدجت ← النطاقات المسموح بها في لوحة التحكم)، تأكد أن نطاق موقعك موجود في القائمة. اكتب النطاق بدون إضافات، مثل
example.com: هذا يشمل تلقائياًwww.example.comوأي نطاق فرعي آخر. أما كتابةwww.example.comفقط فلا تشملexample.com. عناوين المعاينة المؤقتة (مثلyoursite.webflow.io) تعتبر نطاقات منفصلة، لذلك يمكنك ترك الخانة فارغة أثناء التجربة.
اختر منصتك
اختر منصتك من الأعلى لتظهر لك الخطوات.
WordPress (ووردبريس)
المتطلبات: حساب مدير (Administrator) على ووردبريس. على WordPress.com تحتاج أيضاً باقة مدفوعة تسمح بالإضافات (لو لم تجد قائمة Plugins أو زر Install، راجع باقتك). ووردبريس المستضاف ذاتياً (WordPress.org) ليس عليه قيود باقات.
الطريقة أ: باستخدام إضافة (مُوصى بها، بدون برمجة)
- من لوحة ووردبريس، اذهب إلى Plugins ← Add New Plugin.
- ابحث عن WPCode (الاسم الكامل: “WPCode – Insert Headers and Footers + Custom Code Snippets”)، ثم اضغط Install Now ثم Activate.
- من القائمة الجانبية افتح Code Snippets ← Header & Footer.
- الصق كود الويدجت في خانة Footer.
- اضغط Save Changes.
نصيحة: لو فعّلت وضع “Headers & Footers mode” في WPCode، ستجد نفس الخانات في Settings ← Header & Footer.
الطريقة ب: من الكود (للمبرمجين)
أضف هذا إلى ملف functions.php في القالب الفرعي (child theme)، أو إلى إضافة أكواد. لا تعدّل ملفات القالب الأساسي مباشرة، لأن تحديثات القالب تمسح تعديلاتك.
add_action( 'wp_footer', function () {
echo '<script src="https://agent.voxent.us/widget.js" data-key="pk_YOUR_KEY" async></script>';
} );
لو لم يظهر الشات
- إضافات الكاش والتسريع (WP Rocket و LiteSpeed Cache و Autoptimize وأمثالها): امسح الكاش بعد الحفظ. ولو لم تظهر أيقونة الشات، استثنِ
agent.voxent.us/widget.jsمن خيارات ضغط ودمج وتأخير الجافاسكريبت. - نسختان: لو أضفت الكود بإضافة وفي القالب معاً، ستظهر أيقونتا شات. احتفظ بواحدة فقط.
الشرح الرسمي: WPCode — Header & Footer settings
Wix (ويكس)
المتطلبات: باقة Wix مدفوعة (Premium) مع نطاق مربوط، ويجب أن يكون موقعك منشوراً. إضافة الأكواد غير متاحة في مواقع Wix المجانية.
- افتح لوحة تحكم موقعك واذهب إلى Settings.
- اضغط Custom Code (تجدها تحت Advanced، أو تحت Development & integrations في اللوحات الأحدث).
- اضغط + Add Custom Code أعلى الصفحة.
- الصق كود الويدجت في الخانة وأعطه اسماً، مثل “Radd chat widget”.
- تحت Add Code to Pages اختر All pages، وتأكد أن Load code once مختار (وهو الافتراضي).
- تحت Place Code in اختر Body – end.
- اضغط Apply، ثم انشر موقعك.
انتبه: لا تختر “Load code on each new page”. مواقع Wix تنتقل بين الصفحات بدون إعادة تحميل، فهذا الخيار سيشغّل الويدجت مع كل صفحة وستظهر أيقونات شات مكررة.
انتبه: لا تستخدم عنصر “Embed HTML” أو iframe للويدجت، لأنه سيظهر داخل مربع في صفحة واحدة بدلاً من أن يطفو على كل الصفحات.
نصيحة: الأكواد لا تظهر داخل محرر Wix. افتح موقعك المنشور لترى أيقونة الشات.
الشرح الرسمي: Wix — Embedding custom code on your site · Custom code loading options
Shopify (شوبيفاي)
المتطلبات: إمكانية تعديل كود القالب. شوبيفاي يسمح بتعديل كود القالب بعد شرائه فقط (القوالب المجانية تعمل بدون مشكلة).
- من لوحة شوبيفاي اذهب إلى Online Store ← Themes.
- خذ نسخة احتياطية أولاً. بجانب قالبك الحالي افتح قائمة النقاط الثلاث (⋯) واختر Duplicate. شوبيفاي ينصح بذلك قبل تعديل أي كود.
- في قالبك الحالي افتح قائمة ⋯ مرة أخرى واختر Edit code.
- من قائمة الملفات افتح Layout ← theme.liquid.
- انزل لآخر الملف وابحث عن وسم الإغلاق
</body>. - الصق كود الويدجت في سطر جديد فوق
</body>مباشرة. - اضغط Save.
انتبه: الكود محفوظ داخل القالب. لو نشرت قالباً آخر لاحقاً (أو نسخة منه)، كرر هذه الخطوات له.
انتبه: صفحات الدفع في شوبيفاي منفصلة عن قالبك، لذلك غالباً لن تظهر أيقونة الشات فيها.
نصيحة: لو تستخدم النطاقات المسموح بها، أضف نطاق متجرك، وأضف أيضاً myshopify.com لو تجرّب على عنوان yourstore.myshopify.com.
الشرح الرسمي: Shopify Help Center — Editing theme code
Squarespace (سكوير سبيس)
المتطلبات: خاصية Code Injection تحتاج باقة Business أو أعلى، وغير متاحة في الباقة Personal. سكوير سبيس يغيّر باقاته من وقت لآخر، فلو لم تجد Code Injection راجع باقتك.
- سجّل الدخول إلى سكوير سبيس وافتح إعدادات موقعك.
- افتح Code Injection. مكانها يختلف حسب النسخة: Settings ← Advanced ← Code Injection، أو تحت Pages ← Custom Code (في قسم “Not Linked”).
- الصق كود الويدجت في خانة Footer، فهي تضيف الكود في آخر كل صفحة.
- اضغط Save.
انتبه: استخدم Code Injection وليس Code Block، لأن Code Block يضيف الويدجت لصفحة واحدة فقط.
نصيحة: سكوير سبيس يغيّر قوائمه كثيراً. لو لم تجد Code Injection، ابحث عن “code injection” في إعدادات موقعك أو في مركز المساعدة. ولو تستخدم النطاقات المسموح بها، تذكّر أن عنوان سكوير سبيس المدمج (المنتهي بـ squarespace.com) نطاق منفصل عن نطاقك.
المساعدة الرسمية: Squarespace Help Center (ابحث عن “code injection”)
Hostinger (هوستنجر)
هوستنجر شركة استضافة وأداة لبناء المواقع في نفس الوقت، لذلك تختلف الخطوات حسب طريقة عمل موقعك. اختر الحالة التي تناسبك.
أ: موقع مبني بـ Hostinger Website Builder
المتطلبات: أن تكون خاصية Custom code متاحة في باقتك. لو لم تجدها راجع باقتك.
- افتح موقعك في Hostinger Website Builder.
- اضغط قائمة النقاط الثلاث (⋯ More) واختر Integrations.
- ابحث عن Custom code وأضف كوداً جديداً.
- الصق كود الويدجت كما نسخته تماماً، واحفظ.
- اضغط Publish (أو Update website). هذه الخطوة ضرورية، فهي التي ترسل الكود الجديد إلى موقعك الفعلي.
نصيحة: الكود لا يظهر داخل المحرر. شاهده في وضع المعاينة أو على موقعك الفعلي.
ب: ووردبريس مستضاف على هوستنجر
سجّل الدخول إلى لوحة ووردبريس واتبع خطوات ووردبريس.
ج: موقع HTML عادي على استضافة هوستنجر
- من لوحة hPanel افتح Files ← File Manager لموقعك.
- افتح مجلد موقعك (غالباً
public_html). - عدّل ملف HTML لكل صفحة (أو القالب المشترك لو موقعك فيه قالب) والصق كود الويدجت قبل وسم الإغلاق
</body>مباشرة. - احفظ الملفات.
نصيحة: لو تستخدم النطاقات المسموح بها، أضف نطاقك. ولو تجرّب أيضاً على عنوان معاينة مؤقت من هوستنجر (ينتهي بـ hostingersite.com)، أضف hostingersite.com كذلك، أو اترك الخانة فارغة أثناء التجربة.
الشرح الرسمي: Hostinger — Website Builder: how to integrate custom code
Webflow (ويب فلو)
المتطلبات: باقة Webflow مدفوعة للموقع. الباقة المجانية Starter لا تسمح بإضافة أكواد.
- افتح مشروعك واذهب إلى Site settings.
- اضغط تبويب Custom code من القائمة الجانبية.
- الصق كود الويدجت في خانة Footer code (وهي منطقة “before </body> tag”).
- اضغط Save changes.
- انشر موقعك.
انتبه: الأكواد تعمل على الموقع المنشور فقط، وليس داخل الـ Designer. انشر على كل نطاق تستخدمه: عنوان التجربة (yoursite.webflow.io) ونطاقك الخاص يُنشران كلٌّ على حدة.
نصيحة: لو تستخدم النطاقات المسموح بها، أضف نطاقك. وللتجربة على عنوان التجربة أضف webflow.io أيضاً، أو اترك الخانة فارغة أثناء التجربة.
الشرح الرسمي: Webflow University — Site-level custom code
منصات أخرى
أي أداة لبناء المواقع أو نظام إدارة محتوى
تقريباً كل منصة فيها مكان لإضافة كود على مستوى الموقع كله. ابحث في إعدادات موقعك أو مشروعك عن أحد هذه الأسماء: Custom code أو Code injection أو Header and footer scripts أو Tracking code أو Embed code for all pages. الصق كود الويدجت هناك، في منطقة الفوتر / نهاية الـ body لو متاح الاختيار (منطقة الهيدر تعمل أيضاً)، واجعله يعمل على كل الصفحات، ثم احفظ وانشر. ولو لم تجده ابحث في مركز مساعدة منصتك عن “custom code” أو “code injection”.
موقع HTML عادي
افتح كل صفحة (أو القالب المشترك لو موجود) في محرر نصوص والصق كود الويدجت قبل وسم الإغلاق </body> مباشرة. احفظ وارفع الملفات.
Google Tag Manager
استخدم نسخة الجافاسكريبت هذه بدلاً من وسم السكريبت العادي. هي تحدد مفتاحك بشكل صريح، فلا تتأثر بطريقة إعادة Tag Manager لإدراج السكريبتات. استبدل pk_YOUR_KEY بمفتاحك.
<script>
(function () {
var s = document.createElement("script");
s.src = "https://agent.voxent.us/widget.js";
s.async = true;
s.setAttribute("data-key", "pk_YOUR_KEY");
document.head.appendChild(s);
})();
</script>
- في Tag Manager اذهب إلى Tags ← New واختر نوع الوسم Custom HTML.
- الصق الكود السابق.
- تحت Triggering اختر All Pages.
- احفظ، ثم اضغط Submit وانشر الحاوية.
نصيحة: على Wix استخدم خطوات Wix بدلاً من ذلك، لأن Wix يتعامل مع Tag Manager من خلال إعداداته التسويقية الخاصة.
React و Vue و Next.js وتطبيقات الويب الأخرى (للمبرمجين)
في التطبيقات التي لها ملف HTML واحد (Vite و Create React App و Vue CLI)، الصق وسم السكريبت العادي في index.html قبل </body> مباشرة. وفي Next.js استخدم مكوّن Script في الـ layout الرئيسي:
import Script from "next/script";
// In your root layout, inside <body>:
<Script
src="https://agent.voxent.us/widget.js"
data-key="pk_YOUR_KEY"
strategy="afterInteractive"
/>
سياسة أمان محتوى صارمة: لو موقعك يرسل ترويسة Content-Security-Policy، اسمح بـ https://agent.voxent.us في script-src و connect-src. وقد تحتاج أيضاً style-src 'unsafe-inline' (الويدجت يضيف أنماطه الخاصة) و img-src data: (شعارك مضمّن كصورة data).
أرسل هذه التعليمات لمطوّر موقعك
لو شخص آخر يدير موقعك، أرسل له هذه الرسالة. قبل الإرسال استبدل pk_YOUR_KEY بمفتاحك (أو الصق الكود كاملاً كما نسخته من لوحة التحكم).
مرحباً،
برجاء إضافة السكريبت التالي إلى كل صفحات موقعنا، قبل وسم الإغلاق </body> مباشرة (في القالب المشترك أو الفوتر، ليعمل على الموقع كله). هذا السكريبت يشغّل ويدجت الشات لخدمة العملاء.
<script src="https://agent.voxent.us/widget.js" data-key="pk_YOUR_KEY" async></script>
ملاحظات:
- برجاء استخدام الكود كما هو تماماً، فالمفتاح يحدد حسابنا.
- لو الموقع يرسل ترويسة Content-Security-Policy، برجاء السماح بـ https://agent.voxent.us في script-src و connect-src، مع الأنماط المضمّنة (style-src 'unsafe-inline') و img-src data: للشعار.
- برجاء التأكد من إضافته مرة واحدة فقط.
شكراً لك!
لا تستطيع إضافة أي كود لموقعك؟
استخدم رابط المحادثة المباشر بدلاً من ذلك. في لوحة التحكم افتح الربط ← رابط المحادثة المباشر، ثم أضفه إلى موقعك (أو إلى حساباتك على السوشيال ميديا ورسائلك) كرابط أو زر عادي، مثل “تحدث معنا”. لا يحتاج أي تركيب.
لو أيقونة الشات لم تظهر
- شاهد الموقع الفعلي. افتح موقعك المنشور في نافذة تصفح خفي (Incognito) واعمل تحديثاً كاملاً (Ctrl+Shift+R، أو Cmd+Shift+R على ماك). منصات كثيرة لا تشغّل الأكواد داخل المحرر أو المعاينة.
- انشر. معظم المنصات لا تطبّق الكود إلا بعد نشر الموقع أو تحديثه.
- راجع الكود الملصوق. يجب أن يكون كما نسخته من لوحة التحكم تماماً، بعلامات تنصيص مستقيمة (
") وليست مائلة (“ ”). ولو ظهر الكود كنص على صفحتك، فهو ملصوق في خانة نص أو محتوى بدلاً من خانة كود. - تأكد أنه على الموقع كله. يجب أن يعمل على كل الصفحات (الفوتر أو قالب الموقع أو إعدادات الموقع)، وليس على صفحة واحدة.
- راجع النطاقات المسموح بها. لو تقيّد النطاقات في لوحة التحكم، يجب أن يكون نطاق موقعك في القائمة. ولو لست متأكداً، فرّغ الخانة أثناء التجربة.
- امسح الكاش. امسح كاش إضافة التسريع في موقعك وأي CDN (مثل Cloudflare)، ثم حدّث الصفحة.
- تأكد أن السكريبت موجود في الصفحة. على موقعك الفعلي اضغط بالزر الأيمن ← View page source وابحث عن
widget.js. لو غير موجود، فالمنصة لم تضف الكود (مكان خطأ، أو لم يُنشر، أو قيد في الباقة). ولو موجود، افتح أدوات المطوّر في المتصفح ← تبويب Network وابحث عنwidget.js. - أيقونتان؟ الكود مضاف مرتين (مثلاً في الهيدر والفوتر معاً، أو من إضافتين). احذف نسخة منهما.
- الأيقونة ظاهرة لكن البوت لا يرد؟ راجع رصيد محفظتك في لوحة التحكم (البوت يتوقف عند نفاد الرصيد)، وتأكد أنك أضفت مصدر بيانات واحداً على الأقل.
ما زالت المشكلة موجودة؟ تواصل مع دعم Voxent وأخبرنا بعنوان موقعك والمنصة التي تستخدمها.
اختياري: غيّر جهة أيقونة الشات أو لونها
يمكنك إضافة إعدادين اختياريين إلى وسم السكريبت:
data-side="left"ينقل أيقونة الشات إلى الركن السفلي الأيسر (الافتراضي هو الركن السفلي الأيمن).data-color="#0A8F5B"يغيّر اللون الأساسي للويدجت (أيقونة الشات والروابط). استخدم أي لون بصيغة hex.
<script src="https://agent.voxent.us/widget.js" data-key="pk_YOUR_KEY"
data-side="left" data-color="#0A8F5B" async></script>
المنصات تغيّر قوائمها وباقاتها من وقت لآخر. راجعنا هذه التعليمات مع الشرح الرسمي لكل منصة في أكتوبر 2026. لو ظهرت لك قائمة مختلفة في حسابك، ابحث في مركز مساعدة منصتك عن “custom code” أو “code injection”.