Skip to Content
ویجت فلوچتAPI جاوااسکریپت

API جاوااسکریپت: متدهای تعاملی ویجت فلوچت

با استفاده از API زیر می‌توانید به صورت برنامه‌ریزی شده با ویجت چت فلوچت تعامل داشته باشید. این متدها امکان کنترل وضعیت نمایش، دریافت رویدادها و به‌روزرسانی پویای تنظیمات را فراهم می‌کنند.

🛠️ روش استفاده پایه

تمامی متدها از طریق تابع اصلی FlowChat فراخوانی می‌شوند:

FlowChat('method', parameters);

📌 متدهای کنترل وضعیت نمایش

باز کردن ویجت (open)

ویجت را در حالت بازشده نمایش می‌دهد.

index.js
FlowChat('open'); // نکته: در حالت پیش‌فرض ویجت به صورت خودکار باز نمی‌شود

بستن ویجت (close)

ویجت اگر باز باشد آن را می‌بندد.

index.js
FlowChat('close');

پنهان کردن ویجت (hide)

ویجت را ناپدید می‌کند (با حفظ حالت در DOM).

index.js
FlowChat('hide');

نمایان کردن ویجت (show)

ویجت مخفی شده را مجدداً نمایش می‌دهد.

index.js
FlowChat('show');

🔔 رویدادهای ویجت

با استفاده از متدهای زیر می‌توانید به تغییرات وضعیت ویجت واکنش نشان دهید:

onOpen - باز شدن ویجت

index.js
FlowChat('onOpen', () => { console.log('ویجت برای کاربر نمایش داده شد'); });

onClose - بسته شدن کامل

index.js
FlowChat('onClose', () => { console.log('ویجت بسته شد'); });

onHide - شروع مخفی شدن

index.js
FlowChat('onHide', () => { console.log('ویجت در حال ناپدید شدن است'); });

onShow - شروع نمایش مجدد

index.js
FlowChat('onShow', () => { console.log('ویجت در حال ظاهر شدن است'); });

⚙️ به‌روزرسانی پویای تنظیمات

با استفاده از متد update می‌توانید تنظیمات ویجت را بدون بارگذاری مجدد صفحه تغییر دهید:

index.js
FlowChat('update', { chatbot_id: "624a1d8f3c5d8f001a6b7d3c", // (Required) chatbot ID name: "John Doe", // user name email: "s6V0o@example.com", // user email phone: "09120457077", // user phone number 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 });
💡

با این قابلیت میتوانید ویژگی‌های کاربر مثل نام، شماره موبایل، شناسه یکتا و … تغییر دهید.
البته میتوانید ویژگی‌های شخصی سازی شده کاربر را هم با این قابلیت تغییر دهید. اطلاعات بیشتر

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

  1. تقدم اجرا: اطمینان حاصل کنید اسکریپت فلوچت قبل از فراخوانی متدها بارگذاری شده است.
  2. خطایابی: در صورت عدم عملکرد صحیح، کنسول مرورگر را برای خطاها بررسی نمایید.
index.js
// نمونه گردش کار تعاملی FlowChat('onOpen', () => { Analytics.track('chat_opened'); }); document.querySelector('#help-button').addEventListener('click', () => { FlowChat('open') FlowChat('update', { preselected_question: "FAQ" }); });
آخرین تغییر در