افزونهٔ وردپرس «چت وب حسابیکس» (Hesabix Web Chat)

تنظیمات مدیریت افزونه

این افزونه چیست؟

Hesabix Web Chat افزونهٔ رسمی وردپرس برای اتصال سایت شما به چت وب CRM حسابیکس است. بازدیدکننده روی سایت دکمهٔ شناور (یا بلوک شورتکد) را می‌بیند، فرم شروع گفتگو را پر می‌کند و بعد با همان مکالمه، پیام‌های زنده و اپراتورهایی که در پنل حسابیکس به چت وصل‌اند ادامه پیدا می‌کند. ارتباط از طریق API عمومی و کلید عمومی (Public Key) ویجت چت انجام می‌شود؛ نیازی به لاگین وردپرس برای مهمان عادی نیست.

نمای دریافت اطلاعات

قبل از نصب چه چیزهایی لازم است؟

• یک کسب‌وکار فعال در حسابیکس و دسترسی به بخش CRM و چت وب.
• در حسابیکس، برای همان کسب‌وکار یک ویجت چت ساخته و Public Key و در صورت نیاز دامنه‌های مجاز (سایت وردپرس) تنظیم شده باشد.
• آدرس پایهٔ API سروری که حسابیکس روی آن اجرا می‌شود (مثلاً آدرس نمونه‌ای مثل https://… — مطابق داکیومنت یا پشتیبانی شما) را بدانید.
• وردپرس حداقل نسخه‌ای که در صفحهٔ افزونه اعلام شده (در حال حاضر ۵.۸ به بالا) و PHP ۷.۴ به بالا.

نمای گفت و گو

دانلود

نسخه‌های بسته‌بندی‌شدهٔ افزونه از اینجا:

https://source.hesabix.ir/hesabix/HesabixChatPlugin/releases

فایل ZIP آخرین نسخه را بگیرید. در بسیاری از ویکی‌ها/ریپوها امکان کلون از Git هم هست، اما برای نصب در وردپرس، استفاده از همان بستهٔ ZIP انتشار ساده‌تر و مطمئن‌تر است.

نصب

1. در پنل وردپرس: افزونه‌ها → افزودن → بارگذاری افزونه — فایل ZIP را انتخاب و نصب کنید.
2. فعال‌سازی را بزنید.
3. بروید به: تنظیمات → چت حسابیکس (ممکن است منو با بسته‌بندی زبان شما کمی فرق کند، معمولاً زیر تنظیمات است).

پیکربندی (اولین بار)

در صفحهٔ تنظیمات افزونه:

1. آدرس پایه API باید با https:// یا http:// شروع شود و بدون اسلش انتهایی (مثال: https://hsxn.hesabix.ir اگر همان نمونهٔ پیش‌فرض برای شماست؛ در محیط اختصاصی، آدرس داده‌شده توسط تیم فنی را بگذارید).
2. Public Key ویجت مقدار کپی‌شده از پنل CRM > چت وب (تنظیمات همان ویجت).
3. دامنهٔ سایت همان دامنه‌ای که وردپرس روی آن اجرا می‌شود باید در «دامنه‌های مجاز» همان ویجت در پنل حسابیکس ثبت شده باشد، وگرنه ارتباط ممکن است رد شود.

بعد از ذخیره، اگر کلید و آدرس درست باشد، روی تمام جلوی سایت (یا فقط جایی که شورتکد گذاشته‌اید — ببینید بخش بعد) اسکریپت و استایل چت بارگذاری می‌شود.

نحوهٔ نمایش روی سایت

دو حالت اصلی وجود دارد:

حالت	توضیح
در تمام صفحات (دکمه شناور)	پیش‌فرض؛ دکمه در گوشهٔ صفحه (مثلاً پایین راست) و با کلیک، پنل چت باز می‌شود.
فقط با شورتکد	در تنظیمات، «نمایش ویجت» را روی شورتکد بگذارید و در برگه/نوشته [hesabix_chat] را بگذارید — در آن صفحه، روت ویجت لود می‌شود؛ اگر بیلدر/قالب hesabix_chat را در محتوا ندید، ممکن است asset لود نشود.

نکته: در حالت شورتکد، معمولاً باید همان id ریشه (hesabix-chat-host) توسط بلوک شورتکد رندر شود تا اسکریپت ویجت پیدایش کند (طبق راهنمای افزونه).

بقیهٔ تنظیمات (خیلی کوتاه)

• متن دکمه، عنوان پنل، پیام خوش‌آمد، زمان پاسخ‌گویی — متن‌هایی که به بازدیدکننده نمایش داده می‌شود.
• الگوی ظاهر (پیش‌فرض / مینیمال / رنگی)، تم روشن/تاریک، رنگ و متن دکمه، جای دکمه (چهار گوشه).
• لوگو کنار عنوان — از «رسانهٔ وردپرس».
• عرض/ارتفاع پنل، z-index، فاصله از لبه‌ها، گردی گوشه — اگر پنل زیر المان‌های دیگر رفت، z-index را بالاتر ببرید.
• جهت نوشتار — خودکار از وردپرس، یا اجباری RTL/LTR.
• فیلد ایمیل — الزامی، اختیاری، مخفی، یا خودکار (اگر کاربر وارد وردپرس و ایمیل معتبر داشته باشد، مثل hidden رفتار می‌کند).
• ارسال فایل — فقط اگر در CRM برای آن ویجت/کسب‌وکار ارسال فایل و فضا فعال باشد و API اجازه بدهد؛ تیک وردپرس فقط «درخواست نمایش» است.
• نمایش صفحهٔ فعلی — اگر فعال باشد، در فرم شروع، عنوان و لینک همان صفحه به بازدیدکننده دیده می‌شود (آدرس همیشه برای پنل اپراتور ارسال می‌شود، این فقط دیدن در سمت مشتری است).

کار تیمی و اپراتور

پس از شروع مکالمه، اپراتورها از پنل حسابیکس (بخش چت وب CRM) همان گفتگو را می‌بینند و پاسخ می‌دهند؛ سطح دسترسی همان کسب‌وکار و نقش‌های تعریف‌شده در CRM اعمال می‌شود.

به‌روزرسانی

در افزونه معمولاً نسخه در hesabix-chat.php و صفحهٔ افزونه‌های وردپرس دیده می‌شود. نسخه‌های جدید را از همان صفحهٔ releases بگیرید و مثل نصب، از مسیر بارگذاری یا جایگزینی پوشه (اگر به صورت دستی مدیریت می‌کنید) به‌روز کنید. در صورت تعریف به‌روزرسانی از راه دور (مثلاً مانیفست) در کد افزونه، ممکن است اعلان نسخه جدید هم در ادمین دیده شود.

اگر چیزی کار نکرد

• Public Key خالی نباشد.
• api_base دقیق و بدون / آخر باشد.
• دامنه در پنل ویجت مجاز باشد.
• اگر HTTPS دارد، Mixed Content نداشته باشید (سایت https و API هم ترجیحاً https).
• در صورت توسعه: پارامترهای دیباگ (در صورت وجود در داک) یا پشتیبانی حسابیکس.

جواز

افزونه تحت GPL v2 یا بالاتر عرضه می‌شود (مطابق هدر hesabix-chat.php).