کتابخانه گفت‌وگوی Synova

کتابخانه Synova یک ابزار جاوااسکریپتی ساده برای افزودن رابط گفت‌وگوی هوشمند به وب‌سایت شماست.

🛠 نصب

برای افزودن Synova به پروژه خود می‌توانید آن را به صورت اسکریپت در HTML وارد کنید یا از طریق ابزارهایی مانند Webpack یا Vite نصب نمایید.

استفاده از اسکریپت:

  <script src="path/to/synova.js"></script>

یا نصب با npm:

npm install synova

🚀 شروع استفاده

۱. مقداردهی اولیه

import type { Synova } from 'synova'

let synova: Synova | undefined

۲. باز کردن چت دستیار

برای نمایش چت هوشمند با محتوای محصول (یا هر محتوای ساخت‌یافته دیگر)، می‌توانید از مثال زیر استفاده کنید:

async function openChat() {
  // شروع لودینگ
  const { Synova } = (await import('synova'))
  synova = new Synova()
  synova.init({
    apiKey: 'کلید API'
  })

  window.addEventListener('readySynova', () => {
    // اتمام لودینگ
    synova.open({
      apiKey: 'کلید API',
      assistantKey: 'شناسه دستیار',
      cellPhone: 'شماره موبایل',
      content: 'محتوای ساخت‌یافته به صورت رشته‌ی JSON',
      theme: { color: 'purple' },
    })
  })
}

📄 پارامترها

| نام پارامتر | نوع | الزامی | توضیح | | ------------- | -------- | ------ | ------------------------------------- | | apiKey | string | بله | کلید API شما برای Synova | | cellPhone | string | بله | شماره موبایل کاربر | | assistantId | string | بله | شناسه دستیار گفت‌وگو | | content | string | بله | محتوای ساخت‌یافته به صورت رشته‌ی JSON | | theme | string | خیر | رنگ تم برنامه |

🧾 ساختار داده content

پارامتر content باید شامل اطلاعات محصول یا محتوای شما باشد. برخی از کلیدهای مهم در آن:

• imageUrls: آرایه‌ای از لینک تصاویر محصول
• videoUrls: آرایه‌ای از لینک ویدیوی محصول
• brandTitle, description, title, priceT, و ...

📞 پشتیبانی

در صورت بروز مشکل یا سوال برای ادغام کتابخانه Synova در سایت خود، می‌توانید با تیم پشتیبانی ما در تماس باشید.

🔗 آدرس سایت: https://rayanbina.ir

© 2025 Synova – کلیه حقوق محفوظ است.