اتصال وردپرس به هوشوانا

بسیاری از افزونه‌های هوش مصنوعی وردپرس با API سازگار با OpenAI کار می‌کنند. اگر افزونه اجازه‌ی تغییر آدرس پایه (Endpoint یا Base URL) را بدهد، می‌توانید آن را به هوشوانا وصل کنید. در این راهنما افزونه‌ی AI Engine از Meow Apps را مثال می‌زنیم و بعد روش کلی برای افزونه‌های دیگر را می‌گوییم.

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

• چت‌بات فارسی روی سایت با مدل‌هایی مثل GPT و Gemini.
• کمک در نوشتن و ویرایش محتوا داخل پیشخوان وردپرس.
• پرداخت ریالی و کنترل هزینه با قوانین کلید.

پیش‌نیازها

1. حساب کاربری در هوشوانا.
2. یک کلید API از صفحه‌ی کلیدها.
3. اعتبار کافی در کیف پول.
4. سایت وردپرسی با دسترسی مدیر و امکان نصب افزونه.
5. هاستی که بتواند به آدرس هوشوانا درخواست HTTPS بفرستد.

راه‌اندازی با AI Engine

1. از افزونه‌ها > افزودن افزونه‌ی AI Engine را نصب و فعال کنید.
2. به تنظیمات AI Engine بروید و بخش مربوط به محیط‌های هوش مصنوعی (Environments for AI) را پیدا کنید.
3. یک محیط تازه اضافه کنید و نوع آن را OpenAI بگذارید.
4. در فیلد API Key کلید هوشوانا (hv-...) را وارد کنید.
5. اگر فیلدی برای آدرس سفارشی (Endpoint یا Base URL) وجود دارد، این مقدار را بنویسید:

https://hooshvana.ir/api/v1

6. در تنظیمات مدل یا چت‌بات، مدل را انتخاب کنید. اگر فهرست فقط نام مدل‌های OpenAI را نشان می‌دهد و امکان نوشتن نام دلخواه هست، شناسه‌ی کامل را بنویسید، مثلاً openai/gpt-4o-mini.
7. ذخیره کنید.

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

افزودن چت‌بات به صفحه

بعد از تنظیم محیط، در بخش Chatbots افزونه یک چت‌بات بسازید یا چت‌بات پیش‌فرض را ویرایش کنید: محیط هوشوانا را برای آن انتخاب کنید، پیام آغازین و دستورالعمل (Instructions) را به فارسی بنویسید و ذخیره کنید. بعد این شورت‌کد را در هر برگه یا نوشته بگذارید:

[mwai_chatbot]

اگر چند چت‌بات دارید، شناسه‌ی هر کدام را در شورت‌کد مشخص کنید، مثلاً [mwai_chatbot id="default"].

روش کلی برای افزونه‌های دیگر

هر افزونه‌ای که گزینه‌ای مثل «OpenAI Compatible»، «Custom Endpoint» یا «Base URL» دارد، معمولاً با هوشوانا کار می‌کند:

بعضی افزونه‌ها آدرس کامل نقطه‌ی پایانی را می‌خواهند. در آن صورت https://hooshvana.ir/api/v1/chat/completions را وارد کنید. افزونه‌هایی که آدرس api.openai.com را در کد ثابت کرده‌اند با هوشوانا کار نمی‌کنند.

بررسی اتصال

1. صفحه‌ای را که چت‌بات در آن است، در حالت خروج از حساب یا یک مرورگر دیگر باز کنید.
2. یک پیام فارسی بفرستید.
3. اگر پاسخ آمد، به گزارش‌ها بروید و درخواست /chat/completions را با مدل و هزینه ببینید.

مدل‌های پیشنهادی

برای چت‌بات عمومی مدل ارزان و سریع کافی است. شناسه‌ها نمونه هستند؛ فهرست کامل در کاتالوگ مدل‌ها است.

کنترل هزینه

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

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

رفع اشکال

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