Make Agent Fast hujjatlari

HTML va JavaScript

Suzuvchi agentni bitta ochiq skript bilan o‘rnating, sozlang, tekshiring va olib tashlang.

Qisqacha koʻrinish

Suzuvchi agentni bitta ochiq skript bilan o‘rnating, sozlang, tekshiring va olib tashlang.

Joylash yoʻliSaytingizdagi yuklagich joylashtirilgan agent muhiti bilan ishlaydi

Joylashtirish haqidaHTMLXavfsizlik va CSP

Saytni tayyorlash#

Agentning Joylashtirish bo‘limini ochib, joylashtirishni yoqing va agent ko‘rinadigan sahifaning yakuniy manzilini qo‘shing. Ishlab chiqish va ishlab chiqarish manzillarini alohida kiriting; http://localhost:3000, https://example.com va https://www.example.com bir-biriga mos kelmaydi.

Skriptni o‘rnatish#

Ishga tushiruvchi ko‘rinishi kerak bo‘lgan har bir sahifada yuklagichni yopuvchi </body> tegidan oldin joylang. Faqat ochiq sayt slugʼi va ixtiyoriy ko‘rinish qiymatlarini almashtiring.

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

data-agent majburiy. Slug ochiq maʼlumot; bu teg ichiga API kaliti kiritilmaydi. Boshqaruv paneli snippetidagi ?v=ni saqlang. Ixtiyoriy data-label, data-accent (#RGB / #RRGGBB), data-locale (en | ko | uz) va data-theme (light | dark) Embed haqidada. Ularni tashlasangiz, saqlangan koʻrinish va avtomatik mavzu meros olinadi.

Butun sayt yoki alohida sahifalarni tanlash#

Umumiy server shabloni uchun skriptni asosiy layout yoki footerga joylang. Faqat ayrim sahifalar uchun uni shu shablonlargagina qo‘shing. Bir hujjatda bir xil slugni bir marta yuklang; bir xil slugga ega takroriy teglar eʼtiborsiz qoldiriladi, ammo ularni olib tashlash egalik va tozalash jarayonini aniq qiladi.

Kod parchani <script> teglarini o‘chiradigan HTML tozalagich yoki boy matn maydoniga joylamang. Render qilingan sahifa manbasi yoki Elements panelida teg saqlanganini tekshiring.

SPA ichida olib tashlash yoki qayta ulash#

Skript ishlagandan keyin uni olib tashlash, u yaratgan ishga tushiruvchini o‘chirmaydi. Yo‘nalishga bog‘langan mijoz ilovasi qayta ulashdan oldin skript va slugga xos rootni birga olib tashlashi kerak:

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

Faol suhbat yo‘qolmasligi uchun mijoz tomondagi navigatsiya davomida bitta sayt miqyosidagi rootni ulangan holda saqlash maʼqul. Rootni olib tashlasangiz, uni qayta yaratish uchun yangi embed.js skriptini qo‘shing.

Brauzerda tekshirish#

Joylashtirilgan sahifani maxfiy oynada oching.
embed.js 200 javobini qaytarishi va CSP yoki rozilik sozlamasi tomonidan to‘silmaganini tekshiring.
Bitta [data-maf-embed="YOUR_SITE_SLUG"] root borligini tasdiqlang.
Ishga tushiruvchini ochib, /embed/YOUR_SITE_SLUG iframeʼi yuklanishini tekshiring.
Savol yuborib, Suhbatlar bo‘limida yozuv paydo bo‘lishini tasdiqlang.
Ovoz yoqilgan bo‘lsa, mobil kenglik va mikrofon ruxsatini sinang.

Muammolarni hal qilish#

Muammo	Yechim
Konsolda `data-agent` yo‘qligi haqida ogohlantirish	Atributni aynan `embed.js` tegiga qo‘ying
Skript bor, ammo ishga tushiruvchi yo‘q	Joylashtirish tugmasi, aniq manzil, CSP va rozilik holatini tekshiring
Faqat bitta host nomida ishlaydi	Har bir haqiqiy protokol/host/portni ruxsat etilganlar ro‘yxatiga qo‘shing
Uslub kutilganidan farq qiladi	`data-accent`, `data-theme` va saqlangan sayt ko‘rinishini tekshiring
Iframe ichida ovoz ishlamaydi	Brauzer va host Permissions Policyʼda mikrofonga ruxsat bering

Yuklagichni proksi orqali o‘tkazmang yoki tekshirilmagan mahalliy nusxaga ko‘chirmang; manzil tekshiruvi va tuzatishlar yangilanib turishi uchun joylashtirilgan skriptdan foydalaning.