چت‌بات فارسی ۲۰۲۶: راهنمای API

چت‌بات فارسی، دستیاری است که با API هوش مصنوعی (OpenAI، Claude، Gemini) به زبان فارسی به مشتریان پاسخ می‌دهد و برخلاف ابزارهای عمومی مثل ویرا یا گپ‌جی‌پی‌تی، می‌توانید آن را اختصاصاً برای محصول یا سایت خودتان بسازید و به CRM و تلگرام‌تان وصل کنید. نکته مهم برای توسعه‌دهندگان ایرانی این است که ساخت این چت‌بات نیازمند دسترسی پایدار به API این مدل‌ها از داخل ایران است — چیزی که معمولاً با VPN یا کارت بانکی خارجی گره خورده. با 1xAi این وابستگی از میان می‌رود: با SDK استاندارد OpenAI یا Anthropic، بدون VPN و بدون کارت خارجی، مستقیماً به کلید API خودتان از داشبورد 1xai.ir متصل می‌شوید و چت‌بات را روی داده‌های خودتان می‌سازید، نه روی یک ربات عمومی از پیش‌ساخته.

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

افشای شفاف: ما در 1xAi همان درگاهی را اداره می‌کنیم که در این راهنما توضیح می‌دهیم؛ یعنی نویسنده این متن، اپراتور همان زیرساخت است، نه یک ناظر بی‌طرف بیرونی.

در 1xAi این سه لایه را به‌صورت یکجا فراهم می‌کنیم: مدل‌های OpenAI، Claude و Gemini از طریق یک درگاه واحد با آدرس پایه https://1xai.ir/v1، بدون نیاز به فیلترشکن یا کارت بانکی خارجی، با قیمت‌گذاری تومانی که هر روز ساعت ۹ صبح به‌وقت تهران با نرخ بازار همگام می‌شود. این API با هر SDK استاندارد سازگار با OpenAI کار می‌کند و کلید API از داشبورد 1xai.ir صادر می‌شود.

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

چت‌بات فارسی چیست و چرا برای پشتیبانی مشتریان مهم است؟

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

برای یک کسب‌وکار ایرانی، داشتن چت‌بات فارسی اختصاصی چند مزیت عملی دارد:

• پاسخ‌دهی ۲۴/۷ به سوالات مشتری بدون نیاز به نیروی انسانی در ساعات غیرکاری
• کاهش بار تیم پشتیبانی با خودکارسازی سوالات تکراری مثل بازگشت وجه، وضعیت سفارش یا شرایط استفاده
• پاسخ فوری و طبیعی به فارسی، به‌جای متن ترجمه‌شده یا نامفهوم
• جمع‌آوری داده مکالمات برای بهبود محصول و شناسایی نیازهای فروش

ابزارهایی مثل ویرا یا گپ‌جی‌پی‌تی چت‌بات‌های عمومی‌منظوره‌اند — برای گفت‌وگوی آزاد طراحی شده‌اند، نه برای این‌که فقط درباره محصول شما صحبت کنند یا مستقیماً به سایت، تلگرام یا CRM شما وصل شوند. تفاوت اصلی یک چت‌بات پشتیبانی واقعی، محدود بودن دانش آن به داده‌های شماست، نه دسترسی به کل اینترنت. برای همین، ساخت چنین ربات‌هایی معمولاً از طریق API انجام می‌شود، نه اپ چت عمومی؛ برای نمونه، مدل deepseek-chat روی گیت‌وی 1xAi در ۳۰ روز اخیر ۱٬۰۸۳ درخواست را با نرخ موفقیت ۱۰۰٪ پردازش کرده — نمونه‌ای از پایداری زیرساخت لازم برای پاسخ‌گویی مداوم به مشتری. برای کسب‌وکارهایی که نمی‌خواهند خودشان کد بزنند، تیم 1xAi از طریق فرم درخواست سفارشی چت‌بات پشتیبانی، یکپارچگی وب‌سایت/تلگرام یا اتوماسیون اختصاصی می‌سازد.

تنظیم API و اعتماد‌سازی: بدون VPN، بدون کارت خارجی

برای استفاده از OpenAI یا Claude از داخل ایران به یک درگاه نیاز دارید که هم تحریم‌ها را دور بزند و هم پرداخت تومانی بپذیرد؛ ما در 1xAi همین زیرساخت را اداره می‌کنیم و این افشای صریح لازم است چون این متن را همان تیمی نوشته که 1xai.ir را می‌سازد. کلید API که از داشبورد ما صادر می‌شود، هر SDK استاندارد OpenAI و همچنین SDKهای رسمی Anthropic و Google GenAI را بدون تغییر پشتیبانی می‌کند، چون اندپوینت‌های اختصاصی /anthropic و /gemini هم روی همین گیت‌وی فعال هستند.

