اتصال API هوش مصنوعی به وردپرس و ووکامرس

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

چرا هوش مصنوعی را به وردپرس وصل کنیم؟

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

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

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

روش اول: افزونه‌های هوش مصنوعی

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

1. امکان تعیین آدرس پایه (Base URL): اگر کلید خود را از یک ارائه‌دهندهٔ سازگار با OpenAI یا از درگاه واسط تهیه کرده‌اید، افزونه باید اجازهٔ تغییر آدرس پایه را بدهد.
2. انتخاب مدل: امکان وارد کردن نام مدل دلخواه، چون مدل‌ها مرتب عوض می‌شوند و مدل‌های قدیمی بازنشسته می‌شوند.
3. به‌روزرسانی منظم و نظرات کاربران: افزونهٔ رهاشده می‌تواند حفرهٔ امنیتی باشد.
4. محل ذخیرهٔ کلید: کلید باید فقط در سمت سرور استفاده شود و در کد جاوااسکریپت صفحه نمایش داده نشود.
5. پشتیبانی از راست‌چین و فارسی: رابط و خروجی باید با زبان فارسی مشکل نداشته باشد.

روش دوم: کدنویسی اختصاصی با PHP

اگر کنترل کامل می‌خواهید، می‌توانید با تابع داخلی wp_remote_post وردپرس مستقیماً به API درخواست بفرستید. ابتدا کلید را در فایل wp-config.php تعریف کنید تا در پایگاه داده یا کد قالب ذخیره نشود:

// wp-config.php
define( 'ELIN_AI_BASE_URL', 'BASE_URL' );
define( 'ELIN_AI_API_KEY', 'API_KEY' );
define( 'ELIN_AI_MODEL', 'MODEL_NAME' );

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

function elin_ai_complete( $prompt, $max_tokens = 600 ) {
    $response = wp_remote_post(
        rtrim( ELIN_AI_BASE_URL, '/' ) . '/chat/completions',
        array(
            'timeout' => 60,
            'headers' => array(
                'Authorization' => 'Bearer ' . ELIN_AI_API_KEY,
                'Content-Type'  => 'application/json',
            ),
            'body'    => wp_json_encode( array(
                'model'      => ELIN_AI_MODEL,
                'max_tokens' => $max_tokens,
                'messages'   => array(
                    array( 'role' => 'system', 'content' => 'تو یک نویسندهٔ حرفه‌ای محتوای فروشگاهی به زبان فارسی هستی.' ),
                    array( 'role' => 'user',   'content' => $prompt ),
                ),
            ) ),
        )
    );

    if ( is_wp_error( $response ) ) {
        return $response;
    }

    $data = json_decode( wp_remote_retrieve_body( $response ), true );
    return $data['choices'][0]['message']['content'] ?? new WP_Error( 'ai_error', 'پاسخ نامعتبر از سرویس' );
}

این تابع با هر سرویس سازگار با قالب OpenAI کار می‌کند؛ از جمله API اوپن‌ای‌آی، API دیپ‌سیک و OpenRouter.

نمونهٔ کاربردی: تولید توضیحات محصول در ووکامرس

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

function elin_generate_product_excerpt( $product_id ) {
    $product = wc_get_product( $product_id );
    if ( ! $product || $product->get_short_description() ) {
        return;
    }

    $attributes = array();
    foreach ( $product->get_attributes() as $attr ) {
        $attributes[] = wc_attribute_label( $attr->get_name() ) . ': ' .
            implode( '، ', $attr->get_options() );
    }

    $prompt = sprintf(
        "برای محصول «%s» یک توضیح کوتاه فروشگاهی در حداکثر ۶۰ کلمه بنویس. ویژگی‌ها: %s. اغراق نکن و ادعای تأییدنشده ننویس.",
        $product->get_name(),
        implode( ' | ', $attributes )
    );

    $text = elin_ai_complete( $prompt, 300 );
    if ( ! is_wp_error( $text ) ) {
        $product->set_short_description( wp_kses_post( $text ) );
        $product->save();
    }
}

چند نکته دربارهٔ این کد:

• این تابع را به‌جای اجرای خودکار هنگام بارگذاری صفحه، از طریق یک دکمه در پنل مدیریت، WP-CLI یا زمان‌بندی (Cron) اجرا کنید تا هر بازدید سایت هزینه ایجاد نکند.
• برای تعداد زیاد محصول، کار را در دسته‌های کوچک انجام دهید تا به محدودیت نرخ API برخورد نکنید.
• متن تولیدشده را پیش از انتشار بازبینی کنید؛ هوش مصنوعی ممکن است اطلاعات نادرست تولید کند.
• با wp_kses_post خروجی را پاک‌سازی کنید تا کد ناخواسته وارد سایت نشود.

