Opening (2-4 sentences)

اگر از داخل ایران کار می‌کنید و می‌خواهید ربات تلگرام هوشمند بسازید که با GPT یا Claude صحبت کند، خبر خوب این است که دیگر نیازی به VPN یا کارت خارجی نیست — 1xAi یک درگاه ایرانی فراهم کرده که OpenAI و Anthropic را با قیمت تومانی شفاف (۲۰ درصد بالاتر از نرخ رسمی) ارائه می‌دهد. در این آموزش گام‌به‌گام نشان می‌دهیم چگونه با python-telegram-bot و SDK استاندارد OpenAI/Claude، یک ربات واقعی بسازید — از ثبت‌نام BotFather تا دیپلوی روی سرور ایرانی، بدون هیچ ترفند یا پیچیدگی اضافی.

TL;DR

ما در 1xAi یک درگاه API برای دسترسی به OpenAI، Claude و Gemini از داخل ایران بدون VPN ارائه می‌دهیم — این بخش نشان می‌دهد چگونه با python-telegram-bot و SDK‌های استاندارد، یک ربات تلگرام تولید‌کننده متن واقعی بسازید، از ثبت‌نام BotFather تا مدیریت مکالمه و دیپلوی روی سرور ایرانی، بدون کارت بانکی خارجی یا تحریم‌شکن.

1xAi یک درگاه تجاری است که برای دسترسی به API‌های هوش مصنوعی از ایران کار می‌کند — این مقاله از داخل تیم 1xAi نوشته شده و تمام قیمت‌ها و داده‌های عملیاتی از 1xai.ir گرفته‌اند.

---

چرا 1xAi برای ربات‌های تلگرام ضروری است

هر ربات تلگرام هوش‌مند باید به یک مدل زبانی متصل شود — OpenAI GPT، Anthropic Claude یا Google Gemini. اما توسعه‌دهندگان ایرانی با سه مانع روبرو هستند: (۱) درگاه‌های رسمی OpenAI و Google در ایران کار نمی‌کنند، (۲) کارت‌های بانکی ایرانی پذیرفته نمی‌شوند، (۳) VPN استفاده کردن ریسک‌دار است و سرعت را کاهش می‌دهد.

1xAi این سه مانع را حل می‌کند: درگاه ما در ایران میزبان شده، تمام بیل‌ها به تومان و از طریق Zarinpal پرداخت می‌شوند، و SDK‌های OpenAI/Anthropic/Google بدون تغییر کار می‌کنند — فقط base URL را به https://1xai.ir/v1 تغییر دهید و API key از داشبورد 1xai.ir بگیرید.

---

مدل‌ها و قیمت‌ها: کدام را انتخاب کنید؟

قیمت‌گذاری 1xAi بر اساس قیمت رسمی هر ارائه‌دهنده بعلاوه ۲۰ درصد علاوه‌برای عملیات درگاه است، با نرخ ثابت ۳۰۰٬۰۰۰ تومان به ازای هر دلار.

