# ساخت ربات تلگرام

قدم‌به‌قدم: ‎@BotFather، ‎/newbot، توکن، دستورها، دکمه‌ها و اجرای کد.

https://shiba-bank.com/fa/guides/create-telegram-bot

به‌روزرسانی: 2026-10-02 · 5 دقیقه مطالعه

ربات تلگرام را در چت با ربات رسمی [@BotFather](https://t.me/botfather) می‌سازید: `/newbot` را برایش بفرستید، به ربات یک نام بدهید و نام کاربری‌ای انتخاب کنید که به `bot` ختم شود. BotFather با یک توکن جواب می‌دهد — کلیدی که برنامهٔ شما با آن ربات را کنترل می‌کند. ساخت ربات هزینه‌ای ندارد: تلگرام برای پلتفرم ربات از کاربران و توسعه‌دهندگان پولی نمی‌گیرد. اما BotFather فقط ربات را ثبت می‌کند. برای اینکه ربات به کسی جواب بدهد، باید برنامه‌ای روی کامپیوتر یا سرور شما اجرا شود.

## چطور در BotFather ربات بسازیم

1. [@BotFather](https://t.me/botfather) را باز کنید و Start را بزنید.
2. دستور `/newbot` را بفرستید.
3. **نام** ربات را وارد کنید — نامی که نمایش داده می‌شود.
4. **نام کاربری** را وارد کنید — نشانی ربات، مثل `@my_shop_bot`. باید 5 تا 32 نویسه باشد، فقط حروف لاتین، رقم و زیرخط، و به `bot` ختم شود.
5. BotFather **توکن** را برایتان می‌فرستد. حالا ربات وجود دارد.

> **مهم:** نام را بعداً می‌شود با `/setname` عوض کرد، اما طبق مستندات تلگرام نام کاربری پس از ساخت قابل تغییر نیست — با دقت انتخابش کنید.

## توکن: چیست و چطور امنش نگه داریم

توکن شبیه رقم و حرف‌هایی است که با دونقطه جدا شده‌اند. هر کس آن را داشته باشد ربات را کاملاً در اختیار دارد، به همین دلیل توصیهٔ تلگرام این است که آن را جای امنی نگه دارید و فقط با کسانی در میان بگذارید که به دسترسی مستقیم نیاز دارند.

- توکن را هرگز در کد عمومی، GitHub یا چت‌ها نگذارید.
- اگر لو رفت، مستندات تلگرام دستور `/token` در BotFather را برای ساخت توکن جدید نام می‌برد. بعد آن را در همهٔ جاهایی که برنامه‌تان استفاده می‌کند به‌روز کنید.
- توکن فقط برای ربات‌هاست. `api_id` و `api_hash` کلیدهای دیگری‌اند، برای برنامه‌هایی که به‌عنوان کاربر وارد می‌شوند: چطور بگیریمشان.

## در BotFather چه چیزهایی را تنظیم کنیم

`/mybots` منوی تعاملی تنظیمات ربات‌هایتان را باز می‌کند؛ همین در [مینی‌اپ BotFather](https://t.me/botfather?startapp) هم هست. ظاهر ربات را با دستورهای جداگانه هم می‌شود تعیین کرد:

- `/setname` — نام ربات.
- `/setdescription` — توضیح ربات، متنی کوتاه تا 512 نویسه.
- `/setabouttext` — اطلاعات «دربارهٔ ربات» (About)، متنی کوتاه‌تر تا 120 نویسه.
- `/setuserpic` — تصویر پروفایل ربات.
- `/setcommands` — فهرست دستورها؛ وقتی کسی `/` را تایپ کند تلگرام آن‌ها را پیشنهاد می‌دهد.
- `/setjoingroups` — اینکه ربات را بشود به گروه‌ها اضافه کرد یا نه.
- `/setprivacy` — اینکه ربات در گروه‌ها کدام پیام‌ها را دریافت کند.
- `/deletebot` — حذف ربات و آزادکردن نام کاربری‌اش.

## چطور ربات را به جواب‌دادن وادار کنیم

ربات برنامه‌ای است که از طریق [Bot API](https://core.telegram.org/bots/api) با تلگرام حرف می‌زند. هر درخواست به `https://api.telegram.org/bot<token>/METHOD` می‌رود. برای دریافت پیام‌ها دو راه هست و با هم سازگار نیستند:

- **getUpdates** (long polling): برنامهٔ شما پیام‌های تازه را از تلگرام می‌پرسد. ساده‌ترین شروع است — نشانی عمومی لازم ندارید.
- **Webhook**: تلگرام پیام‌ها را به سرور شما می‌فرستد. HTTPS و یکی از پورت‌های 443، 80، 88 یا 8443 لازم است.

کد را می‌توانید به هر زبانی که درخواست HTTP بزند بنویسید. کتابخانه‌های محبوب: aiogram و python-telegram-bot برای Python، و grammY و Telegraf برای JavaScript. آموزش رسمی یک ربات جاوا را قدم‌به‌قدم می‌رود: [از BotFather تا «Hello World»](https://core.telegram.org/bots/tutorial). ربات را می‌توانید تا وقتی روشن است روی کامپیوتر خودتان اجرا کنید، یا روی VPS تا شبانه‌روز کار کند.

## دکمه‌ها و دستورها در ربات

- **دستورها** کلماتی مثل `/start` هستند که ربات پردازششان می‌کند؛ فهرست راهنما با `/setcommands` تعیین می‌شود.
- **دکمه‌های درون‌خطی** زیر پیام متنی به چت نمی‌فرستند: فشاردادن را به ربات می‌فرستند یا پیوندی را باز می‌کنند.
- **کیبوردهای پاسخ** به‌جای کیبورد معمولی جواب‌های آماده نشان می‌دهند.
- **مینی‌اپ‌ها** رابط‌های کاملی‌اند که داخل تلگرام باز می‌شوند.

بیشتر در [مرور امکانات ربات](https://core.telegram.org/bots/features).

## پرداخت در ربات

کالاها و خدمات دیجیتال در ربات‌ها با Telegram Stars پرداخت می‌شوند: صورت‌حساب با ارز `XTR` صادر می‌شود و ارائه‌دهندهٔ پرداخت لازم نیست. راه‌اندازی آن در پذیرش Stars در ربات شما آمده است؛ ستاره‌هایی که ربات جمع کرده از طریق Fragment برداشت می‌شود — [چطور از ربات ستاره برداشت کنیم](https://shiba-bank.com/fa/guides/withdraw-stars-from-bot).

> **نکته:** می‌خواهید برنامه‌تان برای کاربرانش ستاره یا Premium بخرد؟ ربات Shiba Bank برای این کار API دارد: API ستارهٔ تلگرام.

[همه‌چیز داخل تلگرام — باز کردن برنامه](https://t.me/barboskich_stars_bot?startapp=site_ai_fa)

## پرسش‌های رایج

### چطور بدون کدنویسی ربات تلگرام بسازم؟
ثبت ربات از طریق @BotFather یک دقیقه طول می‌کشد، اما برای اینکه کاری انجام دهد کد لازم است. خود تلگرام یادآوری می‌کند که ساخت ربات دست‌کم مقداری مهارت برنامه‌نویسی می‌خواهد.

### ساخت ربات تلگرام چقدر هزینه دارد؟
هیچ: تلگرام برای پلتفرم ربات از کاربران و توسعه‌دهندگان پولی نمی‌گیرد. فقط اگر ربات را روی سرور خودتان میزبانی کنید، هزینهٔ سرور را می‌پردازید.

### BotFather چیست؟
ربات رسمی تلگرام برای ساخت ربات‌ها و مدیریتشان: نام، توضیح، تصویر، دستورها و توکن.

### چطور توکن BotFather را بگیرم؟
توکن بلافاصله بعد از `/newbot` می‌رسد. اگر لو رفت، دستور `/token` در BotFather توکن جدید صادر می‌کند.

### ربات چه نام کاربری‌ای می‌تواند داشته باشد؟
5 تا 32 نویسه: حروف لاتین، رقم و زیرخط، و باید به `bot` ختم شود، مثلاً `my_shop_bot`.

### چطور به ربات تلگرام دکمه اضافه کنم؟
دکمه‌ها در کد ربات تعریف می‌شوند: دکمه‌های درون‌خطی زیر پیام و کیبوردهای پاسخ. فهرست دستورهای منوی `/` در BotFather با `/setcommands` تعیین می‌شود.