مراحل ثبت‌نام و تنظیم کلید API

1. به https://1xai.ir بروید و با شماره موبایل ایرانی ثبت‌نام کنید.
2. حساب را از طریق زرین‌پال شارژ کنید؛ حداقل شارژ ۱٬۰۰۰ تومان است.
3. از داشبورد یک کلید با پیشوند 1xai-… بسازید یا پیش از نوشتن کد، در پلی‌گراند وب همان داشبورد مدل را تست کنید.
4. مدل‌های در دسترس و قیمت لحظه‌ای آن‌ها را در https://1xai.ir/models بررسی کنید.

نکته امنیتی قابل‌راستی‌آزمایی: طبق داده‌های عملیاتی خودمان، آی‌پی، کوکی و user-agent مشتری هرگز به ارائه‌دهنده اصلی نمی‌رسد، چون هر درخواست از زیرساخت 1xAi دوباره ارسال می‌شود.

مارک‌آپ ثابت، نرخ روزانه

بخش ثابت قیمت‌گذاری ما مارک‌آپ ۲۰ درصدی روی قیمت رسمی هر مدل است؛ نرخ دلار در محاسبه هر روز ساعت ۰۹:۰۰ تهران با بازار همگام می‌شود، پس عددها را باید همیشه از https://1xai.ir/pricing خواند نه حفظ کرد. جدول زیر قیمت ورودی هر مدل را به تومان نشان می‌دهد و با همان نرخ روزانه به‌روز می‌شود:

مدل	قیمت ورودی (هر ۱M توکن، با مارک‌آپ)	آمار ۳۰ روزه گیت‌وی
gpt-5.5	۱٬۳۶۳٬۸۰۰ تومان	—
gpt-4.1	۵۴۵٬۵۲۰ تومان	—
claude-sonnet-5	۵۴۵٬۵۲۰ تومان	—
deepseek-chat	۷۶٬۳۷۳ تومان	۱٬۰۸۳ درخواست، ۱۰۰٪ موفقیت

نمونه فراخوانی با base_url گیت‌وی:

from openai import OpenAI

client = OpenAI(
    api_key="1xai-YOUR_KEY",
    base_url="https://1xai.ir/v1"
)

response = client.chat.completions.create(
    model="gpt-4.1",
    messages=[{"role": "user", "content": "سلام، یک چت بات فارسی برای پشتیبانی مشتری پیشنهاد بده"}]
)
print(response.choices[0].message.content)

برای ادغام سفارشی — مثل چت بات فارسی روی تلگرام یا وب‌سایت — می‌توانید از فرم https://1xai.ir/contact درخواست بدهید تا تیم ما آن را برایتان بسازد.

معماری چت‌بات: تشخیص نیت، حافظه متن‌محور و بازگشت‌دهندگی

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

لایه تشخیص نیت معمولاً با یک system prompt محدودکننده پیاده می‌شود که مدل را به حوزه مشخصی (مثلاً محصولات یک فروشگاه) قفل می‌کند و در صورت خروج از آن حوزه، یک نشانه قابل‌تشخیص در خروجی می‌گذارد. لایه حافظه در نسخه ساده همان آرایه پیام‌های اخیر است؛ در تولید واقعی باید در دیتابیس ذخیره و بر اساس شناسه کاربر بازیابی شود. لایه بازگشت‌دهندگی با جست‌وجوی یک عبارت کلیدی در پاسخ مدل (مثل NEED_HUMAN) مکالمه را به تیم پشتیبانی منتقل می‌کند.

نمونه پیاده‌سازی (Node.js + OpenAI SDK روی 1xai.ir/v1)

// نصب: npm install openai dotenv
require('dotenv').config();
const OpenAI = require('openai');

const client = new OpenAI({
  apiKey: process.env.OPENAI_API_KEY, // کلید با پیشوند 1xai-...
  baseURL: 'https://1xai.ir/v1', // دروازه 1xAi
});

let conversationHistory = []; // در تولید، از دیتابیس بخوانید/بنویسید

const systemPrompt = `تو دستیار پشتیبانی فروشگاه آنلاین "فروشگاه من" هستی.
فقط درباره محصولات ما، سفارش‌ها، بازگشت پول و شرایط استفاده پاسخ بده.
اگر سوالی خارج از این حوزه بود یا مطمئن نبودی، دقیقاً بنویس: "NEED_HUMAN".`;

