پرش به محتوای اصلی
پرش به محتوای مقاله

افزونه Sohay داده‌های زنده ووکامرس را به چت‌بات‌های هوش مصنوعی متصل کرد

·۱۶ مرداد ۱۴۰۵۹ دقیقه مطالعه۱ بازدید
راهنما
نحوه افزودن چت‌بات هوش مصنوعی به ووکامرس با افزونه رایگان
نحوه افزودن چت‌بات هوش مصنوعی به ووکامرس با افزونه رایگان
اشتراک‌گذاری
واقعاً چه چیز جدید است؟

اتصال مستقیم و زنده به APIهای ووکامرس برای مدیریت سبد خرید و موجودی در لحظه — به‌جای تکیه بر داده‌های ایستا یا حافظه مدل.

تصور کنید صاحب یک فروشگاه ووکامرسی هستید و می‌خواهید دستیار هوشمندتان دقیقاً بداند در تاریخ ۷ اوت ۲۰۲۶، چند عدد ژاکت آبی سایز مدیوم در انبار موجود است، بدون اینکه مدل از خودش عدد اختراع کند. Sohay، یک افزونه رایگان وردپرس، با حل مشکل توهم (Hallucination) — شبیه دوستی که خاطره‌ای را اشتباه تعریف می‌کند — این امکان را فراهم می‌کند تا هوش مصنوعی به‌جای تکیه بر حافظه آموزشی، داده‌های زنده فروشگاه را بخواند.

بیشتر چت‌بات‌های عمومی در تجارت الکترونیک شکست می‌خورند چون به پایگاه داده‌های متغیر دسترسی ندارند. مشتریان اغلب سوالاتی می‌پرسند که پاسخ آن‌ها در سایت هست، مثل «آیا این محصول در سایز مدیوم موجود است؟» یا «مهلت مرجوعی شما چقدر است؟». پیدا کردن این پاسخ‌ها معمولاً کاربر را مجبور می‌کند از صفحه محصول خارج شده و در فوتر سایت بگردد تا به صفحات قوانین برسد. چت‌بات‌های معمولی وضعیت را بدتر می‌کنند؛ چون موجودی یا سیاست‌های خاص شما را نمی‌دانند، با اطمینان پاسخ‌های ساختگی می‌دهند. این موضوع منجر به کابوسی در پشتیبانی می‌شود که مشتری با جمله‌ی «چت‌بات شما به من گفت...» ایمیل می‌زند و ادعاهایی می‌کند که با واقعیت فروشگاه شما همخوانی ندارد. این چالش‌ها دقیقاً همان نقاط ضعفی هستند که عامل‌های خودگردان در سیستم‌های SaaS با کاهش چشمگیر زمان پاسخ‌دهی در حال برطرف کردن آن‌ها هستند.

Sohay با ایفای نقش به عنوان یک رابط (Front-end) برای مدل‌های OpenAI یا Google Gemini، این روند را تغییر می‌دهد. طبق مستندات این افزونه، Sohay مدل را ارائه نمی‌دهد، بلکه کاربر باید کلید API خود را وارد کند. این یک پیش‌نیاز است، نه یک تلاش برای فروش بیشتر یا مدل اشتراکی؛ بدون کلید، مدلی برای فراخوانی وجود ندارد و چت نمی‌تواند پاسخ دهد. این ساختار تضمین می‌کند که صاحب فروشگاه هزینه استنتاج (Inference) — لحظه‌ای که مدل واقعاً جواب تولید می‌کند، مثل خودِ آشپزی و نه دوره‌ی آموزش آشپز — را مستقیماً و به‌ازای هر توکن (Token) — تکه‌های کوچکی از متن، شبیه برش‌های یک کیک — به ارائه‌دهنده پرداخت کند. افزونه هیچ مبلغی را به عنوان کارمزد دریافت نمی‌کند و سرویسی را بازفروش نمی‌کند.

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

الزامات فنی و راه‌اندازی

برای اجرای این سامانه، سایت به وردپرس ۶.۶ یا بالاتر و PHP ۸.۱ یا جدیدتر نیاز دارد. این افزونه تا وردپرس ۷.۰ تست شده است. برای استفاده از مجموعه کامل ابزارهای خرید، نصب ووکامرس ۷.۰ یا بالاتر الزامی است. با این حال، ابزارهای خرید اختیاری هستند و بخش اصلی چت و پایگاه دانش (Knowledge Base) روی هر سایت وردپرسی، حتی بدون ووکامرس، کار می‌کند.

