چت آیدی تلگرام: چیست، کجاست و چطور chat id کاربر، گروه و کانال را پیدا کنیم

به‌روزرسانی: ۷ آبان ۱۴۰۵ · 6 دقیقه مطالعه

چت آیدی تلگرام (chat_id) شناسه عددی یکتای هر چت است؛ چه چت خصوصی با یک کاربر باشد، چه گروه، سوپرگروه یا کانال. ربات برای ارسال پیام به این عدد نیاز دارد. چت آیدی معمولاً در اپ تلگرام دیده نمی‌شود؛ مطمئن‌ترین راه این است که به ربات خود پیام بدهید، متد getUpdates را صدا بزنید و مقدار message.chat.id را بخوانید. در ادامه روش پیدا کردن چت آیدی برای هر نوع چت و رفع مشکلات رایج را می‌بینید.

چت آیدی تلگرام چیست و چه شکلی دارد؟

از روی علامت و شکل عدد می‌توانید نوع چت را تشخیص دهید:

این عددها ممکن است از 32 بیت بزرگ‌تر باشند، پس در کد آن‌ها را در عدد صحیح 64 بیتی ذخیره کنید. یوزرنیم کاربر (مثل ‎@ali) جایگزین chat_id نیست؛ برای کاربران همیشه آیدی عددی لازم است.

روش 1: چت آیدی کاربر با getUpdates

1. ربات خود را در تلگرام باز کنید و Start را بزنید یا هر پیامی بفرستید.
2. متد getUpdates را با curl یا در Bot API Tester روی متد getUpdates اجرا کنید.
3. در پاسخ، مقدار message.chat.id را پیدا کنید.

curl https://api.telegram.org/bot123456789:AAEexampleTokenReplaceWithYours/getUpdates

{"ok": true, "result": [{"update_id": 100000001, "message": {
  "message_id": 5,
  "from": {"id": 123456789, "is_bot": false, "first_name": "علی"},
  "chat": {"id": 123456789, "first_name": "علی", "type": "private"},
  "date": 1793266200, "text": "سلام"}}]}

در چت خصوصی chat.id و from.id برابرند. در گروه‌ها chat.id آیدی گروه است و from.id آیدی کاربری که پیام را فرستاده.

چت آیدی گروه و سوپرگروه

1. ربات را به گروه اضافه کنید.
2. در گروه دستوری را که مخصوص ربات است بفرستید، مثلاً ‎/start@your_bot (به جای your_bot یوزرنیم ربات خودتان را بنویسید).
3. getUpdates را صدا بزنید و message.chat.id را بخوانید؛ عددی منفی است.

چرا دستور با یوزرنیم ربات؟ حالت حریم خصوصی (privacy mode) به‌طور پیش‌فرض روشن است و ربات در گروه فقط دستورهای مخصوص خودش، پاسخ به پیام‌های خودش و پیام‌های سرویسی را دریافت می‌کند؛ پیام‌های عادی را نمی‌بیند. اگر ربات باید همه پیام‌ها را بخواند، آن را ادمین کنید یا privacy mode را با ‎/setprivacy در BotFather خاموش کنید و ربات را دوباره به گروه اضافه کنید. اضافه شدن ربات به گروه، یک آپدیت my_chat_member هم می‌سازد که آن هم chat.id گروه را دارد.

وقتی گروه معمولی به سوپرگروه ارتقا پیدا می‌کند، آیدی آن عوض می‌شود. پاسخ خطا در این حالت فیلد parameters.migrate_to_chat_id را دارد؛ آیدی جدید را ذخیره کنید.

چت آیدی کانال

• کانال عمومی: لازم نیست عدد را پیدا کنید؛ ‎@channelusername را مستقیم به عنوان chat_id بفرستید. ربات باید در کانال ادمین با اجازه ارسال پیام باشد.
• کانال خصوصی: ربات را ادمین کانال کنید، یک پست در کانال منتشر کنید، سپس getUpdates را صدا بزنید. پست‌های کانال در فیلد channel_post می‌آیند، نه message.

{"update_id": 100000002, "channel_post": {
  "message_id": 12,
  "chat": {"id": -1001234567890, "title": "کانال من", "type": "channel"},
  "date": 1793266300, "text": "پست آزمایشی"}}

چت آیدی تاپیک در گروه‌های تاپیک‌دار

تاپیک‌ها آیدی چت جداگانه ندارند. پیام را به chat_id سوپرگروه بفرستید و شماره تاپیک را در پارامتر message_thread_id بگذارید. این عدد را از فیلد message_thread_id پیامی که داخل همان تاپیک ارسال شده در getUpdates بردارید.

{"chat_id": -1001234567890, "message_thread_id": 42, "text": "پیام در تاپیک"}

رفع مشکل: نتیجه خالی و خطای 409

اگر getUpdates پاسخ ‎{"ok":true,"result":[]}‎ داد:

• بعد از آخرین فراخوانی پیامی به ربات نرسیده است؛ یک پیام جدید بفرستید و دوباره امتحان کنید.
• آپدیت‌ها حداکثر 24 ساعت روی سرور تلگرام می‌مانند و آپدیت‌هایی که با offset تأیید شده‌اند دیگر برنمی‌گردند.
• در گروه پیام عادی فرستاده‌اید و privacy mode روشن است؛ از ‎/start@your_bot استفاده کنید.

اگر به جای نتیجه، خطای 409 با متن Conflict: can't use getUpdates method while webhook is active; use deleteWebhook to delete the webhook first گرفتید، روی ربات وب‌هوک تنظیم شده است. آن را حذف کنید:

curl https://api.telegram.org/bot123456789:AAEexampleTokenReplaceWithYours/deleteWebhook

اگر ربات در حال کار با وب‌هوک است (مثلاً در یک سرویس اتوماسیون)، حذف وب‌هوک دریافت آپدیت را در آن سرویس قطع می‌کند؛ بعد از پیدا کردن آیدی، وب‌هوک را دوباره تنظیم کنید. جزئیات در راهنمای وب‌هوک ربات تلگرام.

اگر ارسال پیام خطای 400 با متن Bad Request: chat not found داد، آیدی اشتباه است، پیشوند ‎-100 جا افتاده، کاربر ربات را استارت نکرده یا ربات عضو آن گروه یا کانال نیست.

چت آیدی کجا به کار می‌رود؟

هر جا ربات باید بدون درخواست کاربر پیام بفرستد به چت آیدی نیاز دارید: اعلان‌های سرور و CI، گزارش فروش، ابزارهای اتوماسیون مثل n8n و دستیارهای هوش مصنوعی که به تلگرام وصل می‌شوند. این ابزارها معمولاً توکن ربات و چت آیدی را با هم می‌خواهند؛ گرفتن توکن در راهنمای توکن ربات تلگرام و ارسال پیام در آموزش ارسال پیام با ربات تلگرام توضیح داده شده است.