کیفیت این متن‌ها به شدت به پرامپت بستگی دارد. در راهنمای مهندسی پرامپت روش نوشتن دستورهای دقیق را توضیح داده‌ایم.

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

برای ساخت چت‌بات، مهم‌ترین قانون این است که مرورگر کاربر هرگز مستقیماً به API هوش مصنوعی وصل نشود. معماری درست این است:

1. ویجت چت در صفحه، پیام کاربر را به یک endpoint اختصاصی در REST API وردپرس می‌فرستد.
2. سرور وردپرس پیام را بررسی می‌کند، محدودیت نرخ اعمال می‌کند و با تابع elin_ai_complete پاسخ را می‌گیرد.
3. پاسخ به ویجت برمی‌گردد و به کاربر نمایش داده می‌شود.

با این روش کلید API فقط روی سرور می‌ماند. برای پاسخ‌های دقیق‌تر، اطلاعات کلیدی فروشگاه مثل شرایط ارسال و مرجوعی را در پیام سیستمی قرار دهید.

کدام مدل برای وردپرس مناسب‌تر است؟

• تولید انبوه توضیحات محصول: مدل‌های اقتصادی مانند DeepSeek یا سطوح کم‌هزینهٔ OpenAI
• مقاله‌های طولانی و باکیفیت: مدل‌های قوی‌تر مانند Claude یا GPT سطح بالا
• تحلیل تصویر محصول: مدل‌های چندرسانه‌ای مانند Gemini
• چت‌بات با پاسخ سریع: مدل‌های سبک یا Groq با مدل‌های Llama

مقایسهٔ کامل مدل‌ها را در مقالهٔ GPT در برابر Claude و Gemini ببینید.

اتوماسیون محتوا با WP-CLI و زمان‌بندی

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

• WP-CLI: اگر به خط فرمان سرور دسترسی دارید، می‌توانید با دستور wp eval تابع تولید توضیحات را برای فهرستی از شناسه‌های محصول اجرا کنید. این روش برای اجرای یک‌باره روی کل فروشگاه مناسب است و به محدودیت زمان اجرای PHP در مرورگر برنمی‌خورد.
• WP-Cron یا Action Scheduler: ووکامرس از Action Scheduler برای کارهای پس‌زمینه استفاده می‌کند. می‌توانید برای هر محصول یک کار زمان‌بندی‌شده بسازید تا درخواست‌ها با فاصله ارسال شوند و فشاری به سرور و API وارد نشود.

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

ایده‌های دیگر برای ووکامرس

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

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

• کلید API را در wp-config.php یا متغیر محیطی نگه دارید، نه در تنظیمات قالب یا کد جاوااسکریپت.
• دسترسی به قابلیت‌های تولید محتوا را فقط به نقش‌های مدیر و ویرایشگر بدهید (با current_user_can).
• برای endpoint چت‌بات از nonce و محدودیت نرخ بر اساس IP یا کاربر استفاده کنید.
• برای هر درخواست max_tokens تعیین کنید و نتایج تکراری را با Transients کش کنید.
• مطمئن شوید هاست شما اجازهٔ اتصال خروجی به آدرس سرویس هوش مصنوعی را می‌دهد؛ برخی هاست‌ها درخواست‌های خروجی را محدود می‌کنند.

برای تخمین هزینه، مقالهٔ توکن و هزینهٔ API و برای محافظت از کلید، امنیت API Key هوش مصنوعی را بخوانید.

سؤالات متداول دربارهٔ هوش مصنوعی وردپرس

آیا برای اتصال هوش مصنوعی به وردپرس باید برنامه‌نویس باشم؟

خیر. با افزونه‌های آماده و وارد کردن API Key می‌توانید بدون کدنویسی شروع کنید. کدنویسی اختصاصی فقط برای نیازهای خاص یا کنترل بیشتر لازم است.

آیا محتوای تولیدشده با هوش مصنوعی برای سئو مضر است؟

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

کدام API برای ووکامرس به‌صرفه‌تر است؟

برای تولید انبوه محتوای کوتاه، مدل‌های اقتصادی مانند DeepSeek یا مدل‌های سبک OpenAI معمولاً به‌صرفه‌ترند. اگر می‌خواهید چند مدل را مقایسه کنید، اعتبار OpenRouter انتخاب خوبی است.

چرا افزونه با کلید من کار نمی‌کند؟

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

آیا هوش مصنوعی سرعت سایت را کم می‌کند؟

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

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