
ساخت چتبات برای سایت و بازوی بله با API هیبانا
راهنمای ساخت چتبات پشتیبانی برای سایت و بازوی پیامرسان بله با API هیبانا و پایتون؛ از پیام سیستمی و حافظهٔ گفتوگو تا کنترل هزینه و امنیت کلید.
۴ دقیقه مطالعه
وردپرس را به API هوش مصنوعی هیبانا وصل کنید؛ با افزونهٔ AI Engine یا یک تابع PHP آزمودهشده، همراه خلاصهٔ خودکار نوشتهها و رفع خطای cURL error 28.

نوشتن خلاصهٔ نوشتهها، پیشنهاد عنوان، نوشتن توضیح محصول در ووکامرس یا ساخت یک دستیار پاسخگو در سایت: همهٔ اینها با وصل کردن وردپرس به یک API هوش مصنوعی شدنی است. در این مطلب دو راه را قدمبهقدم میرویم: افزونهٔ AI Engine با تنظیم یک آدرس سفارشی، و یک تابع کوتاه PHP بدون هیچ افزونهای. بعد یک کار واقعی، یعنی خلاصهٔ خودکار نوشتهها، را میسازیم و رایجترین خطای این اتصال را رفع میکنیم. همه را روی وردپرس ۷٫۱٫۳ و API واقعی هیبانا آزمودهایم و خروجیها و هزینهها واقعیاند.
API هیبانا با OpenAI سازگار است: نشانی پایه https://api-ai.hibanacloud.ir/v1 است و هر ابزاری که اجازه میدهد نشانی OpenAI را عوض کنید، با یک کلید هیبانا به همهٔ مدلهای لیست مدلها وصل میشود. اگر با خود API آشنا نیستید، اول راهنمای API هوش مصنوعی را بخوانید. برای این مطلب لازم دارید:
پیشنهاد ما این است که برای سایت یک کلید جداگانه بسازید تا هزینهٔ سایت از کارهای دیگرتان جدا بماند و اگر کلید فاش شد، فقط همان را حذف کنید.
AI Engine افزونهٔ هوش مصنوعیای است که طبق مخزن رسمی وردپرس بیش از ۹۰ هزار نصب فعال دارد. نسخهٔ ۳٫۹٫۴ آن نوعی محیط به نام «Custom (OpenAI-Compatible)» دارد که میتوان آن را به هر سرویس سازگار با OpenAI وصل کرد. مراحل:
https://api-ai.hibanacloud.ir/v1 را بنویسید و در API Key کلید هیبانا را.در آزمایش ما فهرست ۱۰۹ مدل خوانده شد. نام مدلها همان کدهای هیبانا است، مثل openai/gpt-5-nano. بعد از ساخت محیط، با تابع PHP خود افزونه یک سؤال پرسیدیم:
global $mwai;echo $mwai->simpleTextQuery( 'در یک جمله بگو وردپرس چیست.', array( 'envId' => 'hibana', 'model' => 'openai/gpt-5-nano',) );hibana شناسهای است که ما به محیط دادیم. پاسخ حدود ۱۰ ثانیه بعد رسید:
وردپرس یک سیستم مدیریت محتوا (CMS) رایگان و متنباز است که با PHP و MySQL ساخته شده و به شما امکان میدهد وبسایت یا وبلاگ خود را بهراحتی ایجاد، مدیریت و سفارشیسازی کنید.از اینجا به بعد چتبات، ابزار نوشتن و بقیهٔ قابلیتهای AI Engine را میتوانید با همین محیط و مدلهای هیبانا به کار ببرید. یک نکته: AI Engine برای مدلهایی که خودش نمیشناسد، سقف خروجی را ۴٬۰۹۶ توکن ثبت کرد. اگر متنهای بلند لازم دارید، این سقف را در نظر داشته باشید.
اگر فقط یک کار مشخص دارید، لازم نیست افزونهٔ بزرگی نصب کنید. اول کلید را در wp-config.php تعریف کنید، نه در دیتابیس یا فایل قالب:
define( 'HIBANA_API_KEY', 'YOUR_API_KEY' );بعد این فایل را در wp-content/mu-plugins/hibana-ai.php بگذارید. اگر پوشهٔ mu-plugins وجود ندارد، آن را بسازید. افزونههای این پوشه همیشه فعالاند و با عوض شدن قالب از بین نمیروند:
<?php/** * Plugin Name: Hibana AI (helper) */ function hibana_ask( string $prompt, string $model = 'openai/gpt-5-nano' ) { $response = wp_remote_post( 'https://api-ai.hibanacloud.ir/v1/chat/completions', array( 'timeout' => 60, 'headers' => array( 'Authorization' => 'Bearer ' . HIBANA_API_KEY, 'Content-Type' => 'application/json', ), 'body' => wp_json_encode( array( 'model' => $model, 'messages' => array( array( 'role' => 'user', 'content' => $prompt ), ), ) ), ) ); if ( is_wp_error( $response ) ) { return $response; } $code = wp_remote_retrieve_response_code( $response ); $data = json_decode( wp_remote_retrieve_body( $response ), true ); if ( 200 !== $code ) { return new WP_Error( 'hibana_api', $data['error']['message'] ?? 'HTTP ' . $code ); } return $data['choices'][0]['message']['content'];}حالا هر جای سایت میتوانید hibana_ask() را صدا بزنید. آزمایش ما:
$answer = hibana_ask( 'در یک جمله بگو افزونهٔ وردپرس چیست.' );echo is_wp_error( $answer ) ? $answer->get_error_message() : $answer;افزونهٔ وردپرس یک ماژول نرمافزاری است که امکانات و قابلیتهای جدیدی به وبسایت وردپرس اضافه میکند و معمولاً بدون دستکاری در هستهٔ اصلی وردپرس کار میکند.این درخواست ۴٫۶ ثانیه طول کشید. تابع خطا را بهشکل WP_Error برمیگرداند؛ پس همیشه با is_wp_error() بررسی کنید. معنی خطاهایی مثل ۴۰۱ و ۴۰۲ را در راهنمای خطاهای ۴۰۱، ۴۰۲ و ۴۲۹ توضیح دادهایم.
با همین تابع، خلاصهٔ یک نوشته را میسازیم و در فیلد «چکیده» (excerpt) ذخیره میکنیم. $post_id شمارهٔ نوشتهٔ شماست:
$text = wp_strip_all_tags( get_post_field( 'post_content', $post_id ) );$summary = hibana_ask( "این نوشته را در حداکثر دو جمله خلاصه کن:\n\n" . $text ); if ( ! is_wp_error( $summary ) ) { wp_update_post( array( 'ID' => $post_id, 'post_excerpt' => $summary ) );}ما آن را روی یک نوشتهٔ ۴۵۵ کاراکتری دربارهٔ راهاندازی فروشگاه با ووکامرس اجرا کردیم و این چکیده ذخیره شد:
برای راهاندازی فروشگاه اینترنتی با وردپرس، ابتدا هاست و دامنه تهیه کرده، سپس وردپرس را نصب و افزونه ووکامرس را فعال کنید تا محصولات، سبد خرید و سفارشها مدیریت شوند و درگاه پرداخت از طریق همان افزونه متصل گردد. برای سرعت، تصاویر محصولات را فشرده کنید و افزونههای غیرضروری را نصب نکنید و در پایان صفحات قوانین بازگشت کالا و ارسال را بنویسید تا مشتریان با اطمینان خرید کنند.هزینهٔ این درخواست ۱٬۲۸۰ ریال بود: ۱۵۷ توکن ورودی و ۶۳۱ توکن خروجی. با اینکه پاسخ دو جمله بود، توکنهای خروجی زیاد شدند، چون این مدل پیش از پاسخ «فکر» میکند و آن توکنها هم حساب میشوند. منطق کلی را در توکن چیست و هزینهٔ API چطور حساب میشود خواندهاید. قیمت بهروز را در صفحهٔ GPT-5 nano ببینید.
متن تولیدشده را پیش از انتشار بخوانید. در همین نمونه مدل دو جمله نوشت، اما جملهها برای چکیده بیش از حد بلندند؛ اگر متن کوتاهتر میخواهید، سقف را با تعداد کلمه بدهید.
مهلت پیشفرض wp_remote_post پنج ثانیه است، اما پاسخ مدلهای هوش مصنوعی، بهویژه برای متنهای بلند، اغلب بیشتر طول میکشد. همان درخواست را بدون 'timeout' => 60 و با خواستن یک متن ۳۰۰ کلمهای فرستادیم:
Error: cURL error 28: Operation timed out after 5001 milliseconds with 0 bytes receivedراهحل همان 'timeout' => 60 در تابع بالاست. اما مهلت طولانی یعنی کاربر هم منتظر میماند؛ پس کارهای سنگین، مثل خلاصه کردن صدها نوشته، را هنگام بارگذاری صفحه انجام ندهید و آنها را با WP-Cron یا یک فرمان WP-CLI در پسزمینه اجرا کنید. پیش از کار دستهای، محدودیت نرخ درخواست را هم ببینید.
وردپرس از نسخهٔ ۷٫۰ یک کلاینت هوش مصنوعی در هسته دارد و صفحهٔ Connectors به بخش تنظیمات پیشخوان اضافه شده است. در این صفحه OpenAI، Anthropic و Google فهرست شدهاند، اما هر کدام به افزونهٔ ارائهدهندهٔ جداگانهای نیاز دارد. افزونهٔ رسمی «AI Provider for OpenAI» از تیم هوش مصنوعی وردپرس، در نسخهٔ ۱٫۲٫۰، نشانی api.openai.com را ثابت در کد دارد و جایی برای تغییر آن ندارد؛ پس فعلاً نمیشود آن را به هیبانا وصل کرد. هستهٔ وردپرس ابزارهای لازم برای نوشتن یک ارائهدهندهٔ سازگار با OpenAI را دارد، اما ما چنین افزونهای را نیازمودهایم. تا آن زمان، دو راه بالا مطمئنترند.
wp-config.php است. AI Engine کلید را در دیتابیس سایت نگه میدارد؛ پس دسترسی مدیر سایت را محدود نگه دارید.برای وصل کردن وردپرس به هوش مصنوعی، اگر امکانات آماده میخواهید، AI Engine را با محیط «Custom (OpenAI-Compatible)» و نشانی هیبانا تنظیم کنید. اگر یک کار مشخص دارید، همان تابع کوتاه hibana_ask() کافی است. در هر دو حالت مهلت درخواست را بلند بگذارید، کارهای سنگین را به پسزمینه بسپارید و خروجی را پیش از انتشار بخوانید. برای شروع، کلید API بگیرید و اگر میخواهید برای سایت یک دستیار پاسخگو بسازید، ساخت چتبات سایت و ربات بله را بخوانید.

راهنمای ساخت چتبات پشتیبانی برای سایت و بازوی پیامرسان بله با API هیبانا و پایتون؛ از پیام سیستمی و حافظهٔ گفتوگو تا کنترل هزینه و امنیت کلید.
۴ دقیقه مطالعه

پروتکل MCP به زبان ساده؛ میزبان، کلاینت و سرور چه میکنند، کدام ابزارها از آن پشتیبانی میکنند و چطور با مدلهای هیبانا یک سرور MCP را به کار بگیرید.
۶ دقیقه مطالعه

مقایسهٔ عملی Kilo Code و Cline و Cursor برای اتصال به API هوش مصنوعی از ایران؛ کدام کار میکند، چرا Cline توکن زیادی مصرف میکند و کدام مدل را انتخاب کنیم.
۲ دقیقه مطالعه
GPT، Claude، Gemini و دهها مدل دیگر، با پرداخت ریالی و یک API سازگار با OpenAI.