التوثيق

التوثيق

كيفية دمج Flash AI مع موقعك الإلكتروني

البداية السريعة

إضافة Flash AI إلى موقعك تستغرق 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 لون التمييز (hex)
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>

JavaScript 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 إلى أي رابط وسيتم فتح الدردشة تلقائيًا. مثالي لرموز 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