Commerce Agentsقاعدة المعرفة
العربية
РусскийEnglishDeutschFrançaisEspañolPortuguêsItalianoNederlandsPolskiУкраїнськаČeštinaSlovenčinaSlovenščinaHrvatskiСрпскиБългарскиRomânăMagyarΕλληνικάSvenskaNorskDanskSuomiLatviešuLietuviųEestiTürkçeالعربيةעברית中文
الخطط إلى لوحة التحكم
قاعدة المعرفة → دليل الاستخدام

الودجت على الموقع، ورابط الوكيل، وتطبيق الهاتف

كيفية إضافة الوكيل إلى موقعك بسطر واحد من التعليمات البرمجية، وكيف يعمل الرابط المختصر لوسائل التواصل الاجتماعي وتطبيقات المراسلة، وكيف يقوم المشتري بتثبيت وكيلك كتطبيق على هاتفه.

6 سبتمبر 2026

الوكيل له وجهان. على الموقع الإلكتروني، يظهر كنافذة في الزاوية تُفتح بضغطة زر. أما في وسائل التواصل الاجتماعي وتطبيقات المراسلة، فهو صفحة برابط قصير تعمل كمتجر صغير ويمكن تثبيتها على الهاتف كتطبيق. مع ذلك، يبقى الكتالوج والشروط والمحادثات والطلبات موحدة: الوكيل واحد.

كل ما هو موصوف أدناه موجود في قسم «الودجت والرابط».

رابط الوكيل#

عنوان قصير بالشكل comag.vibevox.pro/c/your-shop. يُوضع في رأس ملف التعريف على Instagram أو TikTok أو Telegram، ويُرسل عبر WhatsApp، ويُضاف إلى الوصف أسفل الفيديو على YouTube.

عند إرسال الرابط في تطبيق مراسلة، يتحول إلى بطاقة تتضمن: غلاف، اسم المتجر، ووصف. يمكن تخصيص هذه الحقول الثلاثة:

أسهل طريقة للتحقق من شكل المعاينة هي إرسال الرابط لنفسك عبر Telegram.

كود للموقع#

سطر واحد يُضاف قبل وسم الإغلاق </body> في جميع الصفحات. يمكن نسخه بزر في لوحة التحكم.

أين يتم الإدراج بالضبط على المنصات الشائعة:

المنصةمكان الإدراج
Tildaإعدادات الموقع → المزيد → كود HTML للجسم
Shopifyالمظهر → تعديل الكود → theme.liquid، قبل </body>
WordPressالمظهر → محرر القوالب → footer.php، أو إضافة إدراج الكود
Wixالإعدادات → كود مخصص → إضافة في نهاية الجسم
موقعك الخاصمباشرة في القالب قبل </body>

بعد الإدراج، ستظهر أيقونة في الزاوية السفلية اليمنى. يمكن تغيير موضعها إلى اليسار في الإعدادات، وكذلك اللون والمظهر.

يتم تحميل الودجت بشكل غير متزامن ولا يبطئ الصفحة. إذا كان لديك CSP صارم، اسمح بالنطاق comag.vibevox.pro في script-src و connect-src.

المظهر#

الإعدادات التي يراها المشتري:

يوجد معاينة حية على اليمين: تتغير بينما تكتب. زر «حفظ» ينقل التغييرات إلى الموقع.

المظهر الفاتح والداكن#

للدردشة مظهران، ويتم التبديل بينهما في حقل إعدادات واحد — «المظهر».

القيمةما يراه المشتري
حسب إعدادات الزائريتكيف المظهر مع إعدادات هاتفه أو جهاز الكمبيوتر: داكن ليلاً، فاتح نهارًا
فاتحنافذة فاتحة دائمًا، بغض النظر عن الجهاز
داكننافذة داكنة دائمًا

الخيار الافتراضي هو «حسب إعدادات الزائر»، وفي معظم الحالات هذا هو الخيار الصحيح: الشخص الذي يستخدم المظهر الداكن على هاتفه لن يتلقى وميضًا أبيض في وجهه، ومن اعتاد على المظهر الفاتح سيرى نافذة مألوفة.

المظهر الثابت مطلوب عندما يكون الموقع نفسه مصممًا بأسلوب واحد. صفحة هبوط داكنة مع دردشة فاتحة في الزاوية تبدو كبقعة، والعكس صحيح. في هذه الحالة، اختر نفس مظهر الموقع، وسيندمج الودجت مع التصميم.

يعمل اللون المميز فوق كلا المظهرين: تأخذ الأزرار والروابط وإبراز البطاقات لون علامتك التجارية، بينما يتغير الخلفية والنص مع المظهر. أسهل طريقة للتحقق من كلا الخيارين هي في المعاينة على اليمين — فهي تتجدد فورًا بينما تقوم بتبديل القيمة.

بطاقات المنتجات تقود إلى موقعك#

