افزونهٔ وردپرس «چت وب حسابیکس» (Hesabix Web Chat): تفاوت میان نسخهها
صفحهای تازه حاوی « === این افزونه چیست؟ === Hesabix Web Chat افزونهٔ رسمی وردپرس برای اتصال سایت شما به چت وب CRM حسابیکس است. بازدیدکننده روی سایت دکمهٔ شناور (یا بلوک شورتکد) را میبیند، فرم شروع گفتگو را پر میکند و بعد با همان مکالمه، پیامهای زنده و اپراتورهایی که در...» ایجاد کرد |
جز اضافه شدن تصویر |
||
| خط ۱: | خط ۱: | ||
[[پرونده:Screenshot 2026-04-26 052346.png|جایگزین=تنظیمات مدیریت افزونه|بندانگشتی|تنظیمات مدیریت افزونه]] | |||
=== این افزونه چیست؟ === | === این افزونه چیست؟ === | ||
Hesabix Web Chat افزونهٔ رسمی وردپرس برای اتصال سایت شما به چت وب CRM حسابیکس است. بازدیدکننده روی سایت دکمهٔ شناور (یا بلوک شورتکد) را میبیند، فرم شروع گفتگو را پر میکند و بعد با همان مکالمه، پیامهای زنده و اپراتورهایی که در پنل حسابیکس به چت وصلاند ادامه پیدا میکند. ارتباط از طریق API عمومی و کلید عمومی (Public Key) ویجت چت انجام میشود؛ نیازی به لاگین وردپرس برای مهمان عادی نیست. | Hesabix Web Chat افزونهٔ رسمی وردپرس برای اتصال سایت شما به چت وب CRM حسابیکس است. بازدیدکننده روی سایت دکمهٔ شناور (یا بلوک شورتکد) را میبیند، فرم شروع گفتگو را پر میکند و بعد با همان مکالمه، پیامهای زنده و اپراتورهایی که در پنل حسابیکس به چت وصلاند ادامه پیدا میکند. ارتباط از طریق API عمومی و کلید عمومی (Public Key) ویجت چت انجام میشود؛ نیازی به لاگین وردپرس برای مهمان عادی نیست. | ||
[[پرونده:Screenshot 2026-04-26 052235.png|جایگزین=نمای دریافت اطلاعات|بندانگشتی|نمای دریافت اطلاعات]] | |||
=== قبل از نصب چه چیزهایی لازم است؟ === | === قبل از نصب چه چیزهایی لازم است؟ === | ||
| خط ۹: | خط ۱۲: | ||
* آدرس پایهٔ API سروری که حسابیکس روی آن اجرا میشود (مثلاً آدرس نمونهای مثل <code><nowiki>https://…</nowiki></code> — مطابق داکیومنت یا پشتیبانی شما) را بدانید. | * آدرس پایهٔ API سروری که حسابیکس روی آن اجرا میشود (مثلاً آدرس نمونهای مثل <code><nowiki>https://…</nowiki></code> — مطابق داکیومنت یا پشتیبانی شما) را بدانید. | ||
* وردپرس حداقل نسخهای که در صفحهٔ افزونه اعلام شده (در حال حاضر ۵.۸ به بالا) و PHP ۷.۴ به بالا. | * وردپرس حداقل نسخهای که در صفحهٔ افزونه اعلام شده (در حال حاضر ۵.۸ به بالا) و PHP ۷.۴ به بالا. | ||
[[پرونده:Screenshot 2026-04-26 052207.png|بندانگشتی|نمای گفت و گو]] | |||
=== دانلود === | === دانلود === | ||
نسخهٔ کنونی تا ۶ اردیبهشت ۱۴۰۵، ساعت ۰۵:۳۱
این افزونه چیست؟
Hesabix Web Chat افزونهٔ رسمی وردپرس برای اتصال سایت شما به چت وب CRM حسابیکس است. بازدیدکننده روی سایت دکمهٔ شناور (یا بلوک شورتکد) را میبیند، فرم شروع گفتگو را پر میکند و بعد با همان مکالمه، پیامهای زنده و اپراتورهایی که در پنل حسابیکس به چت وصلاند ادامه پیدا میکند. ارتباط از طریق API عمومی و کلید عمومی (Public Key) ویجت چت انجام میشود؛ نیازی به لاگین وردپرس برای مهمان عادی نیست.
قبل از نصب چه چیزهایی لازم است؟
- یک کسبوکار فعال در حسابیکس و دسترسی به بخش CRM و چت وب.
- در حسابیکس، برای همان کسبوکار یک ویجت چت ساخته و Public Key و در صورت نیاز دامنههای مجاز (سایت وردپرس) تنظیم شده باشد.
- آدرس پایهٔ API سروری که حسابیکس روی آن اجرا میشود (مثلاً آدرس نمونهای مثل
https://…— مطابق داکیومنت یا پشتیبانی شما) را بدانید. - وردپرس حداقل نسخهای که در صفحهٔ افزونه اعلام شده (در حال حاضر ۵.۸ به بالا) و PHP ۷.۴ به بالا.
دانلود
نسخههای بستهبندیشدهٔ افزونه از اینجا:
https://source.hesabix.ir/hesabix/HesabixChatPlugin/releases
فایل ZIP آخرین نسخه را بگیرید. در بسیاری از ویکیها/ریپوها امکان کلون از Git هم هست، اما برای نصب در وردپرس، استفاده از همان بستهٔ ZIP انتشار سادهتر و مطمئنتر است.
نصب
- در پنل وردپرس: افزونهها → افزودن → بارگذاری افزونه — فایل ZIP را انتخاب و نصب کنید.
- فعالسازی را بزنید.
- بروید به: تنظیمات → چت حسابیکس (ممکن است منو با بستهبندی زبان شما کمی فرق کند، معمولاً زیر تنظیمات است).
پیکربندی (اولین بار)
در صفحهٔ تنظیمات افزونه:
- آدرس پایه API باید با
https://یاhttp://شروع شود و بدون اسلش انتهایی (مثال:https://hsxn.hesabix.irاگر همان نمونهٔ پیشفرض برای شماست؛ در محیط اختصاصی، آدرس دادهشده توسط تیم فنی را بگذارید). - Public Key ویجت مقدار کپیشده از پنل CRM > چت وب (تنظیمات همان ویجت).
- دامنهٔ سایت همان دامنهای که وردپرس روی آن اجرا میشود باید در «دامنههای مجاز» همان ویجت در پنل حسابیکس ثبت شده باشد، وگرنه ارتباط ممکن است رد شود.
بعد از ذخیره، اگر کلید و آدرس درست باشد، روی تمام جلوی سایت (یا فقط جایی که شورتکد گذاشتهاید — ببینید بخش بعد) اسکریپت و استایل چت بارگذاری میشود.
نحوهٔ نمایش روی سایت
دو حالت اصلی وجود دارد:
| حالت | توضیح |
|---|---|
| در تمام صفحات (دکمه شناور) | پیشفرض؛ دکمه در گوشهٔ صفحه (مثلاً پایین راست) و با کلیک، پنل چت باز میشود. |
| فقط با شورتکد | در تنظیمات، «نمایش ویجت» را روی شورتکد بگذارید و در برگه/نوشته [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).