مدل	ورودی (۱M توکن)	خروجی (۱M توکن)	بهترین برای
gpt-5.5	۱٬۸۰۰٬۰۰۰ تومان	۱۰٬۸۰۰٬۰۰۰ تومان	محتوای پیچیده، تحلیل عمیق
gpt-5	۴۵۰٬۰۰۰ تومان	۳٬۶۰۰٬۰۰۰ تومان	تعادل سرعت و کیفیت
gpt-4.1	۷۲۰٬۰۰۰ تومان	۲٬۸۸۰٬۰۰۰ تومان	کارایی بالا، سرعت
o3	۷۲۰٬۰۰۰ تومان	۲٬۸۸۰٬۰۰۰ تومان	استدلال منطقی، ریاضی
Claude 3.5 Sonnet	Anthropic pricing + ۲۰٪	[Anthropic pricing](https://www.anthropic.

ربات تلگرام با هوش مصنوعی چیست و چرا می‌سازیم؟

ربات تلگرام‌ای که به API هوش مصنوعی (GPT، Claude، Gemini) متصل است می‌تواند پاسخ‌های هوشمند و متنی بدهد — نه صرفاً دستورات ثابت از پیش برنامه‌ریزی‌شده.

تعریف و تفاوت با ربات‌های سنتی

ربات‌های تلگرام سنتی فقط دستورات دقیق را اجرا می‌کنند: یک دکمه برای شروع، یک فرمان برای لیست محصولات، یک پاسخ ثابت برای هر سؤال. اما ربات هوش مصنوعی متفاوت است — هر بار که کاربر پیامی می‌فرستد، آن پیام به مدل‌های زبانی مثل GPT-4.1 یا Claude ارسال می‌شود و ربات یک پاسخ منطقی و متناسب با متن ورودی تولید می‌کند. این ربات‌ها می‌توانند گفتگوی طبیعی داشته باشند، سؤالات فنی را پاسخ دهند، متن را خلاصه کنند یا حتی محتوا تولید کنند — همه به‌صورت خودکار و بدون نیاز به برنامه‌نویس برای هر حالت جدید.

کاربردهای عملی

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

چرا از 1xAi

ما در 1xAi یک دروازه‌ی API برای OpenAI، Anthropic و Google فراهم می‌کنیم که از داخل ایران بدون VPN و بدون نیاز به کارت بانکی خارجی قابل دسترسی است — این بخش مهم‌ترین مزیت است برای توسعه‌دهندگان ایرانی. یک کلید API واحد (1xai-...) از داخل داشبورد 1xai.ir کافی است؛ هر درخواست به مدل صحیح روت می‌شود (OpenAI، Claude یا Gemini) بر اساس نام مدل. قیمت‌گذاری شفاف و تومانی است: مثلاً GPT-4.1 هزینه‌ای 720,000 تومان برای هر میلیون توکن ورودی و 2,880,000 تومان برای خروجی دارد — این قیمت‌ها قیمت رسمی OpenAI ($2 و $8 به ترتیب) به‌علاوه 20% نشانه‌گذاری ثابت است، بدون هیچ شارژ پنهانی. شما می‌توانید از داشبورد 1xai.ir تست کنید، کلید بسازید و فوری با استفاده از base URL https://1xai.ir/v1 شروع کنید — تمام SDK‌های استاندارد (Python، Node.

ثبت‌نام ربات در BotFather و دریافت توکن

برای ساخت ربات تلگرام، ابتدا باید در BotFather ثبت‌نام کنید و یک توکن دریافت کنید — این توکن کلید دسترسی ربات شما به API تلگرام است.

مرحله ۱: جستجو و شروع BotFather

تلگرام را باز کنید و در جستجو @BotFather را تایپ کنید. این ربات رسمی تلگرام است که مسئول ایجاد و مدیریت تمام ربات‌ها است. پس از ورود به چت با BotFather، دستور /newbot را ارسال کنید.

مرحله ۲: انتخاب نام و نام کاربری

BotFather از شما نام ربات (مثلاً MyAIBot) و سپس نام کاربری منحصربه‌فرد (مثلاً myaibot_1xai) را درخواست می‌کند. نام کاربری باید با _bot یا bot پایان یابد و فقط حروف، اعداد و آندرسکور قبول می‌شود. این نام‌ها برای شناسایی ربات در تلگرام استفاده می‌شوند.

مرحله ۳: کپی کردن توکن و ذخیره‌سازی امن

پس از تکمیل، BotFather یک توکن طولانی برای شما ارسال می‌کند — مثلاً 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11. این توکن را کپی کنید و در جای امنی ذخیره کنید. توکن شامل یک شناسه عددی و یک رشته الفبایی است که هر دو برای احراز هویت ربات ضروری‌اند.

نکته امنیتی: محافظت از توکن

هرگز توکن را مستقیماً در کد منتشرشده یا مخازن GitHub قرار ندهید. هر کسی که توکن را داشته باشد می‌تواند ربات شما را کنترل کند. به جای آن، از فایل .env استفاده کنید:

# .env
TELEGRAM_BOT_TOKEN=123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11

سپس در کد Python خود:

import os
from dotenv import load_dotenv

load_dotenv()
TOKEN = os.getenv("TELEGRAM_BOT_TOKEN")

این روش توکن را از کد جدا نگه می‌دارد و اگر مخزن عمومی شود، توکن شما در معرض خطر نخواهد بود. همچنین می‌توانید توکن را در متغیرهای محیط سرور (Environment Variables) ذخیره کنید — این روش برای استقرار در سرورهای تولیدی توصیه می‌شود.

نصب کتابخانه‌ها و تنظیم اتصال به 1xAi

سه کتابخانه را نصب کنید (python-telegram-bot، openai، python-dotenv)، متغیرهای محیط را در فایل .env تنظیم کنید، و سپس OpenAI کلاینت را به سمت 1xAi هدایت کنید — بدون VPN یا کارت بانکی خارجی.

نصب کتابخانه‌های ضروری

pip install python-telegram-bot openai python-dotenv

این سه کتابخانه تمام نیازهای شما را برای ارتباط با تلگرام و هوش مصنوعی برطرف می‌کنند. python-telegram-bot رابط‌ای ساده برای API تلگرام فراهم می‌کند، openai کلاینت OpenAI-compatible است (که برای 1xAi کار می‌کند)، و python-dotenv متغیرهای محیط را از فایل .env می‌خواند.

تنظیم متغیرهای محیط در .env

فایل .env را در ریشه پروژه خود ایجاد کنید:

TELEGRAM_BOT_TOKEN=your_bot_token_here
OPENAI_API_KEY=your_1xai_key_here

• TELEGRAM_BOT_TOKEN: از @BotFather در تلگرام دریافت کنید.
• OPENAI_API_KEY: کلید 1xAi خود را از داشبورد 1xai.ir کپی کنید — یک کلید برای تمام مدل‌ها (OpenAI، Claude، Gemini) کافی است.

هرگز این کلیدها را در کد یا گیت‌هاب منتشر نکنید. فایل .env را به .gitignore اضافه کنید:

echo ".env" >> .gitignore

اتصال به 1xAi بجای OpenAI مستقیم

در فایل اصلی پایتون خود (مثلاً bot.py)، کلاینت OpenAI را به سمت 1xAi هدایت کنید:

import os
from openai import OpenAI
from dotenv import load_dotenv

load_dotenv()

client = OpenAI(
    api_key=os.getenv("OPENAI_API_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)

تنها تغییر base_url="https://1xai.ir/v1" است — باقی کد دقیقاً مثل OpenAI رسمی کار می‌کند. 1xAi درخواست را به مدل مناسب (OpenAI، Anthropic یا Google) مسیریابی می‌کند بر اساس نام مدل.

چرا از 1xAi استفاده کنیم؟

قیمت‌گذاری تومانی بدون نشانک‌های بین‌الملل: GPT-4.1 از طریق 1xAi 720,000 تومان برای هر میلیون توکن ورودی است (نرخ رسمی OpenAI $2 + حاشیه 20% از 1xAi، محاسبه‌شده با نرخ 300,000 تومان برای هر دلار). هیچ کارمزد بانکی، هیچ تبدیل ارز پنهان، هیچ تاخیر انتقال وجه.

بدون VPN: اتصال مستقیم از داخل ایران کار می‌کند. هیچ ابزار پروکسی یا تحریم‌شکن لازم نیست.

یک کلید برای همه: کلید 1xAi یکی است برای OpenAI (GPT-4.1، GPT-5، o3، GPT-5.5) و Anthropic (Claude 3.5 Sonnet).

نوشتن کد ربات: مدیریت پیام‌ها و state مکالمه

یک ربات تلگرام عملی نیاز به دو handler اساسی دارد: یکی برای دستور /start و یکی برای پیام‌های معمولی کاربر، که هر کدام state مکالمه را مدیریت می‌کند.

ساختار پایه: handlers و routing

ربات تلگرام در پایتون از کتابخانه python-telegram-bot استفاده می‌کند که دو نوع handler اصلی دارد: CommandHandler برای دستورات (مثل /start) و MessageHandler برای پیام‌های متنی. هر handler یک تابع async دریافت می‌کند که Update و Context را پردازش می‌کند.

from telegram import Update
from telegram.ext import Application, CommandHandler, MessageHandler, filters, ContextTypes
import os
from openai import OpenAI

client = OpenAI(api_key=os.getenv("OPENAI_API_KEY"), base_url="https://1xai.ir/v1")

async def start(update: Update, context: ContextTypes.DEFAULT_TYPE):
    await update.message.reply_text("سلام! من ربات هوش مصنوعی شما هستم. چیزی بپرسید!")

async def handle_message(update: Update, context: ContextTypes.DEFAULT_TYPE):
    user_text = update.message.text
    await update.message.chat.send_action("typing")
    
    response = client.chat.completions.create(
        model="gpt-5",
        messages=[{"role": "user", "content": user_text}],
        max_tokens=1000
    )
    
    await update.message.reply_text(response.choices[0].message.content)

async def main():
    app = Application.builder().token(os.getenv("TELEGRAM_BOT_TOKEN")).build()
    
    app.add_handler(CommandHandler("start", start))
    app.add_handler(MessageHandler(filters.TEXT & ~filters.COMMAND, handle_message))
    
    await app.run_polling()

if __name__ == "__main__":
    import asyncio
    asyncio.run(main())

مدیریت state ساده: context.user_data

برای ذخیره اطلاعات کاربر در طول مکالمه (مثل تاریخچه پیام‌ها یا تنظیمات)، از context.user_data استفاده کنید که یک دیکشنری است که برای هر کاربر جداگانه نگهداری می‌شود.

async def handle_message(update: Update, context: ContextTypes.DEFAULT_TYPE):
    user_id = update.effective_user.id
    user_text = update.message.text
    
    # مقدار دهی اولیه تاریخچه
    if "messages" not in context.user_data:
        context.user_data["messages"] = []
    
    # اضافه کردن پیام کاربر
    context.user_data["messages"].append({"role": "user", "content": user_text})
    
    # محدود کردن تاریخچه به 10 پیام آخر (برای کاهش هزینه)
    if len(context.user_data["messages"]) > 10:
        context.user_data["messages"] = context.user_data["messages"][-10:]
    
    await update.message.chat.send_action("typing")
    
    response = client.chat.completions.create(
        model="gpt-5",
        messages=context.user_data["messages"],
        max_tokens=1000
    )
    
    assistant_message = response.choices[0].message.content
    context.user_data["messages"].append({"role": "assistant", "content": assistant_message})
    
    await update.message.reply_text(assistant_message)

اتصال به 1xAi: استفاده از base_url

اگر از ایران درخواست می‌کنید و نیاز به دسترسی بدون VPN دارید، 1xAi gateway را با base_url https://1xai.ir/v1 استفاده کنید. کلید API از داشبورد 1xai.ir تولید می‌شود و هزینه‌ها به تومان محاسبه می‌شوند: برای مثال gpt-5 ورودی 450 هزار تومان و خروجی 3.6 میلیون تومان per 1M tokens است (نرخ 300 هزار تومان/USD با 20% markup).

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

چگونه می‌توانم بدون VPN و بدون کارت خارجی به API‌های هوش مصنوعی از داخل ایران دسترسی پیدا کنم؟

1xAi یک دروازه‌ای ایرانی است که به شما اجازه می‌دهد با یک کلید API واحد از داخل ایران به OpenAI، Claude و Gemini متصل شوید — بدون نیاز به VPN یا کارت بانکی خارجی؛ فقط از طریق Zarinpal و تومان پرداخت کنید.

قیمت ربات تلگرام با هوش مصنوعی از 1xAi چقدر است؟

1xAi قیمت رسمی هر مدل را به اضافه ۲۰ درصد markup محاسبه می‌کند — برای مثال gpt-4.1 ورودی ۷۲۰٬۰۰۰ تومان و خروجی ۲٬۸۸۰٬۰۰۰ تومان به ازای هر میلیون توکن است (بر اساس نرخ ۳۰۰٬۰۰۰ تومان به ازای هر دلار).

چه مراحلی برای ساخت ربات تلگرام لازم است؟

ابتدا `@BotFather` را در تلگرام پیدا کنید و دستور `/newbot` را ارسال کنید تا توکن دریافت کنید، سپس `python-telegram-bot` و `openai` را نصب کنید، کلید API 1xAi را از `1xai.ir` دریافت کنید، و در نهایت کد ربات را بنویسید و روی سرور ایرانی مستقر کنید.

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

بله، 1xAi یک کلید واحد (`1xai-…`) فراهم می‌کند که برای هر سه مدل (OpenAI، Anthropic Claude و Google Gemini) کار می‌کند — تنها کافی است نام مدل را در درخواست خود مشخص کنید.

حداقل مبلغ شارژ حساب 1xAi چقدر است؟

حداقل شارژ برای حساب 1xAi ۱٬۰۰۰ تومان است و می‌توانید از طریق Zarinpal پرداخت کنید.

آیا می‌توانم ربات تلگرام را بدون هزینه ایجاد کنم؟

خود ربات تلگرام رایگان است، اما اگر از هوش مصنوعی استفاده کنید باید برای API calls پرداخت کنید — 1xAi کمترین هزینه را با ۲۰ درصد markup بر روی قیمت رسمی ارائه می‌دهد.

توکن ربات تلگرام را کجا ذخیره کنم تا امن باشد؟

توکن را هرگز در کد منتشرشده یا GitHub قرار ندهید؛ آن را در فایل `.env` ذخیره کنید و از `python-dotenv` برای بارگذاری متغیرهای محیط استفاده کنید.