ن
ماژول رایگان و متن‌باز · نسخهٔ ۱.۰.۲

افزونهٔ هوش مصنوعی WHMCS

چت آنلاین و پاسخ تیکت با هوش مصنوعی، داخل WHMCS خودتان؛ ماژول متن‌باز نِت اَرز.

برای شرکت‌های هاستینگ و نمایندگی‌هایی که پشتیبانی‌شان روی WHMCS می‌چرخد. این ماژول هوش مصنوعی، چت بات WHMCS شما برای پشتیبانی است: در ناحیهٔ کاربری با مشتری چت می‌کند، برای تیکت‌ها جواب می‌نویسد و هر جا کار به آدم نیاز داشت، رشتهٔ گفتگو را دست همکاران شما می‌دهد. هرچه می‌گوید، از داده‌های همان WHMCS خودتان است.

WHMCS 8.0+ · PHP 7.4+ مجوز MIT
yourhost.ir/clientarea.php

دستیار پشتیبانی

دستیار هوش مصنوعی

پیامتان را بنویسید…

نمونهٔ یک گفتگو در ناحیهٔ کاربری یک شرکت هاستینگ (قیمت نمونه). قیمت از جدول قیمت دامنه‌های WHMCS همان شرکت خوانده می‌شود.

چهار کار، داخل WHMCS

چه کاری از دستیار برمی‌آید

چت بات WHMCS روی گوشی: پنجرهٔ چت آنلاین هوش مصنوعی در ناحیهٔ کاربری، فارسی و راست‌به‌چپ
پنجرهٔ چت روی گوشی، از نسخهٔ ۱.۰.۲ افزونه

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

پنجرهٔ چت روی همهٔ صفحه‌های ناحیهٔ کاربری باز می‌شود.

  • فارسی و راست‌چین یا انگلیسی، با رنگ و جایی که خودتان انتخاب می‌کنید؛ روی گوشی تمام‌صفحه
  • چند خطی که مشتری پشت‌سرهم می‌نویسد، یک جواب می‌گیرد، نه سه جواب
  • مشتری می‌بیند پیامش «دیده شد» و جواب «در حال نوشتن» است، و اگر صفحه را عوض کند گفتگو سر جایش می‌ماند
  • مهمان نام و ایمیلش را می‌نویسد؛ مشتریِ واردشده فرمی نمی‌بیند
  • زیر کادر پیام یک خط کوچک «هوش مصنوعی از نِت اَرز» می‌آید که در تنظیمات خاموش می‌شود

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

گفتگوهای باز، منتظر و بسته را با متن کامل و دلیل ارجاع، داخل پنل مدیریت WHMCS می‌بینید.

  • هر وقت خواستید گفتگو را از دستیار تحویل می‌گیرید و بعد پسش می‌دهید
  • در همهٔ صفحه‌های پنل مدیریت خبردار می‌شوید که بازدیدکننده‌ای منتظر است

پاسخ تیکت

دستیار هر تیکت تازه و هر پاسخ مشتری را در دپارتمان‌های انتخابی شما می‌خواند.

  • پیش‌نویس جواب کنار همان تیکت آماده است و یک کلیک آن را به کادر پاسخ WHMCS منتقل می‌کند
  • تا وقتی خودتان نخواهید، چیزی خودکار فرستاده نمی‌شود

اعتبار، داخل WHMCS

موجودی اعتبار هوش مصنوعی نِت اَرز را بدون رفتن به سایت دیگری می‌بینید.

  • هم به دلار و هم به تومان؛ در پیشخوان خودِ افزونه و در ابزارک صفحهٔ اول مدیریت WHMCS
  • هزینهٔ امروز کنار سقف روزانه‌ای که گذاشته‌اید
پاسخ خودکار تیکت WHMCS، با اختیار شما

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

پاسخ خودکارِ خودِ WHMCS یک متن ثابت می‌فرستد. این افزونه برای هر تیکت از روی اطلاعات خود شما جواب تازه می‌نویسد، و شما تعیین می‌کنید آن جواب کجا برود.

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

دستیار جوابش را کنار همان تیکت می‌گذارد. همکار شما متن را مرور می‌کند، هر جا خواست تغییرش می‌دهد و ارسال با خود اوست. در این حالت هر جوابی که به مشتری می‌رسد، پیش از آن یکی از همکاران شما دیده است.

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

