اتصال API هوش مصنوعی به سایت وردپرس؛ ساخت چت‌بات اختصاصی

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

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

آخرین به‌روزرسانی: ۱۱ آبان ۱۴۰۵ — امکانات AI Client و Connectors از یادداشت‌های رسمی توسعه‌دهندگان وردپرس ۷٫۰ و قیمت‌های API از صفحه‌های رسمی قیمت‌گذاری OpenAI و Anthropic در همین تاریخ برداشته شده‌اند.

چرا چت‌بات اختصاصی به جای افزونهٔ آماده؟

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

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

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

معماری یک چت‌بات امن در وردپرس

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

1. ویجت چت (مرورگر): یک کادر ساده که پیام کاربر را می‌گیرد و به سرور سایت خودتان می‌فرستد.
2. endpoint اختصاصی در وردپرس (سرور): با REST API وردپرس یک مسیر مثل /wp-json/mybot/v1/chat می‌سازید. این لایه درخواست را بررسی می‌کند، محدودیت تعداد پیام اعمال می‌کند و دستور سیستمی (System Prompt) را اضافه می‌کند.
3. ارائه‌دهندهٔ هوش مصنوعی: سرور وردپرس پیام را با کلید API به مدل می‌فرستد و جواب را برمی‌گرداند.

اگر با مفهوم API و اتصال سرویس‌ها آشنا نیستید، مقالهٔ اتصال خدمات سایت با API را بخوانید.

AI Client وردپرس ۷؛ اتصال بدون دردسر

تا قبل از وردپرس ۷٫۰، برای هر ارائه‌دهنده باید کد اختصاصی می‌نوشتید. حالا وردپرس یک AI Client داخلی دارد که به ارائه‌دهندهٔ خاصی وابسته نیست. مدیر سایت ارائه‌دهنده را در صفحهٔ تنظیمات ← Connectors وصل می‌کند (سه افزونهٔ رسمی برای OpenAI، Anthropic و Google منتشر شده) و کد شما فقط می‌گوید چه می‌خواهد. وردپرس درخواست را به مدل مناسبی می‌فرستد که روی سایت تنظیم شده است.

کلید API را می‌توانید با متغیر محیطی، ثابت PHP در فایل wp-config.php یا از همان صفحهٔ Connectors وارد کنید. طبق مستندات، کلیدهای ذخیره‌شده در دیتابیس رمزنگاری نمی‌شوند و فقط در رابط کاربری پوشیده نمایش داده می‌شوند؛ پس روی سرورهای اشتراکی، متغیر محیطی یا ثابت PHP امن‌تر است.

نمونه کد endpoint چت‌بات

این کد را در یک افزونهٔ ساده یا فایل functions.php قالب فرزند قرار دهید. یک مسیر REST می‌سازد، پیام را تمیز می‌کند و با دستور سیستمی مشخص به مدل می‌فرستد:

add_action('rest_api_init', function () {
    register_rest_route('mybot/v1', '/chat', [
        'methods'             => 'POST',
        'permission_callback' => '__return_true',
        'callback'            => function (WP_REST_Request $req) {
            $msg = sanitize_textarea_field($req->get_param('message'));
            if ($msg === '' || mb_strlen($msg) > 1000) {
                return new WP_Error('bad_request', 'پیام نامعتبر است', ['status' => 400]);
            }
            $reply = wp_ai_client_prompt($msg)
                ->using_system_instruction('تو پشتیبان فروشگاه هستی. فقط درباره محصولات و سفارش‌ها کوتاه و فارسی جواب بده.')
                ->using_temperature(0.3)
                ->using_max_tokens(400)
                ->generate_text();
            if (is_wp_error($reply)) {
                return new WP_Error('ai_error', 'فعلاً پاسخ‌گو نیستیم', ['status' => 503]);
            }
            return ['reply' => wp_kses_post($reply)];
        },
    ]);
});

قبل از نمایش ویجت، با متد is_supported_for_text_generation() بررسی کنید که اصلاً ارائه‌دهنده‌ای روی سایت تنظیم شده باشد. این بررسی هیچ درخواستی به API نمی‌فرستد. سمت مرورگر هم کافی است با fetch پیام را به آدرس /wp-json/mybot/v1/chat بفرستید و جواب را نمایش دهید.

نمونه کد ویجت سمت مرورگر

این تکه جاوااسکریپت پیام را به endpoint بالا می‌فرستد و جواب را برمی‌گرداند. nonce را با تابع wp_create_nonce و wp_localize_script در اختیار اسکریپت بگذارید تا درخواست‌های جعلی از سایت‌های دیگر رد شوند:

async function askBot(message) {
  const res = await fetch('/wp-json/mybot/v1/chat', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'X-WP-Nonce': myBot.nonce
    },
    body: JSON.stringify({ message })
  });
  const data = await res.json();
  return res.ok ? data.reply : 'فعلاً پاسخ‌گو نیستیم؛ کمی بعد دوباره امتحان کنید.';
}

کدام API هوش مصنوعی را انتخاب کنیم؟

برای چت‌بات پشتیبانی، معمولاً به قوی‌ترین مدل نیاز ندارید؛ مدل سریع و ارزان بهتر است. چند گزینهٔ رایج با قیمت رسمی امروز (به دلار برای هر یک میلیون توکن):

