افزونهٔ WHMCS

این راهنما برای نسخهٔ گیسوی «افزونهٔ هوش مصنوعی WHMCS» است؛ همان که در فهرست Addon Modules با نام «Gisoo AI» می‌بینید. WHMCS شما با آن یک پنجرهٔ چت آنلاین در ناحیهٔ کاربری می‌گیرد که دستیارش از محصولات، قیمت‌ها، پایگاه دانش و حساب همان مشتری جواب می‌دهد، یک صندوق چت برای همکارانتان، و پنلی در صفحهٔ هر تیکت که پاسخ را پیش‌نویس می‌کند. افزونه از سرور WHMCS به نشانی https://gisoo.pro/api/v1 وصل می‌شود. اگر سرورتان در دیتاسنتری داخل ایران است، در تنظیمات «نشانی API» را روی ir.gisoo.pro بگذارید؛ همان سرویس است روی نشانی‌ای داخل ایران و کلید، اعتبار و مدل‌ها عوض نمی‌شوند. هزینهٔ هر پاسخ از اعتبار هوش مصنوعی حساب گیسوی شما برداشته می‌شود. اگر هنوز تصمیم نگرفته‌اید، اول معرفی افزونه و تصویرهای آن را ببینید.

نصب، از کلید تا اولین گفت‌وگو

1. کلید و اعتبار را در اپ آماده کنید

   به gisoo.pro/app/api بروید، پروژه‌ای به اسم سایتتان باز کنید و کلیدش را بردارید. اگر حساب اعتبار ندارد، از gisoo.pro/app/credit شارژش کنید.

2. پوشه را بارگذاری کنید

   فایل ZIP را باز کنید و پوشهٔ modules/addons/gisoo_ai را در همان مسیر نصب WHMCS خودتان بارگذاری کنید.

3. افزونه را فعال کنید

   در پنل مدیریت WHMCS به System Settings ← Addon Modules بروید، «Gisoo AI» را فعال کنید و به نقش‌های مدیریتی که باید با چت و تیکت کار کنند دسترسی بدهید.

4. کلید را بگذارید و اتصال را بیازمایید

   در Addons ← Gisoo AI ← تنظیمات کلید را بگذارید، ذخیره کنید و «آزمایش اتصال» را بزنید. اگر سرور WHMCS در دیتاسنتر ایران است، پیش از آزمایش «نشانی API» را روی ir.gisoo.pro بگذارید.

5. کران را روشن نگه دارید

   کران (cron) WHMCS باید مثل همیشه هر پنج دقیقه اجرا شود؛ پاسخ تیکت‌ها و پاک‌سازی روزانه به آن بسته است. پیشنهاد ما: یک مدیر با نام «دستیار پشتیبانی» بسازید و در بخش تیکت‌ها انتخابش کنید تا پاسخ‌ها به نام او ثبت شوند.

حالت تیکت از اول «پیش‌نویس برای همکاران» است؛ تا خودتان حالت خودکار را روشن نکنید، هیچ پاسخی بدون دیدن همکاران شما به مشتری نمی‌رسد. پیش از روشن کردن حالت خودکار، در زبانهٔ «دانش» بخش «آزمایش دستیار» را امتحان کنید.

دستیار از کجا جواب می‌دهد

برای هر پرسش، مرتبط‌ترین بخش‌های این منابع برداشته می‌شود و دستیار از جای دیگری جواب نمی‌دهد. پرسش فارسی، مقالهٔ انگلیسی پایگاه دانش را هم پیدا می‌کند.

برای محصول‌هایی که فقط همکاران شما می‌فروشند، شناسهٔ محصول را در تنظیمات در فهرست «محصولاتی که دستیار پیشنهاد نمی‌دهد» بنویسید.

چت آنلاین در ناحیهٔ کاربری

• پنجرهٔ چت روی همهٔ صفحه‌های ناحیهٔ کاربری باز می‌شود، فارسی و راست‌به‌چپ یا انگلیسی، با رنگ و جای دلخواه؛ روی گوشی تمام‌صفحه است.
• مهمان‌ها با نام و ایمیل گفت‌وگو را شروع می‌کنند و مشتری‌های واردشده بدون فرم.
• تا چهار سؤال پیشنهادی زیر پیام خوشامد نشان داده می‌شود؛ مشتری با زدن هر کدام همان را می‌فرستد.
• دستیار صبر می‌کند پیام مشتری تمام شود و به چند خط پشت‌سرهم یک جواب می‌دهد. گفت‌وگو با بارگذاری دوبارهٔ صفحه از دست نمی‌رود.
• بعد از اولین جواب می‌پرسد «این گفتگو کمکتان کرد؟». جواب «نه» در صندوق چت علامت می‌خورد و درصد رضایت ۳۰ روز اخیر در پیشخوان افزونه دیده می‌شود.
• چت از هوک ClientAreaFooterOutput بارگذاری می‌شود و به قالب ناحیهٔ کاربری وابسته نیست. مسیر صفحه‌هایی را که چت نباید در آن‌ها دیده شود در «پنهان کردن چت در این صفحه‌ها» بنویسید.

