افزونهٔ «هوش مصنوعی نِت اَرز» برای وردپرس سه چیز را با یک کلید API نِت اَرز به سایت شما میآورد:
چت پشتیبانی با دستیاری که از روی مطالب سایت خودتان جواب میدهد و هر جا مطمئن نیست گفتوگو را به شما میسپارد،
تیکتینگ برای کاربر عضو و مهمان، و ابزارهای نوشتن در ویرایشگر وردپرس.
همهٔ درخواستها از سرور سایت شما به https://netarz.ir/api/ai/v1 میرود و هزینهاش از اعتبار همان حساب کم میشود؛ حساب جداگانه در OpenAI لازم نیست.
| هزینهٔ افزونه | رایگان و متنباز، با مجوز GPL نسخهٔ ۲ یا بالاتر (GPL-2.0-or-later). فقط مصرف واقعی هوش مصنوعی از اعتبار شما کم میشود. |
| وردپرس | نسخهٔ ۶٫۰ به بالا؛ ویرایشگر بلوکی و کلاسیک هر دو پشتیبانی میشوند. |
| PHP | نسخهٔ ۷٫۴ تا ۸٫۴ |
| ووکامرس | اختیاری؛ اگر نصب باشد، محصولات در پاسخهای دستیار میآید و زبانهٔ «پشتیبانی» به حساب کاربری اضافه میشود. |
| دانلود | فایل ZIP را از صفحهٔ افزونهٔ وردپرس یا مستقیم از این لینک بگیرید. |
نصب و اتصال
- نصب افزونه فایل ZIP را دانلود کنید و در پیشخوان وردپرس از «افزونهها ← افزودن ← بارگذاری افزونه» نصب و فعال کنید. هنگام فعالسازی، یک برگه با کد کوتاه تیکتها خودکار ساخته میشود.
-
ساخت کلید پروژه
در پنل API هوش مصنوعی اعتبار بخرید، یک پروژه بسازید (مثلاً «سایت وردپرس») و برای آن کلید دسترسی (API Key) بگیرید؛ کلید با
sk-ntz-v1-شروع میشود. - گذاشتن کلید در افزونه به «هوش مصنوعی ← تنظیمات» بروید، کلید را در تب «اتصال و عمومی» وارد و ذخیره کنید. با دکمهٔ «آزمایش اتصال و بهروزرسانی فهرست مدلها» اتصال بررسی میشود و موجودی حساب در پیشخوان افزونه دیده میشود.
- روشن کردن چت در تب «چت پشتیبانی» گزینهٔ «نمایش ویجت چت» را فعال کنید و در «دانش اختصاصی» چیزهایی را بنویسید که دستیار باید بداند: شرایط ارسال، روشهای پرداخت، ساعت کاری، راههای تماس و پرسشهای پرتکرار.
ویجت چت برای همهٔ بازدیدکنندههای سایت باز است. در پنل نِت اَرز برای کلید این سایت سقف هزینه تعیین کنید تا هر اتفاقی هم بیفتد، خرج از آن عدد بالاتر نرود. محافظهای داخل خود افزونه (پایین همین صفحه) جای این سقف را نمیگیرند. محدودیتها و امنیت کلید
تنظیمات، تب به تب
همهٔ تنظیمات در «هوش مصنوعی ← تنظیمات» است. ذخیرهٔ یک تب به تنظیمات تبهای دیگر دست نمیزند. هر امکانی که مدل جدا ندارد، از «مدل پیشفرض» استفاده میکند.
اتصال و عمومی
| تنظیم | پیشفرض | کاربرد |
|---|---|---|
| کلید API نِت اَرز | — | کلید پروژه از پنل نِت اَرز. بعد از ذخیره، فقط شکل پوشیدهاش نشان داده میشود. |
| مدل پیشفرض | gpt-4.1-mini | مدل هر امکانی که مدل جدا ندارد. قیمت هر مدل کنار نامش دیده میشود. |
| هشدار کم بودن اعتبار (دلار) | ۱ | اعتبار کمتر از این عدد شد، در پیشخوان هشدار میبینید. |
| دربارهٔ کسبوکار شما | — | چند جمله دربارهٔ اینکه چه میفروشید و به چه کسانی؛ همهٔ امکانات هوش مصنوعی از آن استفاده میکنند. |
چت پشتیبانی
| تنظیم | پیشفرض | کاربرد |
|---|---|---|
| نمایش ویجت چت | خاموش | پنجرهٔ گفتوگو در پایین همهٔ صفحههای سایت. |
| پاسخگویی دستیار هوشمند | روشن | خاموش باشد، ویجت میماند و همهٔ پیامها منتظر پاسخ همکاران شما میماند. |
| مدل چت | مدل پیشفرض | برای چت، مدلی سریع و ارزان با پشتیبانی JSON مناسب است. |
| ظاهر و متنها | — | نام پشتیبان («پشتیبانی»)، عنوان پنجره («پشتیبانی آنلاین»)، پیام خوشامد، رنگ اصلی و رنگ متن، جای دکمه (راست یا چپ) و فاصله از پایین صفحه (۲۰ پیکسل). |
| پرسیدن نام / راه تماس | اختیاری / الزامی: موبایل یا ایمیل | راه تماس از کاربر واردشده (لاگینکرده) پرسیده نمیشود. |
| لحن دستیار | محاورهای و گرم | یا «رسمی». |
| دستورهای اختصاصی دستیار | — | مثلاً «دربارهٔ رقبا حرف نزن». این دستورها بر رفتار پیشفرض مقدم است. |
| دانش اختصاصی | — | معتبرترین منبع دستیار. این متن را عمومی فرض کنید و رمز یا اطلاعات محرمانه در آن ننویسید. |
| جستوجو در مطالب سایت | روشن | دستیار نوشتهها، برگهها و محصولات مرتبط با سؤال را پیدا میکند. |
| نوعهای محتوا برای جستوجو | post,page,product | نوعهای نوشته، جدا با کاما. |
| حداقل اطمینان برای پاسخ (٪) | ۵۵ | دستیار کمتر از این مطمئن بود، بهجای جواب دادن گفتوگو را به همکار میسپارد. |
| با پاسخ همکار، دستیار ساکت شود | روشن | بعد از پاسخ شما یا سپردن گفتوگو، دستیار در آن گفتوگو جواب نمیدهد؛ از صندوق گفتوگو دوباره روشن میشود. |
| سقف پاسخ خودکار در هر گفتوگو | ۳۰ | بعد از آن، گفتوگو به همکار سپرده میشود. |
| سقف پاسخ خودکار در روز (کل سایت) | ۵۰۰ | محافظ هزینه در برابر سوءاستفاده. |
| سقف شروع گفتوگو از هر اتصال در ساعت | ۱۰ | جلوی کسی را میگیرد که پشتسرهم گفتوگوی تازه باز میکند. |
| حداکثر طول هر پیام (نویسه) | ۱۵۰۰ | بین ۱۰۰ تا ۵۰۰۰. |
| دعوت به گفتوگو | روشن، بعد از ۲۵ ثانیه | پیام کوتاهی که یک بار در هر بازدید کنار دکمهٔ چت ظاهر میشود؛ متنش را خودتان مینویسید. |
| ساعت کاری همکاران | خاموش (۰۹:۰۰ تا ۲۱:۰۰، شنبه تا چهارشنبه) | بیرون از این ساعتها «پیام خارج از ساعت کاری» نشان داده میشود و دستیار میگوید همکاران در اولین ساعت کاری جواب میدهند. |
| پنهان در این صفحهها / در موبایل | — | هر خط یک مسیر (مثل /checkout) یا شناسهٔ برگه؛ * یعنی هر چیزی. |
| ایمیل اعلان گفتوگو | ایمیل مدیر سایت | «چه وقت ایمیل بفرستد»: هیچوقت، وقتی گفتوگو به همکار سپرده شد (پیشفرض)، یا هر گفتوگوی تازه و سپردهشده. |
| نگهداری گفتوگوهای بسته (روز) | ۱۸۰ | ۰ یعنی همیشه نگه دار. |
تیکتینگ
| تنظیم | پیشفرض | کاربرد |
|---|---|---|
| فعال بودن تیکتینگ | روشن | — |
| ثبت تیکت برای مهمان | روشن | مهمان با نام و ایمیل تیکت میفرستد و با لینک مخصوصی که به ایمیلش میرود پیگیری میکند. |
| بخشها | پشتیبانی فنی، فروش، مالی | هر خط یک بخش. |
| هوش مصنوعی تیکت | فقط پیشنویس برای همکار | خاموش، پیشنویس، یا پاسخ خودکار وقتی مطمئن است (پایینتر توضیح دادهایم). |
| مدل تیکت | مدل پیشفرض | — |
| حداقل اطمینان برای پاسخ خودکار (٪) | ۷۵ | فقط در حالت خودکار. |
| سقف کار هوش مصنوعی روی تیکتها در روز | ۲۰۰ | پیشنویس و پاسخ خودکار روی هم؛ بعد از آن تا فردا فقط همکاران جواب میدهند. |
| سقف کار هوش مصنوعی روی هر تیکت | ۸ | جلوی تیکتی را میگیرد که با پیامهای پشتسرهم اعتبار را خرج میکند. |
| پیوست فایل | روشن، تا ۵ مگابایت | پسوندهای مجاز: jpg,jpeg,png,gif,webp,pdf,zip,txt. فایلها با نام تصادفی در پوشهٔ محافظتشده ذخیره میشوند و فایل اجرایی و اسکریپت همیشه رد میشود. |
| ایمیل اعلان تیکت | ایمیل مدیر سایت | — |
| بستن خودکار پس از (روز) | ۷ | تیکتی که جواب دادهاید و مشتری تا این مدت پاسخ نداده بسته میشود؛ ۰ یعنی هرگز. |
| پاسخهای آماده | — | هر خط: عنوان | متن. |
| برگهٔ پشتیبانی | برگهٔ ساختهشده هنگام فعالسازی | برگهای که کد کوتاه تیکتها در آن است؛ لینکهای ایمیل به آن میرود. |
| زبانهٔ «پشتیبانی» در حساب ووکامرس | روشن | — |
| امضای پاسخها | — | زیر پاسخهای تیکت میآید. |
نویسنده و تصویر
| تنظیم | پیشفرض | کاربرد |
|---|---|---|
| ابزارهای نویسندگی | روشن | جعبهٔ «دستیار هوشمند» در ویرایشگر، صفحهٔ «نویسندهٔ هوشمند»، ساخت تصویر، متن جایگزین و پاسخ دیدگاه. |
| مدل نویسنده | مدل پیشفرض | — |
| زبان پیشفرض نوشتن | فارسی | — |
| لحن پیشفرض | صمیمی و گرم | یا رسمی، تخصصی و دقیق، ترغیبکننده (فروش)، ساده و قابلفهم برای همه. |
| چاپ توضیحات متا | روشن | فقط وقتی افزونهٔ سئوی دیگری فعال نیست. با Yoast، Rank Math، AIOSEO یا SEOPress، عنوان و توضیحات در فیلدهای همان افزونه ذخیره میشود. |
| مدل تصویر | gpt-image-1-mini | تصویر ساختهشده در کتابخانهٔ رسانه ذخیره میشود یا تصویر شاخص نوشته میشود. |
| مدل دیدن تصویر (متن جایگزین) | gpt-4.1-mini | مدلی که تصویر را میفهمد و متن جایگزین (alt) مینویسد. |
| پیشنهاد پاسخ دیدگاه | روشن | در صفحهٔ دیدگاههای وردپرس. |
پیشرفته
| تنظیم | پیشفرض | کاربرد |
|---|---|---|
| نقشهای پشتیبان | administrator,editor,shop_manager | این نقشها گفتوگوها و تیکتها را میبینند؛ مدیر همیشه دسترسی دارد. |
| نقشهای نویسنده | administrator,editor,author | این نقشها ابزارهای نویسندگی را دارند. |
| نگهداری گزارش مصرف (روز) | ۹۰ | گزارش محلی هر درخواست: امکان، مدل، توکن و شناسهٔ درخواست، بدون متن پیام. |
| پاک کردن همهچیز هنگام حذف افزونه | خاموش | پایینتر، بخش «حذف افزونه» را ببینید. |
دستیار چت چطور تصمیم میگیرد
دستیار برای هر پیام (یا چند پیامی که پشتسرهم آمده) یکی از این سه کار را انجام میدهد و چند پیام پشتسرهم فقط یک جواب میگیرد:
| تصمیم | چه وقت | بازدیدکننده چه میبیند |
|---|---|---|
answer | جواب در دانش سایت هست و اطمینان دستیار دستکم به اندازهٔ «حداقل اطمینان برای پاسخ» است. | جواب، همراه لینک صفحهٔ مرتبط. |
handoff | جواب در دانش سایت نیست، موضوع سفارش، پرداخت، مرجوعی یا شکایت است، یا اطمینان از حد تعیینشده کمتر است. | یک جملهٔ کوتاه که همکار ادامه میدهد؛ گفتوگو در صندوق با فیلتر «منتظر همکار» دیده میشود. |
silent | پیام فقط تشکر، «باشه» یا خداحافظی است. | هیچ پاسخی. |
دانش دستیار از اینها ساخته میشود: نام و نشانی سایت و «دربارهٔ کسبوکار شما»، دانش اختصاصی که نوشتهاید (معتبرترین منبع)، صفحههای مهم مثل فروشگاه، سبد خرید، حساب کاربری و برگهٔ تیکت، و اگر «جستوجو در مطالب سایت» روشن باشد، نوشتهها، برگهها و محصولات منتشرشده که با سؤال جور است (محصولات ووکامرس با قیمت و موجودی). پیشنویسها، نوشتههای خصوصی و رمزدار هیچوقت خوانده نمیشود.
هوش مصنوعی در تیکتها
| حالت | رفتار |
|---|---|
| خاموش | کاری خودکار انجام نمیشود؛ همکار هنوز میتواند با دکمه پیشنویس یا خلاصهٔ تیکت بخواهد. |
| پیشنویس (پیشفرض) | برای هر پیام تازهٔ مشتری یک پیشنویس خصوصی نوشته میشود که همکار ویرایش و ارسال میکند. مشتری آن را نمیبیند. |
| خودکار | اگر اطمینان دستیار دستکم «حداقل اطمینان برای پاسخ خودکار» (پیشفرض ۷۵٪) باشد، خودش جواب میدهد؛ وگرنه پیشنویس و یک یادداشت داخلی با دلیل میگذارد و منتظر همکار میماند. یادداشتهای داخلی هیچوقت در پرامپت پاسخ خودکار نمیرود. |
کار هوش مصنوعی روی تیکت در پسزمینه با WP-Cron انجام میشود تا ارسال فرم برای مشتری معطل نشود. برای هر پیام مشتری فقط یک بار اجرا میشود و اگر در همین فاصله همکاری جواب داده باشد، کنار میرود.
محافظهای هزینه
این سقفها در خود افزونه است و جدا از سقف هزینهٔ کلید در پنل نِت اَرز کار میکند:
- چت: سقف پاسخ خودکار در هر گفتوگو (۳۰) و در روز برای کل سایت (۵۰۰)، سقف شروع گفتوگو از هر اتصال در ساعت (۱۰) و حداکثر طول پیام (۱۵۰۰ نویسه). وقتی سقفی پر شود، گفتوگو به همکار سپرده میشود.
- تیکت: سقف کار هوش مصنوعی روی هر تیکت (۸، پیشنویسها هم حساب میشوند) و در روز برای کل سایت (۲۰۰).
- تمام شدن اعتبار: دستیار چت دیگر جواب نمیدهد و گفتوگوها را به همکار میسپارد تا اعتبار بخرید.
برگهٔ تیکت و حساب ووکامرس
کد کوتاه (Shortcode) [netarz_ai_tickets] فرم ثبت و فهرست تیکتها را نشان میدهد. برگهاش هنگام فعالسازی خودکار ساخته میشود؛ اگر آن را در برگهٔ دیگری گذاشتید، همان برگه را در تنظیم «برگهٔ پشتیبانی» انتخاب کنید تا لینکهای ایمیل درست باشد.
با ووکامرس، زبانهٔ «پشتیبانی» هم به «حساب کاربری من» اضافه میشود (نشانیاش support-tickets زیر برگهٔ حساب کاربری است) و مشتری میتواند سفارش مربوط را در تیکت انتخاب کند.
باز کردن چت از یک دکمه
هر عنصری با ویژگی data-netarz-chat یا هر لینک به #netarz-chat پنجرهٔ چت را باز میکند؛ از جاوااسکریپت هم window.NetarzAIChatOpen() همین کار را میکند.
<!-- هر عنصری با ویژگی data-netarz-chat -->
<button type="button" data-netarz-chat>گفتوگو با پشتیبانی</button>
<!-- یا یک لینک ساده؛ در منوی وردپرس هم بهعنوان «پیوند دلخواه» کار میکند -->
<a href="#netarz-chat">سؤالی دارید؟</a>
<script>
// یا از جاوااسکریپت
window.NetarzAIChatOpen();
</script>هوکها برای توسعهدهنده
| هوک (Hook) | نوع | کاربرد |
|---|---|---|
netarz_ai_chat_visible | فیلتر | false برگردانید تا ویجت در این درخواست نمایش داده نشود. |
netarz_ai_client_ip | فیلتر | IP واقعی بازدیدکننده پشت پراکسی معکوس (Reverse Proxy) یا CDN. |
netarz_ai_chat_started | اکشن | گفتوگوی تازه شروع شد ($chat). |
netarz_ai_chat_handoff | اکشن | گفتوگو به همکار سپرده شد ($chat، $reason). |
netarz_ai_ticket_created | اکشن | تیکت تازه ثبت شد ($ticket). |
// functions.php یا یک افزونهٔ کوچک اختصاصی
// ویجت چت را در صفحهٔ پرداخت ووکامرس نشان نده
add_filter( 'netarz_ai_chat_visible', function ( $visible ) {
return function_exists( 'is_checkout' ) && is_checkout() ? false : $visible;
} );
// پشت Cloudflare: IP واقعی بازدیدکننده از هدری که خود Cloudflare میگذارد
add_filter( 'netarz_ai_client_ip', function ( $ip ) {
return ! empty( $_SERVER['HTTP_CF_CONNECTING_IP'] ) ? $_SERVER['HTTP_CF_CONNECTING_IP'] : $ip;
} );
// گفتوگو به همکار سپرده شد: مثلاً به سامانهٔ داخلی خودتان خبر بدهید
add_action( 'netarz_ai_chat_handoff', function ( $chat, $reason ) {
error_log( 'NetArz AI handoff: ' . $reason );
}, 10, 2 );حریم خصوصی
- کلید API فقط روی سرور سایت شما ذخیره میشود و هیچوقت به مرورگر بازدیدکننده نمیرسد.
- برای پاسخ چت و تیکت، متن پیام مشتری، دانش اختصاصی و بخشهای کوتاهی از مطالب منتشرشدهٔ مرتبط با سؤال به نِت اَرز فرستاده میشود؛ برای ابزارهای نوشتن، فقط متنی که خودتان میخواهید رویش کار شود. نشانی سایت شما هم در هدر درخواست میآید.
- IP بازدیدکننده فقط به شکل درهمسازیشده (Hash) و برای جلوگیری از سوءاستفاده روی سایت خودتان نگه داشته میشود و برای نِت اَرز فرستاده نمیشود.
- نِت اَرز متن پیامها و پاسخها را ذخیره نمیکند؛ گزارش مصرف افزونه هم متن پیام را نگه نمیدارد.
- افزونه به ابزارهای حریم خصوصی وردپرس وصل است: از «ابزارها ← برونبری دادههای شخصی» و «پاک کردن دادههای شخصی» میتوانید گفتوگوها و تیکتهای یک ایمیل را بگیرید یا پاک کنید.
حذف افزونه
غیرفعال کردن افزونه چیزی را پاک نمیکند. حذف آن هم فقط وقتی دادهها را پاک میکند که پیشتر در تب «پیشرفته» گزینهٔ «پاک کردن همهچیز هنگام حذف افزونه» را روشن کرده باشید. در آن صورت گفتوگوها، تیکتها، پیوستها، گزارش مصرف، تنظیمات و دسترسیهای نقشها پاک میشود و برگشتپذیر نیست.
رفع اشکال
| نشانه | راه رفع |
|---|---|
| خطای کلید نامعتبر، باطلشده یا منقضی | کلید را در پنل نِت اَرز بررسی کنید و اگر لازم است کلید تازه بسازید و در تب «اتصال و عمومی» بگذارید. احراز هویت |
| دستیار جواب نمیدهد و همهٔ گفتوگوها به همکار سپرده میشود | اعتبار حساب تمام شده یا سقف هزینهٔ کلید پر شده است. از پنل نِت اَرز اعتبار بخرید؛ موجودی در پیشخوان افزونه دیده میشود. صورتحساب و اعتبار |
| برای تیکتها پیشنویس یا پاسخ خودکار ساخته نمیشود | کار هوش مصنوعی تیکت به WP-Cron نیاز دارد. اگر در wp-config.php مقدار DISABLE_WP_CRON را روشن کردهاید، یک کرانجاب (Cron Job) واقعی روی سرور بگذارید که wp-cron.php را هر چند دقیقه اجرا کند. سقف روزانه و سقف هر تیکت را هم نگاه کنید. |
| همهٔ بازدیدکنندهها زود به سقف شروع گفتوگو میخورند | سایت پشت پراکسی معکوس یا CDN (مثل Cloudflare) است و همه یک IP دارند. با فیلتر netarz_ai_client_ip IP واقعی را برگردانید؛ فقط از هدری که خود پراکسی شما میگذارد، نه هدری که بازدیدکننده بتواند جعل کند. |
| خطای «تعداد درخواستها از سقف کلید بیشتر شد» | محدودیت نرخ درخواست کلید پر شده است؛ کمی بعد دوباره امتحان کنید. محدودیتها و امنیت |
افزونه فقط از همان API عمومی استفاده میکند که در این مستندات آمده است. اگر امکانی میخواهید که در افزونه نیست، از Chat Completions و نمونهکدهای PHP شروع کنید.