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