فرآیند راه‌اندازی در یک توالی مشخص پنج مرحله‌ای انجام می‌شود:

  • نصب: افزونه از طریق مسیر افزونه‌ها $\rightarrow$ افزودن جدید نصب می‌شود. پس از فعال‌سازی، منوی Sohay در نوار کناری پیشخوان ظاهر می‌شود که شامل بخش‌های داشبورد، گفتگوها (Conversations)، مقالات KB، دسته‌بندی‌های KB، همگام‌سازی KB، تنظیمات و عیب‌یابی (Diagnostics) است.
  • یکپارچگی API: کاربر در مسیر Sohay $\rightarrow$ Settings ارائه‌دهنده را انتخاب و کلید خود را وارد می‌کند. کلیدهای OpenAI از platform.openai.com (گزینه پیش‌فرض) و کلیدهای Gemini از aistudio.google.com/apikey تهیه می‌شوند. این کلیدها پیش از ذخیره در پایگاه داده با استاندارد AES-256-GCM رمزنگاری می‌شوند و در محیط تنظیمات به‌صورت ماسک‌شده (ستاره‌دار) نمایش داده می‌شوند. همچنین این کلیدها از REST API وردپرس حذف شده‌اند تا فقط به سرویس مربوطه ارسال شوند.
  • حفاظت از هزینه‌ها: برای جلوگیری از قبض‌های غیرمنتظره و هزینه‌های نجومی، سقف مصرف روزانه در بخش تنظیمات تعریف شده است. دو سقف مجزا بر اساس توکن در روز وجود دارد که در نیمه‌شب UTC بازنشانی می‌شوند:
    • سقف کلی سایت: پیش‌فرض ۱,۰۰۰,۰۰۰ توکن در روز برای تمام بازدیدکنندگان.
    • سقف هر بازدیدکننده: پیش‌فرض ۱۰۰,۰۰۰ توکن در روز برای جلوگیری از اینکه یک کاربر یا ربات، کل بودجه روزانه را مصرف کند.
      تنظیم هر یک از این مقادیر روی ۰، آن سقف را غیرفعال می‌کند. وقتی سقف مصرف پر شود، افزونه تمام فراخوانی‌های ارائه‌دهنده را تا پایان روز متوقف می‌کند. علاوه بر این، یک محدودیت نرخ (Rate Limit) شامل ۲۰ درخواست چت در ۶۰ ثانیه برای هر بازدیدکننده تعبیه شده تا اسکریپت‌های مخرب را پیش از رسیدن به سقف توکن متوقف کند.
  • ساخت پایگاه دانش: مدیران در مسیر Sohay $\rightarrow$ KB Articles $\rightarrow$ Add New مقالات را می‌سازند. متون طولانی‌تر و جامع‌تر از پاسخ‌های تک‌خطی عملکرد بهتری دارند. توصیه می‌شود سوالاتی که واقعاً از مشتریان دریافت می‌کنید را بنویسید و حتماً یک مقاله «تماس با ما» به عنوان راهکار جایگزین (Fallback) بسازید تا سوالات خارج از موضوع به اپراتور انسانی ارجاع شوند.
  • همگام‌سازی: کاربران در مسیر Sohay $\rightarrow$ KB Sync، تب داشبورد را باز کرده و روی 'Sync All Articles' کلیک می‌کنند. این فرآیند در پس‌زمینه اجرا شده و مقالات طی یک یا دو دقیقه قابل جست‌وجو می‌شوند.

ربات چت هوشمند را به فروشگاه ووکامرس خود اضافه کنید (افزونه رایگان)

مکانیزم جست‌وجوی سه‌لایه

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

وقتی مشتری سوالی می‌پرسد، جست‌وجو در سه سطح (Tier) رخ می‌دهد:

۱. صفحات رسمی ووکامرس: ابتدا صفحات «شرایط خدمات»، «حریم خصوصی» و «مرجوعی و استرداد» بررسی می‌شوند. این صفحات اولویت اول را دارند چون نسخه‌های رسمی هستند که تنظیمات قانونی سایت به آن‌ها ارجاع می‌دهد.
۲. مقالات برچسب‌دار: سپس مقالاتی که برچسب Policy یا FAQ دارند بررسی می‌شوند.
۳. پایگاه دانش عمومی: سایر مقالات موجود در KB به عنوان آخرین گزینه برای یافتن پاسخ بررسی می‌شوند.

اگر بات در هیچ‌یک از این سه سطح پاسخی نیافت، برنامه‌ریزی شده تا به‌جای اختراع جواب، صادقانه بگوید که پاسخ را نمی‌داند. یک نکته فنی مهم: پایگاه دانش فارغ از اینکه ارائه‌دهنده چت (Gemini یا OpenAI) چه کسی باشد، برای ایندکس و جست‌وجو از زیرساخت OpenAI استفاده می‌کند. بنابراین اگر کاربر Gemini را انتخاب کند اما بخواهد از پایگاه دانش استفاده کند، باید حتماً یک کلید OpenAI فعال در تنظیمات ذخیره کرده باشد. در غیر این صورت، بات همچنان پاسخ می‌دهد اما دیگر به مقالات مراجعه نمی‌کند و به‌جای توقف کامل، پاسخ را بدون مشورت با KB می‌دهد.

