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

Tilda

ثبّت الودجت باستخدام حقن أكواد HTML على مستوى الموقع في Tilda، ثم أعد نشر الصفحات.

نظرة سريعة

ثبّت الودجت باستخدام حقن أكواد HTML على مستوى الموقع في Tilda، ثم أعد نشر الصفحات.

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

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

إضافة المُحمِّل (loader)#

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

إذا لم تجد هذا الإعداد، فالصق الشيفرة في كتلة التذييل (footer) الخاصة بالقالب بدلًا من ذلك. تضيف كتلة HTML في Tilda زر الودجت إلى الصفحة الوحيدة التي تحتويها، وهذه أيضًا هي الطريقة المناسبة لقصر ظهور الـ agent على صفحة هبوط واحدة.

التحقق#

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

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

العَرَضالسبب المحتملالحل
يظهر زر الودجت في المحرر ولا يظهر في الصفحة المنشورةلم تتم إعادة نشر الصفحات بعد حفظ الكود على مستوى الموقعأعد نشر كل صفحة يجب أن يظهر عليها الزر
يتم تحميل الزر لكن إطار الدردشة يرفض الفتحالـ origin المنشور غير مضاف إلى القائمة المسموح بها، أو أن التضمين معطّلأضف الـ origin المنشور بالضبط، وأعد التحقق من خيار إظهاره على موقعي
تظهر الشيفرة في صفحة واحدة فقطتمت إضافتها عبر كتلة HTML على مستوى الصفحةانقلها إلى حقل الحقن في head على مستوى الموقع

قد تؤخّر خيارات الموافقة على ملفات تعريف الارتباط وسرعة الصفحة في Tilda تحميل السكربتات الخارجية. إذا كان تقييد التحميل بالموافقة مفعّلًا، فحمّل الـ embed ضمن الفئة التي تخصصها سياستك له، وراجع الأمان وCSP لمعرفة الـ origins التي يجب السماح بها.