در هر دو حالت روشن، روی هر تیکت «توقف روی این تیکت» و «نوشتن دوباره» را دارید.

مسیر یک تیکت

  1. تیکت تازه یا پاسخ مشتری

    در دپارتمان‌هایی که انتخاب کرده‌اید

  2. جست‌وجو در اطلاعات WHMCS شما

    یادداشت‌ها، پایگاه دانش، محصولات، دامنه‌ها، حساب مشتری

  3. نوشتن جواب و سنجیدن اطمینان

    به زبان خودِ مشتری

  4. دستیار تیکت را نمی‌خواند

    تیکت مثل همیشه در صف همکاران شما می‌ماند

    پیش‌نویس در صفحهٔ تیکت

    همکار می‌خواند، ویرایش می‌کند و خودش می‌فرستد

    اطمینان بالاتر از حد شما

    جواب برای مشتری فرستاده می‌شود

    شکایت، بازگشت وجه، کار روی حساب

    پیش‌نویس می‌ماند، با یادداشت داخلی

  5. پاسخ یکی از همکاران

    دستیار از آن تیکت کنار می‌رود

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

فقط از اطلاعات WHMCS شما جواب می‌دهد

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

یادداشت‌های شما

ساعت پاسخگویی، شرایط بازگشت وجه، نیم‌سرورها (Nameserver) و جواب پرسش‌های پرتکرار. اگر با منبع دیگری نخواند، حرف همین یادداشت‌ها حساب است.

پایگاه دانش

مقاله‌هایی که برای همه منتشر کرده‌اید. مقالهٔ خصوصی کنار می‌ماند.

اطلاعیه‌ها

فقط اطلاعیه‌هایی که منتشر کرده‌اید.

محصولات و قیمت‌ها

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

قیمت دامنه‌ها

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

اختلال‌های شبکه

اختلالی که در Network Status ثبت کرده‌اید و هنوز بسته نشده است.

حساب مشتریِ واردشده

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

پرسش فارسی، مقالهٔ انگلیسی

اگر مقاله‌های پایگاه دانش شما انگلیسی‌اند، پرسش فارسی هم پیدایشان می‌کند.

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

سپردن به آدم درست

وقتی کار به همکار شما نیاز دارد

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

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

هزینه، سقف مصرف و اعتبار داخل WHMCS

هر جواب چت یا تیکت با قیمت همان مدلی حساب می‌شود که در تنظیمات افزونه انتخاب کرده‌اید؛ مدل پیش‌فرض gpt-4o-mini است. مدل رایگانی در API هوش مصنوعی نِت اَرز نیست؛ اعتبار را به تومان می‌خرید، از ۱۰۰,۰۰۰ تومان، و موجودی را به دلار و تومان داخل WHMCS می‌بینید. تا احراز هویت نکرده‌اید، سقف مصرف حسابتان ۲ دلار است.

با مدل پیش‌فرض و قیمت امروز، یک جواب چت یا تیکت با حدود سه هزار توکن ورودی و سیصد توکن خروجی نزدیک ۲۲۰ تومان از اعتبار کم می‌کند. دانش بیشتر و گفتگوی طولانی‌تر این رقم را بالا می‌برد.

  • سقف هزینهٔ روزانه سقفی به دلار برای هر روز. با رسیدن به آن، دستیار تا روز بعد جواب نمی‌دهد و چت‌ها مستقیم به صف همکاران می‌روند.
  • حداقل اعتبار پیش از این‌که اعتبار صفر شود، دستیار کنار می‌کشد.
  • ایمیل کمبود اعتبار به مدیران WHMCS، حداکثر روزی یک بار.
  • سقف پیام و طول جواب تعداد پیام هر بازدیدکننده در ساعت، و بلندترین جواب به توکن.
  • گزارش هر درخواست مصرف توکن، هزینهٔ برآوردی و زمان پاسخ هر درخواست ثبت می‌شود، با همان شناسه‌ای که در پنل نِت اَرز هم می‌بینید.

رقمی که افزونه نشان می‌دهد تخمینی است (توکن ضرب در قیمت عمومی مدل)؛ رقم دقیق را در پنل نِت اَرز می‌بینید.

