ساخت ربات تلگرام هوش مصنوعی ۲۰۲۶ بدون VPN

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

ما در 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 بر اساس قیمت رسمی هر ارائه‌دهنده بعلاوه ۲۰ درصد علاوه‌برای عملیات درگاه است، با نرخ روزانه‌ای که هر روز ساعت ۰۹:۰۰ تهران با بازار آزاد هماهنگ می‌شود — برای نرخ فعلی به https://1xai.ir/pricing مراجعه کنید.

مدل	ورودی (۱M توکن)	خروجی (۱M توکن)	بهترین برای
gpt-5.5	قیمت رسمی OpenAI × ۱.۲	قیمت رسمی OpenAI × ۱.۲	محتوای پیچیده، تحلیل عمیق
gpt-5	قیمت رسمی OpenAI × ۱.۲	قیمت رسمی OpenAI × ۱.۲	تعادل سرعت و کیفیت
gpt-4.1	قیمت رسمی OpenAI × ۱.۲	قیمت رسمی OpenAI × ۱.۲	کارایی بالا، سرعت
o3	قیمت رسمی OpenAI × ۱.۲	قیمت رسمی OpenAI × ۱.۲	استدلال منطقی، ریاضی
Claude 3.5 Sonnet	Anthropic pricing + ۲۰٪	[Anthropic pricing](https://www.anthropic. — برای قیمت‌های تومانی فعلی به https://1xai.ir/models مراجعه کنید.

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

ربات تلگرام‌ای که به 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 قیمت رسمی OpenAI ($2 و $8 برای ورودی و خروجی به ترتیب) به‌علاوه 20% مارک‌آپ ثابت است — برای قیمت تومانی فعلی به https://1xai.ir/models مراجعه کنید، بدون هیچ شارژ پنهانی. شما می‌توانید از داشبورد 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 یک توکن طولانی برای شما ارسال می‌کند — مثلاً 172,722:ABC-DEF1234ghIkl-zyx57W2v1u123ew11. این توکن را کپی کنید و در جای امنی ذخیره کنید. توکن شامل یک شناسه عددی و یک رشته الفبایی است که هر دو برای احراز هویت ربات ضروری‌اند.

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

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

# .env
TELEGRAM_BOT_TOKEN=172,722:ABC-DEF1234ghIkl-zyx57W2v1u123ew11

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

import os
from dotenv import load_dotenv

load_dotenv()
TOKEN = os.environ["TELEGRAM_BOT_TOKEN"]

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

نصب کتابخانه‌ها و تنظیم اتصال به 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,
    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 قیمت رسمی OpenAI ($2 برای هر میلیون توکن ورودی) × 1.2 است (نرخ رسمی OpenAI + حاشیه 20% ثابت از 1xAi، محاسبه‌شده با نرخ روزانه‌ای که هر روز ساعت ۰۹:۰۰ تهران با بازار آزاد هماهنگ می‌شود — برای نرخ فعلی به https://1xai.ir/pricing مراجعه کنید). هیچ کارمزد بانکی، هیچ تبدیل ارز پنهان، هیچ تاخیر انتقال وجه.

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

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

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

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

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

این نمونه برای Python 3.10+ و python-telegram-bot نسخهٔ 22 نوشته شده است. بسته‌های python-telegram-bot>=22,<23، openai و python-dotenv را نصب کنید و کد را در bot.py قرار دهید. فایل .env باید TELEGRAM_BOT_TOKEN، OPENAI_API_KEY و ALLOWED_USER_IDS را داشته باشد؛ مقدار آخر فهرست شناسه‌های عددی کاربران مجاز با جداکنندهٔ ویرگول است. فایل .env را در .gitignore بگذارید. ONE_XAI_MODEL اختیاری است و باید شناسهٔ یک مدل فعال حساب باشد.

import os
from dotenv import load_dotenv
from openai import AsyncOpenAI, APIError
from telegram import Update
from telegram.ext import Application, CommandHandler, ContextTypes, MessageHandler, filters

load_dotenv()
TOKEN = os.environ["TELEGRAM_BOT_TOKEN"]
API_KEY = os.environ["OPENAI_API_KEY"]
ALLOWED = {int(value.strip()) for value in os.environ["ALLOWED_USER_IDS"].split(",")}
MODEL = os.getenv("ONE_XAI_MODEL", "gpt-4.1-mini")

async def start(update: Update, context: ContextTypes.DEFAULT_TYPE) -> None:
    if update.effective_user is None or update.effective_user.id not in ALLOWED:
        return
    if update.message is not None:
        context.user_data["messages"] = []
        await update.message.reply_text("سلام؛ تاریخچه پاک شد. یک پیام کوتاه بفرستید.")

async def handle_message(update: Update, context: ContextTypes.DEFAULT_TYPE) -> None:
    if update.effective_user is None or update.effective_user.id not in ALLOWED:
        return
    message = update.message
    if message is None or not message.text:
        return
    if len(message.text) > 2000:
        await message.reply_text("پیام را به کمتر از ۲۰۰۰ نویسه کوتاه کنید.")
        return
    history = list(context.user_data.get("messages", []))[-8:]
    pending = history + [{"role": "user", "content": message.text}]
    try:
        async with AsyncOpenAI(api_key=API_KEY, base_url="https://1xai.ir/v1",
                               timeout=45.0, max_retries=0) as client:
            response = await client.chat.completions.create(
                model=MODEL, messages=pending, max_tokens=400,
            )
    except APIError:
        await message.reply_text("پاسخ مدل دریافت نشد؛ اعتبار و دسترسی مدل را در داشبورد بررسی کنید.")
        return
    answer = response.choices[0].message.content or "پاسخ متنی خالی بود."
    context.user_data["messages"] = (pending + [{"role": "assistant", "content": answer}])[-8:]
    for offset in range(0, len(answer), 3000):
        await message.reply_text(answer[offset:offset + 3000])

def main() -> None:
    app = Application.builder().token(TOKEN).build()
    private = filters.ChatType.PRIVATE
    app.add_handler(CommandHandler("start", start, filters=private))
    app.add_handler(MessageHandler(private & filters.TEXT & ~filters.COMMAND, handle_message))
    app.run_polling()

if __name__ == "__main__":
    main()

با python bot.py اجرا کنید. از حساب مجاز در گفت‌وگوی خصوصی /start بفرستید و سپس یک پرسش کوتاه بنویسید؛ ربات باید متن پاسخ مدل را برگرداند. برای اجرا، میزبان باید به Telegram Bot API و 1xAi دسترسی شبکه داشته باشد؛ درگاه مدل محدودیت دسترسی به خود تلگرام را حل نمی‌کند. اجرای موفق درخواست مدل هزینه دارد.

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

در همین برنامه، context.user_data تاریخچه را برای هر کاربر جدا نگه می‌دارد. فقط چهار جفت پیام آخر ذخیره می‌شود و /start آن را پاک می‌کند. داده در حافظه است و با راه‌اندازی دوبارهٔ برنامه از بین می‌رود. محدودیت نویسه و خروجی، هزینهٔ هر درخواست را محدود می‌کند اما سقف روزانه نیست؛ سقف مصرف کلید را در داشبورد حساب تنظیم کنید. برای سرویس عمومی باید ذخیره‌سازی، محدودیت نرخ و مدیریت خطای Telegram را نیز اضافه کنید.

شکل handlerها و run_polling را می‌توانید در مثال رسمی کتابخانهٔ python-telegram-bot بررسی کنید.

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

اگر از ایران درخواست می‌کنید و نیاز به دسترسی بدون VPN دارید، 1xAi gateway را با base_url https://1xai.ir/v1 استفاده کنید. کلید API از داشبورد 1xai.ir تولید می‌شود و هزینه‌ها به تومان محاسبه می‌شوند: برای مثال gpt-5 ورودی ۴۰۵٬۴۵۰ تومان و خروجی ۳٬۲۴۳٬۶۰۰ تومان per 1M tokens است (نرخ روزانه بازار با 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 برای بارگذاری متغیرهای محیط استفاده کنید.