افزونهٔ وردپرس

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

راه‌اندازی، از کلید تا اولین گفت‌وگو

1. کلید را اول در اپ بسازید

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

2. فایل را به وردپرس بدهید

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

3. کلید را بچسبانید

   در منوی تازهٔ «هوش مصنوعی» سراغ «تنظیمات» بروید و کلید را در اولین تب ذخیره کنید. افزونه همان لحظه کلید را با gisoo.pro امتحان می‌کند؛ اگر درست باشد، پیام «کلید تأیید شد و از نشانی gisoo.pro به حساب گیسو وصل شدید» را همراه موجودی می‌بینید.

4. به دستیار بگویید کیست و چه می‌فروشد

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

5. ویجت را روشن کنید و خودتان مشتری شوید

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

موجودی، سکه و قیمت مدل‌ها در پیشخوان

• کارت اعتبار: صفحهٔ «هوش مصنوعی ← پیشخوان» موجودی را به دلار نشان می‌دهد و زیرش برآوردی از همان مبلغ به سکه. نام پروژه، ابتدای کلید، سقف هزینهٔ کلید (اگر گذاشته باشید) و سقف درخواست در دقیقه هم آن‌جاست.
• قیمت کنار هر مدل: در هر فهرست انتخاب مدل، جلوی نام مدل دو عدد می‌آید: سکهٔ هر یک میلیون توکن ورودی و هر یک میلیون توکن خروجی. همین را در فهرست مدل‌ها هم پیدا می‌کنید.
• هشدار کم شدن اعتبار: این عدد را به دلار می‌دهید (پیش‌فرض ۱)، چون حساب به دلار نگه داشته می‌شود. وقتی موجودی پایین‌تر رفت، بالای صفحه‌های پیشخوان وردپرس نوار قرمزی با دکمهٔ «افزایش اعتبار» می‌آید که به صفحهٔ اعتبار اپ گیسو باز می‌شود.

چطور مبلغ شارژ به اعتبار تبدیل می‌شود و هر درخواست چقدر برمی‌دارد، در قیمت‌گذاری و صورتحساب آمده است.

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

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

اتصال و عمومی

در نسخهٔ گیسو این تب گزینهٔ «نشانی وب‌سرویس» ندارد؛ آن انتخاب فقط در نسخهٔ نِت اَرز هست.

چت پشتیبانی

بیشترِ رفتار دستیار از این تب می‌آید: چه بداند، کی ساکت شود و چند بار حق جواب دادن داشته باشد.

تیکتینگ

تیکت با هوش مصنوعی یا بدون آن کار می‌کند؛ «هوش مصنوعی تیکت» را خاموش کنید و یک سامانهٔ تیکت ساده دارید.

نویسنده و تصویر

این ابزارها فقط در پیشخوان وردپرس و برای نقش‌های نویسنده کار می‌کنند و بازدیدکننده هیچ‌کدام را نمی‌بیند.

پیشرفته

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

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

اگر بازدیدکننده چند پیام را پشت‌سرهم بفرستد، دستیار همه را با هم می‌خواند و یک بار واکنش نشان می‌دهد. واکنشش یکی از این سه است:

منبع‌هایی که دستیار از آن‌ها حرف می‌زند:

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

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

تیکت‌ها و هوش مصنوعی

این کار بعد از ثبت فرم و با WP-Cron در پس‌زمینه پیش می‌رود، تا مشتری پشت دکمهٔ «ارسال» معطل نماند. برای هر پیام مشتری یک بار اجرا می‌شود و اگر همکاری زودتر جواب داده باشد، کنار می‌رود.

جلوی خرج اضافه را کجا می‌گیرید

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

برگهٔ تیکت و دکمهٔ چت در قالب

فرم ثبت تیکت و فهرست تیکت‌های هر کاربر با کد کوتاه (Shortcode) [netarz_ai_tickets] روی صفحه می‌آید. برگهٔ «پشتیبانی و تیکت» را می‌شود عوض کرد؛ فقط اگر کد کوتاه را جای دیگری گذاشتید، همان برگه را در «برگهٔ پشتیبانی» (تب تیکتینگ) بزنید تا لینک ایمیل‌ها به جای درست برود. با ووکامرس، زبانهٔ «پشتیبانی» هم به «حساب کاربری من» اضافه می‌شود، با نشانی support-tickets زیر برگهٔ حساب.

برای این‌که چت از دکمه یا منوی خود قالب باز شود، به عنصر ویژگی data-netarz-chat بدهید، به #netarz-chat لینک بدهید یا تابع جاوااسکریپت را صدا بزنید:

<!-- any element that carries data-netarz-chat -->
<button type="button" data-netarz-chat>گفت‌وگو با پشتیبانی</button>

<!-- a plain link; also usable as a «Custom link» menu item -->
<a href="#netarz-chat">سؤالی دارید؟</a>

<script>
  // from your own script
  window.NetarzAIChatOpen();
</script>

برای توسعه‌دهنده: هوک‌ها