پیشخوان افزونهٔ هوش مصنوعی WHMCS با گزارش مصرف و هزینه
اعتبار هوش مصنوعی نِت اَرز به دلار و تومان در پیشخوان مدیریت WHMCS

پیشخوان افزونه و ابزارک اعتبار در صفحهٔ اول پنل مدیریت WHMCS (عددها نمونه‌اند).

چه چیزی به مدل می‌رسد و چه چیزی نه

امنیت و اطلاعات مشتری

کلید رمزنگاری‌شده

کلید دسترسی (API Key) با encrypt() خودِ WHMCS ذخیره می‌شود، به مرورگر نمی‌رسد و در گزارش ماژول (Module Log) پوشانده می‌شود.

فهرست بستهٔ فیلدها

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

هر گفتگو برای صاحبش

گفتگوی مشتریِ واردشده فقط برای خودش باز می‌شود و از توکن گفتگو فقط هش SHA-256 نگه داشته می‌شود.

بررسی مبدأ و CSRF

چت پیامی را فقط وقتی ثبت می‌کند که سرآیند مخصوص خودش را داشته باشد و از همان دامنه (Origin) آمده باشد. فرم‌های پنل مدیریت توکن CSRF دارند و نوشتهٔ مشتری و مدل به‌صورت متن نمایش داده می‌شود، نه HTML.

رمزی که در چت نوشته شود

دستیار آن را تکرار نمی‌کند و از مشتری می‌خواهد همان لحظه عوضش کند.

نگه‌داری محدود

گفتگوها و گزارش‌ها به‌طور پیش‌فرض ۱۸۰ روز می‌مانند. غیرفعال کردن افزونه داده‌ها را نگه می‌دارد؛ دکمهٔ «پاک کردن همهٔ داده‌های افزونه» در تنظیمات همه را پاک می‌کند.

راه‌اندازی

نصب در پنج قدم

  1. ۱

    دانلود و بارگذاری

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

  2. ۲

    فعال کردن ماژول

    در System Settings → Addon Modules، «NetArz AI» را فعال کنید و به نقش‌های مدیریتی لازم دسترسی بدهید.

  3. ۳

    کلید و اعتبار

    در پنل هوش مصنوعی نِت اَرز یک کلید API بسازید (با sk-ntz-v1- شروع می‌شود) و اعتبار بخرید؛ از ۱۰۰,۰۰۰ تومان. تا احراز هویت نکرده‌اید، سقف مصرف حسابتان ۲ دلار است.

  4. ۴

    وارد کردن کلید

    در Addons → NetArz AI زبانهٔ «تنظیمات» را باز کنید و کلید را وارد و ذخیره کنید. دکمهٔ «آزمایش اتصال» نشان می‌دهد افزونه به نِت اَرز وصل شده است.

  5. ۵

    یک نام برای دستیار

    برای دستیار یک حساب مدیر جدا بسازید، مثلاً «دستیار پشتیبانی»، و در زبانهٔ تیکت‌ها انتخابش کنید؛ هر جوابی که دستیار در تیکت بگذارد با همین نام ثبت می‌شود. حالت پاسخ خودکار تا این مدیر انتخاب نشود، چیزی نمی‌فرستد.

نیازمندی‌ها

  • WHMCS 8.0+
  • PHP 7.4+ · curl · json · mbstring
  • دسترسی سرور به https://netarz.ir
  • کران (cron) WHMCS هر پنج دقیقه

WHMCS نرم‌افزار تجاری است و همراه افزونه نمی‌آید. اگر لایسنس ندارید، لایسنس WHMCS را در فروشگاه نِت اَرز ببینید.

مستندات API هوش مصنوعی

netarz/netarz-ai-whmcs

کد باز در گیت‌هاب

کد افزونه با مجوز MIT منتشر شده است: می‌خوانیدش، تغییرش می‌دهید و در کار تجاری خودتان هم به کارش می‌برید. WHMCS خودش نرم‌افزار تجاری است و در مخزن نیست؛ آزمون‌ها کد واقعی افزونه را روی یک WHMCS شبیه‌سازی‌شده اجرا می‌کنند.

