HTML وJavaScript

تجهيز الموقع#

في صفحة الوكيل الخاصة بالوكيل، افتح اجعله متاحًا للجمهور ← أداة الموقع، ثم فعّل إظهاره على موقعي، وأضف أصل الصفحة المضيفة النهائي ضمن عناوين المواقع المسموح بها. أضف بيئة التطوير وبيئة الإنتاج كلًّا على حدة؛ فالعناوين http://localhost:3000 وhttps://example.com وhttps://www.example.com لا تتطابق مع بعضها.

تثبيت السكربت#

الصق المُحمِّل (loader) قبل وسم الإغلاق </body> مباشرةً في كل صفحة يجب أن يظهر فيها زر الفتح. استبدل فقط المعرّف العام للموقع (slug) وقيم العرض الاختيارية.

<script
  src="https://makeagent.fast/embed.js?v=20261022-open"
  data-agent="YOUR_SITE_SLUG"
  data-position="right"
  async
></script>

السمة data-agent مطلوبة. المعرّف عام، ولا يجوز وضع أي مفتاح API في هذا الوسم. أبقِ معامل الاستعلام ?v= كما هو في المقتطف الظاهر في لوحة التحكم. السمات الاختيارية data-label وdata-accent (#RGB / #RRGGBB) وdata-locale (en | ko | uz | ru) وdata-theme (light | dark) موثّقة في نظرة عامة على التضمين. احذفها ليرث الوكيل إعدادات العرض المحفوظة وسلوك السمة التلقائي.

اختيار التثبيت على مستوى الموقع أو على صفحات محددة#

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

لا تلصق المقتطف داخل مُنقّي HTML أو حقل نص منسّق يزيل الوسم <script>. تأكد من أن مصدر الصفحة المعروضة أو لوحة العناصر (Elements) ما زال يحتوي على الوسم.

الإزالة أو إعادة التركيب في تطبيق SPA#

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

const slug = "YOUR_SITE_SLUG";
document.getElementById("maf-agent")?.remove();
document.getElementById(`maf-embed-root-${slug}`)?.remove();

يُفضّل إبقاء عنصر جذر واحد على مستوى الموقع مركّبًا أثناء التنقل من جهة العميل حتى لا تُفقد المحادثة الجارية. وإذا أزلت العنصر الجذر، فأضف سكربت embed.js جديدًا لإنشائه من جديد.

التحقق في المتصفح#

1. افتح الصفحة المنشورة في نافذة خاصة.
2. تأكد من أن embed.js يُرجع الحالة 200 وأنه غير محظور بسبب CSP أو الموافقة.
3. تأكد من وجود عنصر جذر واحد فقط [data-maf-embed="YOUR_SITE_SLUG"].
4. افتح زر الفتح وتأكد من تحميل iframe على المسار /embed/YOUR_SITE_SLUG.
5. أرسل سؤالًا وتأكد من ظهور المحادثة في المحادثات.
6. اختبر العرض على عرض شاشة الجوال، واختبر إذن الميكروفون عند تفعيل الصوت.

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

لا تستخدم وكيلًا وسيطًا (proxy) للمُحمِّل ولا تنسخه إلى نسخة محلية معدّلة لم تُراجَع؛ استخدم السكربت المستضاف ليبقى التحقق من الأصل والإصلاحات محدّثة دائمًا.