لا يرد الوكيل بنص متواصل، بل ببطاقات: صورة، اسم، سعر، زر. خلف الزر يوجد دائمًا عنوان — صفحة المنتج على موقعك أو المنشور الأصلي في الشبكة الاجتماعية، إذا كانت البطاقة مجمعة من هناك.

داخل الودجت على الموقع، يتم الانتقال في نفس النافذة لتجنب كثرة علامات التبويب. أما على صفحة الوكيل عبر الرابط، فتُفتح البطاقة في علامة تبويب جديدة لضمان عدم فقدان المحادثة.

بالنسبة للمتاجر على Shopify و WooCommerce، هناك تفصيل لطيف: الزر لا يفتح المنتج فحسب، بل يضعه في سلة تسوق المتجر باستخدام الآلية القياسية للمنصة. التفاصيل في المقالات حول Shopify و WordPress.

وأيضًا: يقرأ الودجت ترميز المنتج على الصفحة التي فُتح فيها، وينقله إلى الوكيل. لذلك، يُفهم سؤال «هل يتوفر باللون الأزرق؟» على بطاقة المنتج في سياقه، دون الحاجة لتوضيح ما هو المقصود.

تطبيق على هاتف المشتري#

يمكن لصفحة الوكيل أن تُثبت كتطبيق. يفتح المشتري الرابط من الهاتف، ويرى اقتراحًا لإضافته إلى الشاشة الرئيسية، ويحصل على أيقونة بشعارك.

بعد التثبيت، يمكن إرسال إشعارات push للمشتري من قسم «المحادثات». يمنح هو الإذن بذلك بنفسه، بالضغط على أيقونة الجرس في رأس الدردشة.

المرفقات من المشتري#

يوجد في الدردشة أيقونة مشبك: للصور أو الفيديو أو الصوت حتى 20 ميجابايت. إذا لم يكن هناك تعرف على الكلام في المتصفح، فإن الضغط المطول على الميكروفون يسجل رسالة صوتية.

يقوم Gemini بتحليل الملف: ما هو معروض، ما هو النص الموجود في الصورة، وما قيل بصوت عالٍ. يرد الوكيل بناءً على هذا التحليل، وترى في المحادثة الملف نفسه ووصفًا موجزًا له. هذا مفيد في المجالات التي يكون فيها العرض أسهل من الوصف: قطع الغيار، الإصلاح، الاختيار بالصور.

بكسل الشراء للموقع المزود بسلة تسوق#

إذا كانت عملية الدفع تتم على موقعك، وليس في الدردشة، فأدخل جزءًا قصيرًا من لوحة التحكم في صفحة «شكرًا على طلبك»، مع إدخال رقم الطلب والمبلغ. سترتبط عملية الشراء بالمحادثة، وستظهر في الإحصائيات المحادثات التي تنتهي ببيع.

تحقق#

ثلاث دقائق تستحق أن تقضيها بعد الإعداد:

  1. افتح الموقع في وضع التصفح المتخفي واضغط على زر الودجت. اطرح سؤالاً عن المنتج.
  2. افتح رابط العميل من الهاتف. تأكد من عرض خيار التثبيت.
  3. أرسل الرابط لنفسك في تطبيق المراسلة واطلع على المعاينة.
  4. اطلع على «المحادثات»: يجب أن تظهر كلتا المحادثتين هناك.

أسئلة متكررة#

هل الودجت على الموقع والرابط عميلان مختلفان؟#

إنهما واحد. الكتالوج والشروط والمحادثات والطلبات مشتركة. يختلف التصميم فقط: على الموقع يظهر كنافذة في الزاوية، أما عبر الرابط فيظهر كصفحة بملء الشاشة يمكن تثبيتها على الهاتف.

هل يمكن تغيير عنوان الرابط؟#

يتكون العنوان من اسم المتجر عند إنشاء الواجهة. إذا كنت بحاجة إلى عنوان مختلف، راسلنا على Telegram — سنقوم بتغييره يدوياً لتجنب تعطيل الروابط المنشورة بالفعل.

هل سيُبطئ الودجت الموقع؟#

لا. السكربت خفيف ويتم تحميله بشكل غير متزامن بعد المحتوى الرئيسي للصفحة. نافذة الدردشة نفسها لا تُحمّل إلا عندما يضغط المشتري على الزر.

ماذا يرى المشتري إذا كان العميل متوقفاً؟#

لا شيء: الزر لا يظهر، والصفحة عبر الرابط تُظهر أن العميل غير متاح. مفتاح التشغيل/الإيقاف موجود في قسم «الودجت والرابط».

كيف يمكن إزالة عبارة «يعمل بواسطة Commerce Agents»؟#

لا يمكن ذلك حالياً: التوقيع يبقى على جميع الباقات. العبارة قابلة للنقر وتؤدي إلى موقعنا — هذا جزء من السعر، وبفضله تبلغ تكلفة الخدمة 29 € بدلاً من مبلغ أكبر بكثير.

وكيل تجريبي