الانتقال إلى محتوى الصفحة
الوثائق
وثائق Make Agent Fast

Cafe24

ثبّت الودجت بتعديل كود HTML الخاص بتخطيط واجهة المتجر في محرر التصميم في Cafe24.

نظرة سريعة

ثبّت الودجت بتعديل كود HTML الخاص بتخطيط واجهة المتجر في محرر التصميم في Cafe24.

مسار تثبيت التضمينيتواصل المحمّل على موقعك مع بيئة تشغيل الوكيل المستضافة
موقعك الإلكترونيHTML / appسكربت التحميلembed.jsواجهة الودجتمحادثة / صوتالوكيل

Cafe24 (카페24) منصة تجارة إلكترونية كورية يتم فيها تعديل تصميم واجهة المتجر عبر HTML. ثبّت أيقونة التشغيل في التخطيط المشترك للتصميم الذي تستخدمه فعليًا. لا يوجد حاليًا تطبيق Make Agent Fast في متجر تطبيقات Cafe24. أسماء القوائم الواردة هنا صحيحة حتى 2026-09؛ وإذا تغيّر موضع أي عنصر أو اسمه، فابحث عن الإعداد بحسب وظيفته لا بحسب مساره الدقيق.

إضافة المحمِّل#

  1. في لوحة تحكم Make Agent Fast، افتح انشره الآن ← ودجت الموقع في صفحة الوكيل، وفعّل إظهاره على موقعي، ثم أضف إلى عناوين المواقع المسموح بها كل مصدر (origin) خاص بواجهة المتجر — أي عنوان المتجر على cafe24.com ونطاقك المخصص، إضافةً إلى عنوان الجوال إذا كان مختلفًا.
  2. افتح إدارة التصميم وابدأ تحرير HTML للتصميم المنشور حاليًا. انسخ التصميم أو احتفظ بنسخة احتياطية منه أولًا، فأنت تعدّل الكود المصدري لواجهة المتجر.
  3. في ملف التخطيط المشترك الذي تتضمنه كل الصفحات، الصق المقتطف البرمجي الذي تم إنشاؤه قبل وسم الإغلاق </body> مباشرةً.
  4. احفظ، ثم طبّق التصميم على واجهة المتجر، وكرر الخطوات لتصميم الجوال إذا كان متجرك يحتفظ بتصميمي الكمبيوتر والجوال بشكل منفصل.
<script src="https://makeagent.fast/embed.js?v=20261022-open"
        data-agent="YOUR_SITE_SLUG"
        async></script>

إذا لم تعثر على ملف التخطيط، فالصق المقتطف في كتلة التذييل (footer) الخاصة بالقالب بدلًا من ذلك — يصلح أي مكوّن يظهر في كل الصفحات، بشرط أن يتم تضمينه مرة واحدة فقط.

التحقق#

  1. افتح واجهة المتجر في نافذة خاصة، على عنوان الكمبيوتر وعنوان الجوال معًا.
  2. تأكد من أن المصدر (origin) الظاهر في شريط العنوان هو الذي أضفته إلى القائمة المسموح بها، بما في ذلك www إذا كان النطاق يعيد التوجيه إليه.
  3. تأكد من أن embed.js يعيد الرمز 200 في لوحة Network، وأن عنصرًا واحدًا فقط من النوع data-maf-embed="YOUR_SITE_SLUG" موجود.
  4. اطرح سؤالًا واقعيًا وتأكد من ظهور الرسالة في المحادثات.

استكشاف الأخطاء وإصلاحها#

العَرَضالسبب المحتملالحل
يعمل على الكمبيوتر ولا يعمل على الجوالتصميم الجوال له ملف تخطيط خاص بهأضف المقتطف إلى تصميم الجوال أيضًا
اختفت أيقونة التشغيل بعد تغيير التصميمتم تطبيق تصميم لا يحتوي على المقتطفأعد إضافته إلى تخطيط التصميم المعروض حاليًا في المتجر
تغطي أيقونة التشغيل سلة التسوق أو شريطًا سفليًا ثابتًاعنصران ثابتان يشغلان الزاوية نفسهاغيّر زاوية أيقونة التشغيل باستخدام data-position

لا تضع مفتاح API أو رقم طلب أو بيانات العملاء في أي سمة data-*. يتناول دليل الأمان وCSP إعداد قائمة العناوين المسموح بها وسياسة أمان المحتوى (Content Security Policy) للمتاجر التي تفرضها.