Skip to Content
ویجت فلوچت

راهنمای نصب ویجت فلوچت

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

🛠️ پیش‌نیازها

  • دسترسی به کدهای HTML وبسایت
  • شناسه ربات (chatbot_id) از پنل مدیریتی فلوچت

🔌 مراحل نصب

۱. افزودن اسکریپت به صفحه

کد زیر را قبل از تگ بستن </body> در تمام صفحات مورد نظر قرار دهید:

HTML
<!-- Start FlowChat Widget --> <script> window.flowchatSettings = { chatbot_id: "624a1d8f3c5d8f001a6b7d3c", // (Required) chatbot ID }; </script> <script> (()=>{var t=window,e=document;if(!t.FlowChat){var a=function(){for(var t=[],e=0;e<arguments.length;e++)t[e]=arguments[e];a.storeArguments(t)};a.commandQueue=[],a.storeArguments=function(t){a.commandQueue.push(t)},t.FlowChat=a;var n=function(){var n,o=e.createElement("script");o.type="text/javascript",o.async=!0,o.src="https://widget.flowchat.tech/assets/script.js",o.onload=function(){a.commandQueue.forEach((function(e){t.FlowChat.apply(t,e)}))};var r=e.getElementsByTagName("script")[0];null===(n=r.parentNode)||void 0===n||n.insertBefore(o,r)};"complete"===e.readyState?n():t.attachEvent?t.attachEvent("onload",n):t.addEventListener("load",n,!1)}})(); </script> <!-- End FlowChat Widget -->

⚙️ تنظیمات سفارشی‌سازی

پارامترهای اصلی

پارامترنوعپیش‌فرضتوضیحات
chatbot_idstring-(الزامی) شناسه ربات شما
debugbooleanfalseنمایش خطاها در کنسول
langstring’fa’زبان رابط کاربری (fa/en/es)
namestring-نام کاربری (اختیاری)
emailstring-ایمیل کاربری (اختیاری)
phonestring-شماره تماس (اختیاری)
companystring-نام شرکت (اختیاری)
aboutstring-بیوگرافی (اختیاری)
...any-ویژگی‌های دیگر (اختیاری)

تنظیمات پیشرفته (اختیاری)

<script> window.flowchatSettings = { chatbot_id: "624a1d8f3c5d8f001a6b7d3c", // (Required) chatbot ID name: "John Doe", // user name email: "s6V0o@example.com", // user email phone: "09120457077", // user phone number lang: "fa", // language subscription_plan: "Professional", // subscription status [Custom Attribute] subscription_status: "Awaiting payment", // payment status [Custom Attribute] signed_up: true, // user registration status [Custom Attribute] // ... other configuration parameters }; </script>

🎯 مثال کاربری

تغییر پویای تنظیمات پس از بارگذاری

// پس از بارگذاری ویجت FlowChat('update', { name: 'کاربر مهمان', email: 'guest@example.com' });

مدیریت رویدادها

// هنگام باز شدن ویجت FlowChat('onShow', () => { console.log('چت فعال شد'); // انجام عملیات مورد نیاز });

🔍 عیب‌یابی

  • مشاهده خطاها: debug: true را فعال کنید
  • بررسی شناسه ربات: از صحت chatbot_id اطمینان حاصل کنید
  • بارگذاری مجدد: کش مرورگر را پاک کنید (Ctrl + Shift + R)

📌 بهترین روش‌ها

  1. اسکریپت را در <head> قرار ندهید
  2. از نسخه HTTPS استفاده کنید
  3. قبل از فراخوانی متدها از بارگذاری ویجت مطمئن شوید:
if (window.FlowChat) { // اجرای دستورات }

با تکمیل این مراحل، ویجت فلوچت به طور خودکار در وبسایت شما نمایش داده می‌شود. برای اطلاعات بیشتر به مستندات متدهای API مراجعه کنید.

آخرین تغییر در