ابزارهای زنده ووکامرس

در فروشگاه‌های ووکامرسی، هفت ابزار خاص به‌طور خودکار فعال می‌شوند. یکی برای جست‌وجوی کلی در پایگاه دانش (sohaychat-kb/get-information) و شش مورد برای دسترسی به وضعیت زنده فروشگاه است:

  • جست‌وجوی کاتالوگ (sohaychat-wc/search-catalog): برای مدیریت پرسش‌های مرور محصولات مثل «ژاکت‌های ضدآب زیر ۱۰۰ دلار» یا «چه کالاهایی در تخفیف هستند؟».
  • بررسی کاتالوگ (sohaychat-wc/lookup-catalog): بازیابی کلی و عمومی محصولات کاتالوگ.
  • جزئیات محصول (sohaychat-wc/get-product): استخراج دقیق اطلاعات یک محصول خاص، شامل تمام متغیرهای آن (رنگ، سایز و...).
  • جست‌وجوی سیاست‌ها (sohaychat-wc/search-shop-policies-and-faqs): اجرای همان جست‌وجوی سه‌لایه برای مسائل ارسال، مرجوعی و پرداخت.
  • خواندن سبد خرید (sohaychat-wc/get-cart): بررسی کالاهای فعلی که مشتری در سبد خود قرار داده است.
  • به‌روزرسانی سبد خرید (sohaychat-wc/update-cart): افزودن کالای جدید، تغییر تعداد یا حذف کالا. هر تغییر در این بخش همراه با یک دکمه Undo (لغو) است تا کاربر بتواند اشتباهات را سریعاً اصلاح کند.

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

محدودیت‌های آگاهانه

توسعه‌دهنده خط قرمز مشخصی برای فرآیند پرداخت رسم کرده است. چت‌بات نمی‌تواند پرداخت را انجام دهد یا سفارش را نهایی کند. بات فقط سبد خرید را پر کرده و سپس کاربر را به جریان استاندارد پرداخت ووکامرس هدایت می‌کند. این تصمیم برای جلوگیری از هرگونه Improvisation (بداهه) هوش مصنوعی در قوانین مالیاتی، سیستم‌های تشخیص تقلب یا درگاه‌های پرداخت است، جایی که هماهنگی ۱۰۰ درصدی بین درگاه و فروشگاه الزامی است.

همچنین، بات به تاریخچه سفارشات، سوابق شخصی مشتری یا هر داده‌ای از فرآیند پرداخت دسترسی ندارد. از نظر فنی، از نسخه ۱.۲.۰، ویجت در یک کانتینر ایزوله رندر می‌شود. این کار مانع از آن می‌شود که CSS قالب سایت باعث به‌هم ریختگی ظاهر چت شود، اما به این معناست که سایر اسکریپت‌های سایت نمی‌توانند محتوای داخل آن را اسکن کنند. در نتیجه، افزونه‌های ترجمه مثل TranslatePress و Weglot نمی‌توانند متن‌های داخلی چت را ترجمه کنند و ابزارهای تحلیل رفتار کاربر مثل Hotjar یا Clarity این ناحیه را به‌صورت فضای خالی ثبت می‌کنند. با این حال، صفحه‌خوان‌ها (Screen Readers) و ناوبری با کیبورد تحت تأثیر قرار نمی‌گیرند چون آن‌ها درخت دسترسی‌پذیری (Accessibility Tree) را می‌خوانند.

حریم خصوصی و ذخیره‌سازی

برخلاف بسیاری از سرویس‌های AI، Sohay از سرورهای خارجی برای تله‌متری، تحلیل‌های Phone-home یا فونت‌ها و دارایی‌های CDN شخص ثالث استفاده نمی‌کند. تمام گفتگوها در جداول سفارشی در پایگاه داده خود کاربر ذخیره می‌شوند. ترافیک خروجی فقط به api.openai.com و در صورت استفاده از Gemini به generativelanguage.googleapis.com محدود است.

تمام چت‌ها در بخش Sohay $\rightarrow$ Conversations قابل دسترسی هستند، جایی که تیم پشتیبانی می‌تواند آن‌ها را بخواند، جست‌وجو کند، بر اساس وضعیت فیلتر کند، به هم‌تیمی‌ها تخصیص دهد، پاسخ دهد، پین کند و در نهایت ببندد. گفتگوهایی که به‌صورت Soft-delete حذف شده‌اند پس از ۳۰ روز و لاگ‌ها پس از ۷ روز به‌طور کامل از دیتابیس پاک می‌شوند.

