ربات تلگرام با C# چیست و چرا باید یاد بگیریم؟

تلگرام امروز دیگر فقط یک پیام‌رسان نیست؛ یک پلتفرم کسب‌وکار واقعی است. میلیون‌ها ایرانی هر روز از تلگرام استفاده می‌کنند و همین موضوع، ساخت ربات تلگرام را به یکی از پرطرفدارترین مهارت‌های برنامه‌نویسی در ایران تبدیل کرده.

اگر یک برنامه‌نویس C# هستی یا تازه داری وارد دنیای دات‌نت می‌شی، خبر خوبی برات داریم: ساخت ربات تلگرام با C# نه‌تنها ممکنه، بلکه با ابزارهای موجود، کار خیلی جذاب و نسبتاً ساده‌ایه.

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

پیش‌نیازها: قبل از شروع چه چیزی لازم داریم؟

قبل از اینکه وارد کدنویسی بشیم، باید مطمئن بشیم که همه ابزارهای لازم رو داریم:

• Visual Studio 2022 یا Visual Studio Code با پلاگین C#
• .NET 6 یا بالاتر (ترجیحاً .NET 8 که آخرین LTS است)
• یک اکانت تلگرام فعال
• آشنایی پایه با زبان C# و مفاهیم شیءگرایی
• اتصال به اینترنت (برای دریافت توکن از BotFather)

مرحله اول: ساخت ربات در تلگرام و دریافت Token

اول از همه باید ربات‌مون رو در تلگرام ثبت کنیم. این کار رو از طریق BotFather انجام می‌دیم که یه ربات رسمی تلگرامه:

1. در تلگرام به @BotFather برو و استارت بزن.
2. دستور /newbot رو بفرست.
3. یه اسم برای ربات انتخاب کن (مثلاً: ربات پشتیبانی فروشگاه).
4. یه username برای ربات بزن که حتماً باید به bot ختم بشه (مثلاً: my_store_bot).
5. BotFather یه Token بهت می‌ده. این توکن رو جایی امن نگه‌دار!

⚠️ هشدار مهم: توکن ربات مثل رمز عبوره. هیچ‌وقت اون رو در کد پابلیک (مثل GitHub) قرار نده!

مرحله دوم: ایجاد پروژه C# و نصب کتابخانه

بهترین کتابخانه برای کار با API تلگرام در C#، پکیج Telegram.Bot است که رسمی‌ترین و پرطرفدارترین گزینه در اکوسیستم دات‌نته.

ساخت پروژه Console Application

ترمینال رو باز کن و دستورات زیر رو اجرا کن:

dotnet new console -n TelegramBotCSharp

cd TelegramBotCSharp

dotnet add package Telegram.Bot

dotnet add package Microsoft.Extensions.Hosting

پکیج Telegram.Bot همه چیزی رو که برای ارتباط با API تلگرام نیاز داری فراهم می‌کنه. این کتابخانه به‌صورت async نوشته شده که برای برنامه‌های real-time عالیه.

مرحله سوم: کدنویسی ربات تلگرام با C#

ساختار پروژه

فایل Program.cs رو باز کن و کد زیر رو بنویس:

using Telegram.Bot;

using Telegram.Bot.Exceptions;

using Telegram.Bot.Polling;

using Telegram.Bot.Types;

using Telegram.Bot.Types.Enums;

var botToken = “YOUR_BOT_TOKEN_HERE”; // توکن ربات خودت رو اینجا بذار

var botClient = new TelegramBotClient(botToken);

using CancellationTokenSource cts = new();

ReceiverOptions receiverOptions = new()

{

AllowedUpdates = Array.Empty()

};

botClient.StartReceiving(

updateHandler: HandleUpdateAsync,

pollingErrorHandler: HandlePollingErrorAsync,

receiverOptions: receiverOptions,

cancellationToken: cts.Token

);

var me = await botClient.GetMeAsync();

Console.WriteLine($“ربات {me.Username} با موفقیت راه‌اندازی شد!”);

Console.ReadLine();

cts.Cancel();

async Task HandleUpdateAsync(ITelegramBotClient botClient,

Update update, CancellationToken cancellationToken)

{

if (update.Message is not { } message) return;

if (message.Text is not { } messageText) return;

var chatId = message.Chat.Id;

Console.WriteLine($“پیام دریافت شد از {chatId}: ‘{messageText}’”);

switch (messageText.ToLower())

{

case “/start”:

await botClient.SendTextMessageAsync(

chatId: chatId,

text: “سلام! 👋 به ربات ما خوش آمدید!
برای راهنمایی /help را بفرستید.”,

cancellationToken: cancellationToken);

break;

case “/help”:

await botClient.SendTextMessageAsync(

chatId: chatId,

text: “📌 دستورات موجود:
/start - شروع
/about - درباره ما
/contact - تماس با ما”,

cancellationToken: cancellationToken);

break;

case “/about”:

await botClient.SendTextMessageAsync(

chatId: chatId,

text: “🤖 این ربات با C# و کتابخانه Telegram.Bot ساخته شده است.”,

cancellationToken: cancellationToken);

break;

default:

await botClient.SendTextMessageAsync(

chatId: chatId,

text: $“شما نوشتید: {messageText}
برای راهنمایی /help را بفرستید.”,

cancellationToken: cancellationToken);

break;

}

}