async function askBot(userMessage) {
  conversationHistory.push({ role: 'user', content: userMessage });

  const messages = [
    { role: 'system', content: systemPrompt },
    ...conversationHistory.slice(-10), // حافظه کوتاه‌مدت: ۱۰ پیام آخر
  ];

  const completion = await client.chat.completions.create({
    model: 'gpt-4.1', // نام مدل طبق 1xai.ir/models
    messages,
  });

  const reply = completion.choices[0].message.content;
  conversationHistory.push({ role: 'assistant', content: reply });

  if (reply.includes('NEED_HUMAN')) {
    return 'در حال انتقال شما به همکاران پشتیبانی انسانی...';
  }
  return reply;
}

askBot('سفارش من کی ارسال می‌شود؟').then(console.log);

نکته کلیدی این است که هر سه لایه در یک تابع ساده جمع می‌شوند: system prompt نیت را محدود می‌کند، آرایه conversationHistory حافظه را تأمین می‌کند، و بررسی رشته NEED_HUMAN بازگشت‌دهندگی را فعال می‌کند. برای پیاده‌سازی سفارشی‌تر — مثل اتصال حافظه به دیتابیس مشتریان یا انتقال خودکار به تلگرام پشتیبانی — می‌توانید از فرم درخواست سفارشی 1xAi استفاده کنید که تیم 1xAi خود چت‌بات را برای کسب‌وکار می‌سازد.

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

چت‌بات فارسی چیست و چه تفاوتی با چت‌بات‌های عمومی مثل ویرا یا گپ‌جی‌پی‌تی دارد؟

چت‌بات فارسی، دستیار هوش مصنوعی است که متن و نیت فارسی را به‌طور بومی پردازش می‌کند. ابزارهایی مثل ivira.ai یا gapgpt.app چت‌بات‌های عمومی و آماده مصرف نهایی هستند، اما اگر بخواهید چت‌بات اختصاصی برای سایت، تلگرام یا CRM خودتان بسازید که فقط درباره محصول شما پاسخ دهد، باید مستقیماً از API مدل‌هایی مثل gpt-5.5 یا Claude استفاده کنید.

چطور بدون VPN و بدون کارت بانکی خارجی به OpenAI یا Claude از ایران دسترسی پیدا کنم؟

از طریق درگاهی مثل 1xai.ir می‌توانید با یک کلید `1xai-…` و آدرس پایه `https://1xai.ir/v1`، مستقیماً و بدون VPN با SDKهای استاندارد OpenAI، Anthropic و Google GenAI کار کنید. پرداخت به تومان و از طریق زرین‌پال انجام می‌شود و کلید از داشبورد 1xai.ir صادر می‌شود؛ IP و اطلاعات کاربر شما هرگز به سرور اصلی ارائه‌دهنده نمی‌رسد.

هزینه استفاده از API برای چت‌بات فارسی به تومان چقدر است؟

هزینه بر اساس مدل انتخابی و تعداد توکن‌های ورودی و خروجی متغیر است. 1xAi روی قیمت رسمی هر مدل مارک‌آپ ۲۰ درصدی اعمال می‌کند و نرخ دلار محاسبه هر روز ساعت ۰۹:۰۰ تهران با بازار همگام می‌شود؛ بنابراین قیمت تومانی لحظه‌ای هر مدل را از https://1xai.ir/pricing بخوانید. حداقل شارژ حساب ۱٬۰۰۰ تومان است.

آیا می‌توانم از مدل‌های Claude، Gemini و DeepSeek هم با همان کلید استفاده کنم؟

بله، یک کلید واحد از 1xai.ir همزمان OpenAI، Anthropic (Claude)، Google (Gemini) و DeepSeek را پوشش می‌دهد و مسیریابی بر اساس نام مدل انجام می‌شود. اندپوینت‌های اختصاصی `/anthropic` و `/gemini` ویژگی‌های اختصاصی مثل کش پرامپت در Claude را هم حفظ می‌کنند.

آیا مدل‌های جدید Claude محدودیت خاصی در تنظیمات دارند؟

بله، مدل‌های نسل ۵ Claude یعنی claude-sonnet-5، claude-fable-5 و claude-opus-5 پارامترهای temperature و top_p و همچنین prefill پیام دستیار را نمی‌پذیرند، پس هنگام یکپارچه‌سازی چت‌بات باید این تنظیمات را حذف کنید.