برای مقایسهٔ کامل قیمت‌ها جدول قیمت API مدل‌های هوش مصنوعی و برای ارزان‌ترین گزینه‌ها ارزان‌ترین مدل‌های هوش مصنوعی را ببینید. اگر دسترسی مستقیم به این شرکت‌ها برایتان سخت است، ارائه‌دهندگان واسط API مثل OpenRouter چند مدل را با یک کلید در اختیارتان می‌گذارند.

هزینه را چطور حساب کنیم؟

فرض کنید هر پیام با دستور سیستمی و چند پیام قبلی حدود ۱۵۰۰ توکن ورودی و ۳۰۰ توکن خروجی دارد. با مدلی که ۰٫۱ دلار برای ورودی و ۰٫۵ دلار برای خروجی می‌گیرد، هر پیام حدود ۰٫۰۰۰۳ دلار می‌شود؛ یعنی ۱۰ هزار پیام در ماه حدود ۳ دلار. با مدل ۱ و ۵ دلاری همین حجم حدود ۳۰ دلار خرج دارد.

چت‌بات را با اطلاعات سایت خودتان آموزش دهید

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

• دستور سیستمی غنی: اطلاعات ثابت مثل ساعت کاری، شرایط ارسال و مرجوعی را مستقیم در دستور سیستمی بنویسید. برای سایت‌های کوچک همین کافی است.
• جست‌وجو و تزریق محتوا (RAG): برای سایت‌های بزرگ، قبل از ارسال سؤال به مدل، مرتبط‌ترین نوشته‌ها یا محصولات را با جست‌وجوی وردپرس پیدا کنید و همراه سؤال بفرستید. روش کامل را در RAG چیست؟ توضیح داده‌ایم.

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

راه‌اندازی قدم‌به‌قدم در پنج مرحله

1. تهیهٔ کلید API: در پنل ارائه‌دهندهٔ انتخابی حساب بسازید، کلید بگیرید و همان ابتدا سقف خرج ماهانه بگذارید.
2. اتصال در وردپرس: افزونهٔ رسمی ارائه‌دهنده را نصب کنید و کلید را در «تنظیمات ← Connectors» یا به‌صورت ثابت در wp-config.php وارد کنید.
3. ساخت endpoint: کد نمونهٔ بالا را در یک افزونهٔ اختصاصی قرار دهید تا با تغییر قالب از بین نرود.
4. نوشتن دستور سیستمی: نقش، لحن، محدودهٔ موضوعی و اطلاعات ثابت فروشگاه را دقیق بنویسید و بگویید اگر جوابی را نمی‌داند، کاربر را به پشتیبانی انسانی ارجاع دهد.
5. آزمایش و انتشار: ده‌ها سؤال واقعی مشتری‌ها، از جمله سؤال‌های بی‌ربط و تلاش برای فریب دادن ربات، را امتحان کنید و بعد ویجت را برای همه فعال کنید.

امنیت و کنترل هزینه

• محدودیت تعداد پیام: برای هر IP یا کاربر مثلاً حداکثر ۲۰ پیام در ساعت بگذارید (با Transients وردپرس ساده پیاده می‌شود).
• سقف هزینه در پنل ارائه‌دهنده: در داشبورد OpenAI یا Anthropic سقف خرج ماهانه تعیین کنید تا یک حملهٔ ربات حسابتان را خالی نکند.
• محدود کردن طول پیام و پاسخ: مثل نمونه کد بالا، پیام‌های طولانی را رد کنید و max_tokens را پایین نگه دارید.
• اعتبارسنجی درخواست: با nonce وردپرس مطمئن شوید درخواست از صفحهٔ سایت خودتان آمده است.
• حریم خصوصی: به کاربر بگویید پیام‌ها برای پردازش به سرویس هوش مصنوعی ارسال می‌شوند و اطلاعات حساس (مثل شماره کارت) نفرستد.

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

سؤالات متداول

آیا ساخت چت‌بات وردپرس بدون کدنویسی ممکن است؟

بله. افزونه‌هایی مثل AI Engine، AI Agent سایت‌گراند و Tidio چت‌بات آماده دارند. اما برای کنترل کامل روی جواب‌ها و هزینه، روش اختصاصی این مقاله بهتر است.

کدام نسخهٔ وردپرس لازم است؟

AI Client و صفحهٔ Connectors از وردپرس ۷٫۰ اضافه شده‌اند. در نسخه‌های قدیمی‌تر همان معماری را با فراخوانی مستقیم API پیاده کنید.

آیا چت‌بات می‌تواند وضعیت سفارش ووکامرس را بگوید؟

بله، اما مدل نباید مستقیم به دیتابیس دسترسی داشته باشد. در endpoint خودتان شمارهٔ سفارش و شماره موبایل را بررسی کنید، وضعیت را از ووکامرس بخوانید و فقط همان را به مدل بدهید تا جواب فارسی و طبیعی بسازد.

چت‌بات فارسی را خوب می‌فهمد؟

مدل‌های اصلی امروز فارسی را روان می‌فهمند و می‌نویسند. در دستور سیستمی صریحاً بخواهید جواب‌ها فارسی، کوتاه و محاوره‌ای مؤدبانه باشد و اصطلاحات فنی را ساده توضیح دهد.

منابع و مراجع