<!-- a direct link: the client area with the chat already open -->
<a href="index.php?m=gisoo_ai">گفت‌وگو با پشتیبانی</a>

<script>
  // from your own script, on any client-area page
  GisooChat.open();
</script>

سپردن به همکار و صندوق چت

وقتی کار به همکار شما نیاز دارد، مثل بازگشت وجه، شکایت یا کاری روی حساب، گفت‌وگو به صف همکاران می‌رود. اگر در زمانی که در تنظیمات تعیین کرده‌اید کسی جواب ندهد، به مشتری پیشنهاد می‌شود گفت‌وگو را به تیکت تبدیل کند.

• صندوق چت در Addons ← Gisoo AI گفت‌وگوهای باز، منتظر و بسته را با متن کامل، دلیل ارجاع و نظر مشتری نشان می‌دهد.
• «پاسخ با من» گفت‌وگو را از هوش مصنوعی می‌گیرد و «برگرداندن به هوش مصنوعی» آن را پس می‌دهد.
• پیام کوچکی در همهٔ صفحه‌های پنل مدیریت خبر می‌دهد که بازدیدکننده‌ای منتظر است.

حالت‌های پاسخ تیکت

هر تیکت تازه و هر پاسخ مشتری، در دپارتمان‌هایی که انتخاب کرده‌اید، خوانده می‌شود. پنل «پاسخ هوش مصنوعی» در صفحهٔ همان تیکت پیش‌نویس را نشان می‌دهد و با یک دکمه در کادر پاسخ WHMCS می‌گذارد.

در هر دو حالت فعال، برای هر تیکت «توقف روی این تیکت» یا «نوشتن دوباره» را دارید. بعد از پاسخ یکی از همکاران، دستیار روی همان تیکت کنار می‌کشد.

هزینه و کنترل آن

خود افزونه پولی ندارد. هر پاسخ چت یا تیکت به اندازهٔ مصرف واقعی مدلی که انتخاب کرده‌اید از اعتبار حساب گیسوی شما کم می‌شود. با مدل پیش‌فرض gpt-4o-mini، هر پاسخ معمولاً چند هزار توکن ورودی (بیشترش دانشی که همراه پرسش می‌رود) و چند صد توکن خروجی است. قیمت هر مدل را در کتابخانهٔ مدل‌ها می‌بینید.

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

امنیت و حریم خصوصی

• کلید API با encrypt() خود WHMCS رمزنگاری‌شده ذخیره می‌شود، هرگز به مرورگر نمی‌رسد و در گزارش ماژول (Module Log) هم پوشانده می‌شود.
• از حساب مشتری فقط فهرست مشخصی از فیلدها خوانده می‌شود. رمز عبور، نام کاربری سرویس، IP سرور، IP سفارش، فیلدهای سفارشی و یادداشت‌های داخلی هرگز به مدل داده نمی‌شوند.
• گفت‌وگوی هر مشتری واردشده فقط برای خودش باز می‌شود و هر متنی که مشتری یا مدل می‌نویسد به شکل متن نمایش داده می‌شود، نه HTML.
• اگر مشتری رمزش را در چت بنویسد، دستیار تکرارش نمی‌کند و از او می‌خواهد همان لحظه عوضش کند.
• نگه‌داری گفت‌وگوها و گزارش‌ها محدود است (پیش‌فرض ۱۸۰ روز) و کران روزانه قدیمی‌ترها را پاک می‌کند.
• غیرفعال کردن افزونه داده‌ها را نگه می‌دارد؛ برای پاک کردن کامل، دکمهٔ «پاک کردن همهٔ داده‌های افزونه» در تنظیمات را بزنید.

نسخهٔ گیسو و نسخهٔ نِت اَرز

افزونه دو نسخه دارد که به یک حساب وصل می‌شوند: همان کلید، همان اعتبار و همان مدل‌ها. نسخهٔ گیسو (پوشهٔ gisoo_ai) برای نصب تازه است و نسخهٔ نِت اَرز (پوشهٔ netarz_ai) برای سایت‌هایی که آن را از قبل دارند. دو نسخه نام ماژول، کلاس‌ها و جدول‌های جدا دارند و کنار هم تداخلی ندارند. اگر از نسخهٔ نِت اَرز به نسخهٔ گیسو می‌روید، تنظیمات و گفت‌وگوها منتقل نمی‌شوند؛ کلید و یادداشت‌هایتان را دوباره در نسخهٔ گیسو بگذارید.

به‌روزرسانی از نسخهٔ ۱٫۰: پوشهٔ تازه را روی پوشهٔ قبلی بگذارید و صفحهٔ Addon Modules را یک بار باز کنید؛ جدول‌ها خودکار به‌روز می‌شوند و تنظیمات، گفت‌وگوها و نشانی API قبلی سر جایش می‌ماند.

رفع اشکال

اشکالی که این‌جا نیست را در گیت‌هاب افزونه گزارش کنید یا از پشتیبانی بپرسید.