راهنمای نصب ویجت فلوچت
با دنبال کردن مراحل زیر میتوانید ویجت چت فلوچت را به صورت کامل در وبسایت خود پیادهسازی کنید.
🛠️ پیشنیازها
- دسترسی به کدهای 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_id | string | - | (الزامی) شناسه ربات شما |
debug | boolean | false | نمایش خطاها در کنسول |
lang | string | ’fa’ | زبان رابط کاربری (fa/en/es) |
name | string | - | نام کاربری (اختیاری) |
email | string | - | ایمیل کاربری (اختیاری) |
phone | string | - | شماره تماس (اختیاری) |
company | string | - | نام شرکت (اختیاری) |
about | string | - | بیوگرافی (اختیاری) |
... | 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)
📌 بهترین روشها
- اسکریپت را در
<head>قرار ندهید - از نسخه HTTPS استفاده کنید
- قبل از فراخوانی متدها از بارگذاری ویجت مطمئن شوید:
if (window.FlowChat) {
// اجرای دستورات
}با تکمیل این مراحل، ویجت فلوچت به طور خودکار در وبسایت شما نمایش داده میشود. برای اطلاعات بیشتر به مستندات متدهای API مراجعه کنید.
آخرین تغییر در