آزمون واحد و یکپارچگی
۱۴۰
بررسی در مرورگر واقعی
۵۰
سناریوی مشتری با مدل واقعی
۱۵
  • اشکال در افزونه را در بخش Issues بنویسید، همراه نسخهٔ WHMCS و PHP و نتیجهٔ «آزمایش اتصال».
  • رفع اشکال، ترجمه یا امکان تازه را با Pull Request بفرستید.
  • مشکل امنیتی را در Issue عمومی ننویسید؛ به dev@netarz.ir بفرستید.

پرسش‌های رایج

افزونه رایگان است؟ هزینهٔ هوش مصنوعی چطور حساب می‌شود؟

افزونه رایگان است؛ مصرف هوش مصنوعی از اعتبار شما کم می‌شود. هزینهٔ هر جواب چت یا تیکت به قیمت مدلی که انتخاب کرده‌اید از اعتبار «API هوش مصنوعی» نِت اَرز برداشته می‌شود. این API مدل رایگان ندارد؛ اعتبار را به تومان می‌خرید و قیمت روز هر مدل را در صفحهٔ «قیمت مدل‌های هوش مصنوعی» می‌بینید. با مدل پیش‌فرض و قیمت امروز، جوابی با حدود سه هزار توکن ورودی و سیصد توکن خروجی نزدیک ۲۲۰ تومان از اعتبار کم می‌کند.

بدون هوش مصنوعی، فقط به‌عنوان چت آنلاین WHMCS کار می‌کند؟

بله. «پاسخ هوش مصنوعی در چت» را خاموش کنید؛ پنجرهٔ چت سر جایش می‌ماند و فقط همکاران شما از صندوق چت پاسخ می‌نویسند. این‌طور یک چت آنلاین ساده دارید که برای گفتگوها اعتباری مصرف نمی‌کند.

پاسخ خودکار تیکت بدون دیدن همکاران ما به مشتری می‌رسد؟

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

اگر اعتبار تمام شود یا سقف روزانه پر شود چه می‌شود؟

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

دستیار از کجا جواب می‌دهد؟ ممکن است قیمت یا اطلاعات اشتباه بگوید؟

فقط از اطلاعات WHMCS شما: یادداشت‌هایتان، پایگاه دانش عمومی، اطلاعیه‌ها، محصولات و قیمت‌های فرم سفارش، قیمت دامنه‌ها، اختلال‌های شبکه و حساب خودِ مشتری. اگر جواب در این منابع نباشد، گفتگو را به همکاران شما می‌سپارد. مدل زبانی هم ممکن است اشتباه کند؛ برای همین حالت پیش‌فرض تیکت پیش‌نویس است و پیش از روشن کردن حالت خودکار، جواب‌ها را در «آزمایش دستیار» می‌بینید.

رمز عبور، IP سرور یا یادداشت‌های داخلی مشتری به مدل هوش مصنوعی داده می‌شود؟

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

قالب ناحیهٔ کاربری ما فارسی و سفارشی است؛ چت کار می‌کند؟ با کدام نسخهٔ WHMCS؟

بله. افزونه پنجرهٔ چت را با هوک ClientAreaFooterOutput به پایین هر صفحه اضافه می‌کند، پس قالب سفارشی مانعش نیست. WHMCS نسخهٔ ۸٫۰ یا بالاتر و PHP ۷٫۴ یا بالاتر لازم دارد. برای صفحه‌هایی که چت نباید آن‌جا باشد، نشانی‌شان را در فهرست «پنهان کردن چت در این صفحه‌ها» وارد کنید.

کدام مدل‌ها را می‌توانم انتخاب کنم؟

هر مدل گفتگوی کاتالوگ API هوش مصنوعی نِت اَرز را؛ فهرست مدل‌ها با قیمتشان در تنظیمات افزونه بارگذاری می‌شود. مدل پیش‌فرض gpt-4o-mini است.

افزونه را دانلود کنید، کلید بسازید و اعتبار بخرید؛ بعد اولین پیش‌نویس تیکت را در WHMCS خودتان می‌بینید.

اشکال در خود افزونه را در Issues گیت‌هاب بنویسید؛ برای هر کاری که به حساب، کلید یا اعتبارتان در نِت اَرز مربوط است، از پنل تیکت باز کنید.

دربارهٔ API هوش مصنوعی نِت اَرز