دو نسخه یک کد دارند و فقط نام و نشانی‌شان فرق می‌کند. برای همین نام هوک‌ها، کد کوتاه و ویژگی data-netarz-chat در نسخهٔ گیسو همان است که بود. کدی که برای نسخهٔ نِت اَرز نوشته‌اید، بی‌تغییر این‌جا هم کار می‌کند.

// functions.php or a small site-specific plugin

// No chat bubble on the WooCommerce checkout page
add_filter( 'netarz_ai_chat_visible', function ( $visible ) {
    return function_exists( 'is_checkout' ) && is_checkout() ? false : $visible;
} );

// Behind Cloudflare: take the visitor's IP from the header Cloudflare itself sets
add_filter( 'netarz_ai_client_ip', function ( $ip ) {
    return ! empty( $_SERVER['HTTP_CF_CONNECTING_IP'] ) ? $_SERVER['HTTP_CF_CONNECTING_IP'] : $ip;
} );

// A conversation went to a colleague: let your own system know
add_action( 'netarz_ai_chat_handoff', function ( $chat, $reason ) {
    error_log( 'Gisoo AI handoff: ' . $reason );
}, 10, 2 );

وقتی هر دو نسخه روی سایت است

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

راهش این است که یکی را از «افزونه‌ها ← افزونه‌های نصب‌شده» غیرفعال کنید. اگر سرور سایتتان در ایران است، نسخهٔ گیسو را نگه دارید.

آمدن از نسخهٔ نِت اَرز

جابه‌جایی چیزی را از نو نمی‌خواهد؛ کلید، تنظیمات، گفت‌وگوها، تیکت‌ها و پیوست‌ها همان‌جا که هستند می‌مانند و نسخهٔ گیسو آن‌ها را می‌خواند.

1. نسخهٔ گیسو را نصب کنید، ولی هنوز فعالش نکنید

   ZIP را بارگذاری کنید. پوشه‌اش gisoo-ai است، پس کنار netarz-ai نصب می‌شود و جای آن را نمی‌گیرد.

2. نسخهٔ نِت اَرز را غیرفعال کنید

   فقط غیرفعال، نه حذف. کارهای پس‌زمینهٔ صف‌شده (مثل پیش‌نویس تیکتی که در همان دقیقه رسیده) با این کار پاک می‌شود؛ اگر پیش‌نویسی جا ماند، با دکمهٔ «نوشتن پیش‌نویس با هوش مصنوعی» در صفحهٔ همان تیکت بسازیدش.

3. نسخهٔ گیسو را فعال کنید

   برگهٔ تیکت تازه‌ای ساخته نمی‌شود، چون برگهٔ قبلی پیدا می‌شود. کلید sk-ntz-v1- قبلی کار می‌کند؛ اگر کلید جدا برای این سایت می‌خواهید، در اپ گیسو بسازید و جایش بگذارید.

4. اتصال را ببینید

   در «تنظیمات» دکمهٔ «آزمایش اتصال و به‌روزرسانی فهرست مدل‌ها» را بزنید. پانویس صفحه‌های افزونه حالا نشانی gisoo.pro را نشان می‌دهد.

5. نسخهٔ نِت اَرز را حذف کنید، اگر خواستید

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

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

اگر نمی‌خواهید نسخه را عوض کنید، راه دیگری هم هست: نسخهٔ نِت اَرز از ۱٫۱٫۰ در تب «اتصال و عمومی» گزینهٔ «نشانی وب‌سرویس» دارد که می‌شود آن را روی gisoo.pro گذاشت.

چه چیزی از سایت شما بیرون می‌رود

• کلید فقط در تنظیمات وردپرس روی سرور خودتان ذخیره می‌شود. ویجت چت با سرور سایت شما حرف می‌زند، نه با gisoo.pro، پس کلید به مرورگر هیچ بازدیدکننده‌ای نمی‌رسد.
• برای جواب چت یا تیکت، به gisoo.pro این‌ها می‌رسد: پیام مشتری، «دانش اختصاصی» و تکه‌هایی از مطالب منتشرشده‌ای که به سؤال مربوط است. ابزارهای نوشتن فقط متنی را می‌فرستند که خودتان رویش دست گذاشته‌اید.
• هر درخواست، نشانی سایت شما و نسخهٔ افزونه را در سرآیند (Header) خود دارد.
• نام، راه تماس و متن گفت‌وگوها و تیکت‌ها در پایگاه دادهٔ وردپرس خودتان می‌ماند. IP بازدیدکننده فقط درهم‌شده (Hash) و برای شمردن اتصال‌ها نگه داشته می‌شود و از سایت بیرون نمی‌رود.
• وب‌سرویس گیسو متن درخواست و پاسخ را نگه نمی‌دارد؛ متن برای ساختن جواب به شرکت سازندهٔ مدل می‌رسد.
• افزونه متنی آماده برای «سیاست حفظ حریم خصوصی» وردپرس پیشنهاد می‌دهد، و با «ابزارها ← برون‌بری داده‌های شخصی» یا «پاک کردن داده‌های شخصی» گفت‌وگوها و تیکت‌های یک نشانی ایمیل را بیرون می‌کشید یا پاک می‌کنید.

حذف و پاک‌سازی

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

رفع اشکال نسخهٔ گیسو