Language: English | Русский | Español | Português | Türkçe | Deutsch | Français | Bahasa Indonesia | العربية | فارسی | Oʻzbek | हिन्दी | 中文 | اردو | Tagalog | አማርኛ

← Home

راهنماهای Telegram Bot API chat_id

chat_id برای اکثر متدهای Telegram Bot API لازم است: sendMessage، sendPhoto، editMessageText و بسیاری دیگر. مقصد را مشخص می‌کند — چت خصوصی (کاربر)، گروه، سوپرگروه، یا کانال. در چت خصوصی، chat_id برابر با شناسه کاربر Telegram کاربر است (مثبت). برای گروه‌ها و سوپرگروه‌ها، chat_id معمولاً منفی است. این هاب راهنماهای توسعه‌دهنده برای گرفتن chat_id، رفع خطاهای رایج و استفاده در کتابخانه‌های محبوب را گردآوری می‌کند.

می‌توانید chat_id را با تعامل کاربران با ربات یا ربات کمکی مثل @print_id_bot و خواندن آن از آپدیت‌ها بگیرید. برای وب‌هوک‌ها، JSON آپدیت ورودی را بررسی کنید تا chat.id را استخراج کنید. دستور /dump در @print_id_bot ساختار کامل آپدیت را برای دیباگ خروجی می‌دهد.

راهنماها

FAQ

چرا “chat not found” می‌گیرم؟

علل رایج: ربات از چت حذف شد، chat_id اشتباه یا منسوخ استفاده می‌کنید، یا گروه به سوپرگروه ارتقا یافت (chat_id می‌تواند تغییر کند). ربات را دوباره اضافه کنید، chat_id فعلی را با @print_id_bot بگیرید و مطمئن شوید مقدار صحیح استفاده می‌کنید.

چگونه آپدیت‌های وب‌هوک را دیباگ کنم؟

از دستور /dump در @print_id_bot (در چت خصوصی) برای دیدن JSON کامل آپدیت استفاده کنید. ساختار message، chat، user و فیلدهای دیگر را نشان می‌دهد. با payload وب‌هوک خود مقایسه کنید تا ببینید chat_id و شناسه کاربر کجا هستند.

کدام راهنمای کتابخانه را استفاده کنم؟

راهنمایی را انتخاب کنید که با stack شما مطابقت دارد: Aiogram و python-telegram-bot برای Python، Telegraf برای Node.js، و راهنمای Go برای Go. راهنمای عمومی Bot API برای هر زبان اعمال می‌شود.


با @print_id_bot فوراً chat_id بگیرید.

Open @print_id_bot


Related pages