Task HandlePollingErrorAsync(ITelegramBotClient botClient,

Exception exception, CancellationToken cancellationToken)

{

var errorMessage = exception switch

{

ApiRequestException apiRequestException

=> $“خطای API تلگرام:
[{apiRequestException.ErrorCode}]
{apiRequestException.Message}”,

_ => exception.ToString()

};

Console.WriteLine(errorMessage);

return Task.CompletedTask;

}

توضیح کد خط به خط

• TelegramBotClient: شیء اصلی برای ارتباط با API تلگرام است.
• StartReceiving: یک حلقه polling شروع می‌کند که مدام به دنبال پیام جدید می‌گردد.
• HandleUpdateAsync: هر بار که پیام جدیدی بیاد، این متد صدا زده می‌شه.
• CancellationToken: برای متوقف کردن ربات به‌صورت graceful استفاده می‌شه.
• Switch Statement: منوی دستورات ربات رو مدیریت می‌کنه.

مرحله چهارم: ارسال انواع محتوا با ربات

یکی از قدرت‌های ربات تلگرام اینه که می‌تونه انواع مختلف محتوا ارسال کنه. بیاید چند نمونه ببینیم:

ارسال تصویر

// ارسال عکس از طریق URL

await botClient.SendPhotoAsync(

chatId: chatId,

photo: InputFile.FromUri(“https://example.com/image.jpg”),

caption: “این یک تصویر نمونه است! 📸”,

cancellationToken: cancellationToken);

// ارسال عکس از روی دیسک

using var fileStream = new FileStream(“image.jpg”, FileMode.Open);

await botClient.SendPhotoAsync(

chatId: chatId,

photo: InputFile.FromStream(fileStream, “image.jpg”),

caption: “تصویر ارسال شده از سرور”,

cancellationToken: cancellationToken);

ارسال دکمه‌های Inline Keyboard

using Telegram.Bot.Types.ReplyMarkups;

var inlineKeyboard = new InlineKeyboardMarkup(new[]

{

new[]

{

InlineKeyboardButton.WithCallbackData(“✅ بله”, “yes”),

InlineKeyboardButton.WithCallbackData(“❌ خیر”, “no”),

},

new[]

{

InlineKeyboardButton.WithCallbackData(“🏠 منوی اصلی”, “main_menu”),

}

});

await botClient.SendTextMessageAsync(

chatId: chatId,

text: “لطفاً یک گزینه انتخاب کنید:”,

replyMarkup: inlineKeyboard,

cancellationToken: cancellationToken);

مدیریت Callback Query (کلیک روی دکمه‌ها)

// داخل HandleUpdateAsync اضافه کن:

if (update.CallbackQuery is { } callbackQuery)

{

await botClient.AnswerCallbackQueryAsync(

callbackQueryId: callbackQuery.Id,

text: $“شما انتخاب کردید: {callbackQuery.Data}”,

cancellationToken: cancellationToken);

await botClient.SendTextMessageAsync(

chatId: callbackQuery.Message!.Chat.Id,

text: $“گزینه انتخابی: {callbackQuery.Data}”,

cancellationToken: cancellationToken);

}

مرحله پنجم: کار با پایگاه داده در ربات تلگرام

یک ربات حرفه‌ای بدون پایگاه داده کامل نیست. بیاید ببینیم چطور می‌تونیم از SQLite در کنار ربات‌مون استفاده کنیم:

// نصب پکیج

// dotnet add package Microsoft.EntityFrameworkCore.Sqlite

using Microsoft.EntityFrameworkCore;

public class BotDbContext : DbContext

{

public DbSet Users { get; set; }

protected override void OnConfiguring(DbContextOptionsBuilder options)

=> options.UseSqlite(“Data Source=bot.db”);

}

public class UserModel

{

public int Id { get; set; }

public long TelegramId { get; set; }

public string Username { get; set; } = string.Empty;

public string FirstName { get; set; } = string.Empty;

public DateTime RegisteredAt { get; set; } = DateTime.Now;

}

// در HandleUpdateAsync استفاده کن:

using var db = new BotDbContext();

await db.Database.EnsureCreatedAsync();

var existingUser = await db.Users

.FirstOrDefaultAsync(u => u.TelegramId == message.From!.Id);

if (existingUser == null)

{

var newUser = new UserModel

{

TelegramId = message.From!.Id,

Username = message.From.Username ?? “بدون یوزرنیم”,

FirstName = message.From.FirstName

};

db.Users.Add(newUser);

await db.SaveChangesAsync();

Console.WriteLine($“کاربر جدید ثبت شد: {newUser.FirstName}”);

}

مرحله ششم: استقرار ربات روی سرور (Deployment)

ربات‌ی که فقط روی لپ‌تاپت اجرا می‌شه به دردت نمی‌خوره! باید اون رو روی یه سرور دائمی مستقر کنی. چند روش محبوب وجود داره:

روش اول: Polling روی VPS

ساده‌ترین روشه. کافیه پروژه رو Publish کنی و روی سرور لینوکس اجرا کنی:

# Publish پروژه

dotnet publish -c Release -r linux-x64 --self-contained

اجرا به عنوان سرویس با systemd

sudo nano /etc/systemd/system/telegram-bot.service

[Unit]

Description=My Telegram Bot

After=network.target

[Service]

WorkingDirectory=/opt/telegram-bot

ExecStart=/opt/telegram-bot/TelegramBotCSharp

Restart=always

RestartSec=10

[Install]

WantedBy=multi-user.target

sudo systemctl enable telegram-bot

sudo systemctl start telegram-bot

روش دوم: Webhook

روش Webhook بهینه‌تره چون سرور دیگه مدام به API تلگرام request نمی‌زنه، بلکه تلگرام خودش پیام‌ها رو برامون می‌فرسته:

// تنظیم Webhook

await botClient.SetWebhookAsync(

url: “https://yourdomain.com/bot”,

cancellationToken: cts.Token);

// در ASP.NET Core:

app.MapPost(“/bot”, async (

ITelegramBotClient bot,

Update update,

IUpdateHandler handler,

CancellationToken ct) =>

{

await handler.HandleUpdateAsync(bot, update, ct);

});

نکات حرفه‌ای برای توسعه ربات تلگرام با C#

• مدیریت استثناء (Exception Handling): همیشه کدهایت رو داخل try-catch بذار. خطاهای API تلگرام مثل flood limit رو جداگانه مدیریت کن.
• Rate Limiting: تلگرام محدودیت ارسال پیام داره (30 پیام در ثانیه). حتماً این رو رعایت کن.
• Dependency Injection: از سیستم DI در ASP.NET Core استفاده کن تا کدت قابل تست‌پذیر و نگهداری‌پذیر باشه.
• لاگ‌گیری: از کتابخانه Serilog یا NLog برای لاگ‌گیری حرفه‌ای استفاده کن.
• امنیت توکن: توکن رو در فایل appsettings.json یا متغیرهای محیطی (Environment Variables) نگه‌دار، نه مستقیم در کد.
• State Management: برای مدیریت مراحل مکالمه کاربر از State Pattern یا کتابخانه‌هایی مثل Telegram.Bot.Framework استفاده کن.

امنیت در ربات تلگرام: چه نکاتی رو باید رعایت کنیم؟

امنیت ربات تلگرام رو هیچ‌وقت دست کم نگیر. این موارد الزامیه:

• Validate کردن ورودی‌ها: هیچ‌وقت به ورودی کاربر اعتماد نکن. همه چیز رو Sanitize کن.
• محدود کردن دسترسی ادمین: فقط ChatId ادمین‌های مشخص باید به دستورات مدیریتی دسترسی داشته باشن.
• HTTPS اجباری برای Webhook: تلگرام فقط با HTTPS کار می‌کنه.
• محافظت در برابر Spam: یه سیستم Rate Limiting برای هر کاربر پیاده کن.

// بررسی دسترسی ادمین

private static readonly long[] AdminIds = { 123456789, 987654321 };

bool IsAdmin(long userId) => AdminIds.Contains(userId);

// استفاده:

if (messageText == “/admin” && !IsAdmin(message.From!.Id))

{

await botClient.SendTextMessageAsync(chatId,

“⛔ شما به این دستور دسترسی ندارید.”,

cancellationToken: cancellationToken);

return;

}

ایده‌های کاربردی برای ربات تلگرام با C#

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

• ربات پشتیبانی مشتریان: سوالات متداول رو خودکار جواب بده
• ربات فروشگاه آنلاین: کاتالوگ محصولات، سبد خرید و پرداخت آنلاین
• ربات اطلاع‌رسانی: ارسال اخبار، تخفیف‌ها و اطلاعیه‌ها به مشترکین
• ربات نرخ ارز: نمایش لحظه‌ای قیمت دلار، طلا و ارزهای دیجیتال
• ربات وظیفه‌مند (Task Manager): مدیریت وظایف و یادآوری‌ها
• ربات سرویس‌های API: اتصال به هر سرویس خارجی و نمایش نتایج

سوالات متداول (FAQ)