از ایده تا بات تلگرام: بات رایگان بساز، از پوشه ی خالی تا انتشار

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

این روش بر پایه ی قابلیت رسمی Telegram Serverless کار میکنه، مستندات کامل و رسمی اش رو میتونی در core.telegram.org/bots/serverless بخونی.

پیش نیازها

قبل از شروع، سه چیز رو آماده داشته باش:

Node.js نسخه ۱۸ یا بالاتر: رایگانه، از nodejs.org نصبش کن. برای اطمینان از نصب، تو ترمینال بزن node -v تا نسخه ش رو نشون بده.
یه ابزار کدنویسی با هوش مصنوعی: یکی از این ها کافیه، Claude Code، Codex، Cursor یا Antigravity.
یه بات در @BotFather: اول توی @BotFather یه بات بساز. بعد دوباره برو سراغ @BotFather، باتت رو انتخاب کن، برو به بخش Serverless و روشنش کن (On). همین روشن کردن، دیتابیس و سرور رایگان رو برات فعال میکنه.

مرحله ۱: پروژه رو بساز

اولین کار، ساختن خود پروژه ست. این دستور رو اجرا کن:

npm create @tgcloud/bot my_bot

این دستور یه پروژه ی کامل میسازه، از جمله این فایل ها و پوشه ها: AGENTS.md (راهنمای هوش مصنوعی)، docs/tgcloud-sdk.md (مرجع SDK)، schema.js، پوشه ی handlers/ و پوشه ی lib/. نکته ی مهم: فایل AGENTS.md دقیقاً همین جا ساخته میشه، پس هنوز ابزار هوش مصنوعی رو باز نکن.

مرحله ۲: وارد پوشه شو و به باتت وصل شو

برو داخل پوشه ی پروژه:

cd my_bot

و بعد به باتت وصل شو:

npx tgcloud login

توکن این مرحله رو از این مسیر بردار: @BotFather → Serverless → CLI Access → Access token. حواست باشه این Access token با توکن اصلی API خود بات فرق داره.

مرحله ۳: ابزار هوش مصنوعی رو داخل همین پوشه باز کن

این مهمترین مرحله ست. حالا که داخل پوشه ی my_bot هستی، ابزار کدنویسی هوش مصنوعیت رو دقیقاً توی همین پوشه باز کن. با این کار، ابزار میتونه فایل های AGENTS.md و docs/tgcloud-sdk.md رو بخونه و قانون های این پلتفرم رو یاد بگیره. اگه این کارو نکنی، کدی مینویسه که روی این زیرساخت اصلاً کار نمیکنه.

پرامپت ۱، ایده یابی

این پرامپت رو کپی کن و بده به هوش مصنوعی، فقط جای [حوزه کاری ات] رو با کار خودت پر کن:

من در حوزه ی [حوزه کاری ات را اینجا بنویس] فعالیت میکنم و میخواهم یک بات تلگرام بسازم که روی زیرساخت رایگان Telegram Serverless اجرا شود. ۱۰ ایده ی بات به من بده که هر کدام این شرط ها را داشته باشند: ۱) یک مشکل واقعی و روزمره ی مخاطب های حوزه ی من را حل کند ۲) فقط با امکانات داخلی خود تلگرام قابل ساخت باشد: دیتابیس داخلی، ارسال پیام، دکمه های شیشه ای، بدون هیچ سرویس پولی خارجی و بدون API-key ۳) راه درآمدزایی مشخص داشته باشد (ترجیحاً از طریق Telegram Stars که داخل خود تلگرام و بدون درگاه بانکی کار میکند). برای هر ایده دقیقاً این چهار مورد را بنویس: مشکلی که حل میکند، بات دقیقاً چه کاری انجام میدهد (قدم به قدم از نگاه کاربر)، مدل درآمد، سختی ساخت از ۱ تا ۵. در پایان، بهترین ایده برای شروع را با ذکر دلیل انتخاب کن و بگو چرا نسبت به بقیه راحتتر به درآمد میرسد.

پرامپت ۲، ساخت

وقتی ایده ت رو انتخاب کردی، این پرامپت رو بده تا بات رو برات بسازه، جای [ایده] رو کامل توضیح بده:

اول این دو فایل پروژه را کامل بخوان: AGENTS.md و docs/tgcloud-sdk.md، قوانین این پلتفرم آنجاست. میخواهم یک بات تلگرام بسازی که: [ایده ات را اینجا کامل توضیح بده، کاربر چه میفرستد، بات چه جوابی میدهد، چه چیزی باید ذخیره شود]. هنگام ساخت این محدودیت های پلتفرم را حتماً رعایت کن: جدول های دیتابیس را در schema.js تعریف کن (سینتکس شبیه Drizzle است)، Foreign key پشتیبانی نمیشود، رابطه ها را با ستون ساده مدل کن و یکپارچگی را در کد کنترل کن، برای هر نوع update فقط یک فایل handler بساز، آپلود و دانلود فایل پشتیبانی نمیشود، اگر لازم بود فایل ها را با file_id ارسال و بازاستفاده کن، اگر بات قرار است پول بگیرد از Telegram Stars (ارز XTR) استفاده کن که بدون provider-token و بدون درگاه بانکی کار میکند. بعد از نوشتن کد: توضیح بده هر جدول و هر handler چه کاری میکند، دقیقاً بگو چطور با «npx tgcloud run» قبل از انتشار تستش کنم، و بگو با کدام دستورها منتشرش کنم. قدم به قدم پیش برو و قبل از انتشار، اول تست را به من نشان بده.

مرحله ۴: تست کن (بدون انتشار)

قبل از اینکه چیزی منتشر بشه، کد محلیت رو تست کن:

npx tgcloud run

این دستور کد فعلیت رو اجرا میکنه بدون اینکه منتشرش کنه، جای امنیه برای اطمینان از اینکه بات درست کار میکنه.

مرحله ۵: منتشر کن

حالا وقت انتشاره. اول کد رو منتشر کن:

npx tgcloud push

بعد جدول های دیتابیس رو بساز:

npx tgcloud migrate

این دو تا عمداً از هم جدا هستن تا هیچ انتشاری یهو دیتابیست رو غافلگیر نکنه، اول کد میره بالا، بعد هر وقت خودت خواستی جدول ها ساخته میشن. تمام، باتت زنده ست. برای همیشه. رایگان.

چیت شیت دستورها

کاری که میکنه	دستور
ساخت پروژه	`npm create @tgcloud/bot my_bot`
ورود به پوشه ی پروژه	`cd my_bot`
اتصال به بات	`npx tgcloud login`
تست بدون انتشار	`npx tgcloud run`
انتشار کد	`npx tgcloud push`
ساخت جدول های دیتابیس	`npx tgcloud migrate`

حالا نوبت توئه

همین امروز اولین باتت رو بساز. اگه ساختیش یا جایی گیر کردی، حتماً برام بفرست ببینم، تو تلگرام منتظرم: t.me/siasalar

ابزار فقط دروازه ست، مسیر رو باید بلد باشی.

از ایده تا بات تلگرام: بات رایگان بساز، از پوشه ی خالی تا انتشار

خلاصه کلیدی