مستندات

مستندات

چگونه فلش ای‌آی را با وب‌سایت خود ادغام کنید

شروع سریع

افزودن فلش ای‌آی به وب‌سایت شما فقط 3 مرحله طول می‌کشد.

1

بات خود را سفارش دهید

به flashai.pl بروید، روی "سفارش" کلیک کنید و دستیار هوش مصنوعی خود را پیکربندی کنید — نام، شخصیت، پایگاه دانش.

2

کد را کپی کنید

یک خط به وب‌سایت خود اضافه کنید، فقط قبل از تگ بسته شدن </body>:

HTML
<script src="https://flashai.pl/widget.js" data-ai="TWOJE_BOT_ID"></script>

انجام شد!

ویجت چت در گوشه پایین راست وب‌سایت شما ظاهر خواهد شد. دستیار هوش مصنوعی شما آماده صحبت با بازدیدکنندگان است.

پیکربندی ویجت

رفتار ویجت را با استفاده از ویژگی‌های HTML در تگ اسکریپت شخصی‌سازی کنید.

ویژگی توضیحات
data-ai (ضروری) شناسه بات شما
data-name نام نمایشی در هدر چت
data-color رنگ برجسته (هکس)
data-auto-open باز شدن خودکار چت در هنگام بارگذاری صفحه
data-fullscreen حالت تمام صفحه
data-lang زبان رابط کاربری اجباری

مثال کامل

HTML
<script src="https://flashai.pl/widget.js"
  data-ai="twoje_bot_id"
  data-name="Asystent Sklepu"
  data-color="#ff6b00"
  data-auto-open="true"></script>

API جاوا اسکریپت

ویجت را به صورت برنامه‌نویسی از کد وب‌سایت خود کنترل کنید.

متد توضیحات
FlashAI.open() پنجره چت را باز می‌کند
FlashAI.close() پنجره چت را می‌بندد
FlashAI.toggle() وضعیت چت را باز/بسته تغییر می‌دهد
FlashAI.send("text") پیام را فوراً ارسال می‌کند
FlashAI.setInput("text") متن ورودی را بدون ارسال تنظیم می‌کند
FlashAI.isOpen بررسی می‌کند که آیا چت باز است یا خیر

مثال‌های استفاده

HTML
<!-- Button that opens the chat -->
<button onclick="FlashAI.open()">Chat with us</button>

<!-- Button that sends a specific question -->
<button onclick="FlashAI.send('I want to book an appointment')">Book now</button>

<!-- Link that pre-fills the input -->
<a href="#" onclick="FlashAI.open().setInput('Pricing')">Ask about pricing</a>

باز کردن چت از طریق لینک

#flashai-open را به هر URL اضافه کنید و چت به طور خودکار باز می‌شود. عالی برای کدهای QR، لینک‌های ایمیل یا دکمه‌ها.

URL
https://your-website.com/#flashai-open

پیکربندی پیشرفته

برای کنترل کامل، از شیء پیکربندی JavaScript قبل از بارگیری اسکریپت ویجت استفاده کنید.

HTML + JavaScript
<script>
window.FlashAI = {
  botId: "twoje_bot_id",
  config: {
    agentName: "Asystent",
    primaryColor: "#00f5ff",
    position: "bottom-right",
    languages: ["pl", "en"],
    trigger: {
      type: "delay",
      delay: 5
    },
    teaser: {
      enabled: true,
      delay: 3,
      message: "Hi! Need help?"
    }
  }
};
</script>
<script src="https://flashai.pl/widget.js"></script>

انواع تریگرها

"immediate" ویجت بلافاصله ظاهر می‌شود
"delay" بعد از ثانیه‌های مشخص شده ظاهر می‌شود
"scroll" بعد از اسکرول کردن درصد مشخص شده ظاهر می‌شود
"engagement" بعد از تعامل کاربر ظاهر می‌شود
"exit" در صورت قصد خروج ظاهر می‌شود
"manual" فقط از طریق فراخوانی API

نیاز به کمک دارید؟

مرجع API ما را بررسی کنید یا به جامعه بپیوندید.

Hi! 👋 I'm FlashAI. How can I help you boost your sales today?

FlashAI Assistant

Online

Powered by SymfoniX