برای صاحب فروشگاه‌های اروپایی، امکان رعایت GDPR از طریق قابلیت خروجی گرفتن (Export) و حذف کامل داده‌های گفتگو فراهم شده است. لازم به ذکر است که در فروشگاه‌ها، محتویات سبد خرید به ارائه‌دهنده AI ارسال و همراه با گفتگو ذخیره می‌شود تا وقتی بازدیدکننده به عقب اسکرول می‌کند، کارت سبد خرید همچنان قابل مشاهده باشد.

شخصی‌سازی و عملکرد

برای حفظ سرعت سایت، تنها یک لانچر بسیار سبک (حدود ۸ کیلوبایت) در هر صفحه بارگذاری می‌شود و بسته کامل چت فقط زمانی دانلود می‌گردد که بازدیدکننده واقعاً ویجت چت را باز کند.

توسعه‌دهندگان می‌توانند با استفاده از ۴۸ فیلتر و ۱۲ اکشن (که همگی با پیشوند sohaychat_ شروع می‌شوند) تجربه کاربری را شخصی‌سازی کنند. برای مثال، برای مخفی کردن بات در صفحات خاص، می‌توان از فیلتر sohaychat_should_render_widget استفاده کرد:

add_filter( 'sohaychat_should_render_widget', function ( $enabled ) { if ( ! $enabled ) { return false; } return function_exists( 'is_shop' ) && ( is_shop() || is_product() ); } );

این قطعه کد باعث می‌شود چت در تمام سایت مخفی شده و فقط در صفحات فروشگاه و محصولات نمایش داده شود. همچنین کاربران می‌توانند با برداشتن تیک "Show widget" در تنظیمات، ویجت را به‌طور کامل غیرفعال کنند.

Sohay به‌صورت رایگان در WordPress.org عرضه شده و سازگاری خود را با HPOS و Cart-Checkout-Blocks اعلام کرده است، به این معنی که کاربران بنر «افزونه تایید نشده» (uncertified plugin) را نخواهند دید.

گام بعدی شما

  • اگر فروشگاه ووکامرسی دارید، افزونه را نصب کرده و ابتدا یک مقاله «تماس با ما» برای مدیریت سوالات خارج از موضوع بسازید.
  • سقف توکن‌های روزانه را متناسب با بودجه API خود تنظیم کنید تا با ترافیک ناگهانی مواجه نشوید.
  • برای تست دقت، سوالاتی درباره موجودی دقیق کالاهای متغیر (سایز و رنگ) بپرسید تا قدرت اتصال زنده را بسنجید.

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

چرا این موضوع مهم است؟

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

تأثیر برای ایران

به‌دلیل تحریم‌ها، دسترسی به APIهای OpenAI و Gemini برای توسعه‌دهندگان ایرانی نیازمند واسط یا تغییر IP است؛ اما این افزونه مسیری سریع برای پیاده‌سازی دستیار فروش هوشمند در فروشگاه‌های داخلی فراهم می‌کند.

·نگاه ما
تحریریه دات‌هوش

جدا کردن لایه استنتاج از لایه داده‌های زنده در Sohay، یک پیاده‌سازی عملی از الگوی RAG است که ریسک توهم را به حداقل می‌رساند. نکته کلیدی اینجاست که توسعه‌دهنده به‌جای ساخت یک مدل اختصاصی، روی زیرساخت ارائه‌دهندگان بزرگ متمرکز شده تا هزینه نگهداری را صفر کند. این رویکرد نشان می‌دهد که آینده ابزارهای AI در وردپرس، نه در مدل‌های داخلی، بلکه در «اتصالات هوشمند» به APIهای خارجی است.

منابع

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

گفتگو

پنج‌شنبه‌های هوش‌محور

بسته‌ی هفتگی دات‌هوش

۵ خبر، ۲ ابزار، ۱ پرامپت در هر شماره. به‌زودی راه‌اندازی می‌شود — هر پنج‌شنبه صبح.

خبر کلیدی
ابزار کاربردی
پرامپت حرفه‌ای
تحلیل پژوهش
به‌زودی
زاویه‌ی ایرانی
به‌زودی
تمرین این هفته
به‌زودی

راهنماهای دات‌هوش

راهنماهای کاربردیِ دات‌هوش برای کار با هوش مصنوعی — از همین‌جا شروع کنید:

دات‌هوش

راهنمای فارسی هوش مصنوعی — با نگاه به ایران

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