FAQ va limitlar
Ko'p so'raladigan savollar va barcha raqamli cheklovlar bitta joyda.
Limitlar jadvali
| Nima | Limit |
|---|---|
| Bot username | 5–32 belgi, harf bilan boshlanadi, A-Z a-z 0-9 _, bot bilan tugaydi; zamin so'zi taqiqlangan |
| Bot nomi | 1–64 belgi; "Zamin"ga o'xshash nomlar taqiqlangan |
| Tavsif / qisqa ma'lumot | ≤512 / ≤120 belgi |
| Bir foydalanuvchining botlari | 20 ta (standart) |
| Bot yaratish tezligi | ≈5 ta / soat |
| Xabar matni | 1–4096 belgi |
| Fayl izohi (caption) | ≤1024 belgi |
| Fayl hajmi | ≤50 MB (rasm ≤20 MB); multipart so'rov ≤52 MB |
| JSON / form tanasi | ≤64 KB |
| Rasm | JPEG'ga qayta kodlanadi, ≤2048×2048 px, ≤50 megapiksel kirish |
| Tahrirlash va o'chirish | Yuborilganidan keyin 48 soat |
| Callback javobi | Bir marta, 60 soniya ichida; matn ≤200 |
| Klaviatura | ≤12 qator, qatorda ≤8, jami ≤100 tugma; tugma matni 1–64; callback_data ≤64 bayt; URL ≤2048 |
| Buyruqlar | ≤100 ta; buyruq 1–32 (a-z 0-9 _), tavsif 1–256 |
| Deep link parametri | 1–64, A-Z a-z 0-9 _ - |
| Bot API so'rovlari | 50/s bot uchun (portlash 100) |
| Bot xabarlari | 30/s bot uchun; 1/s bitta chatga (portlash 5) |
| Kunlik chatlar (tasdiqlanmagan bot) | 10 000 turli chat / kun |
| Noto'g'ri token | 20 / 10 daqiqa / IP, keyin shu IP'dan faqat noto'g'ri tokenli so'rovlar 429 oladi (to'g'ri token bloklanmaydi) |
| getUpdates | limit 1–100; timeout 0–50 s; bitta bot uchun bitta ochiq so'rov |
| Guruh yoki kanalga xabar | 20 / daqiqa (bot bo'yicha, har bir chatga) |
| Guruh xabarlarini shifrlash | 1 000 qurilma/s bot bo'yicha, 1 500/s bot egasi bo'yicha, 5 000/s umumiy; har bir odamning eng so'nggi faol 10 ta qurilmasi |
| Bir vaqtdagi fayl uzatishlar | 3 ta bot bo'yicha, 16 ta umumiy (yuklab olish va yuklash alohida; shaxsiy chatlar ham; guruh/kanalga file_id bilan qayta yuborish — yuklash) |
| Har qanday limitdan oshish | 429 Too Many Requests: retry after N + parameters.retry_after; rad etilgan so'rov hech narsa qilmaydi — kutib, qayta yuboring |
| Guruhdagi botlar | ≤20 ta bot / guruh; ≤200 ta guruh va kanal / bot |
| Guruh fayllarini yuklab olish | ≤50 MB (shifrlangan fayllar) |
| Guruh / kanal nomi va tavsifi (setChatTitle / setChatDescription) | 1–128 / ≤255 belgi |
| Yangilanishlar navbati | 24 soat, ≤1000 ta / bot |
| Webhook | https; port 443/80/88/8443; URL ≤2048; javob 10 s ichida; qayta urinish 1 s dan 10 daqiqagacha, 24 soatgacha |
| secret_token | 1–256, A-Z a-z 0-9 _ - |
| max_connections | 1–100 (standart 40; hozircha yetkazish ketma-ket) |
Batafsil: Rate limitlar.
Ko'p so'raladigan savollar
Bot birinchi bo'lib foydalanuvchiga yoza oladimi?
Yo'q. Foydalanuvchi avval botni ochib Start'ni bosishi yoki unga yozishi kerak. Shundan keyingina bot chat_id'ni biladi va yoza oladi. Foydalanuvchi qidirish metodi yo'q.
Nega sendMessage chat not found qaytaryapti?
Foydalanuvchi botni boshlamagan, bloklagan (to'xtatgan), hisobini o'chirgan yoki chat_id noto'g'ri. Maxfiylik uchun barcha holatlarda javob bir xil. Bloklash haqida my_chat_member (kicked) yangilanishi keladi.
Botim guruhga yoki kanalga qo'shila oladimi?
Ha. Guruh egasi (yoki "A'zo qo'shish" huquqli admin) botni guruh ma'lumotlaridagi Botlar bo'limida qo'shadi; kanalga — egasi yoki "Admin tayinlash" huquqli admin. @ZaminBot'dagi /setjoingroups bilan buni taqiqlash mumkin. Guruhlar va kanallar.
Nega botim guruhdagi oddiy xabarlarni ko'rmayapti?
Privacy mode: guruhda bot faqat buyruqlar (/cmd, /cmd@SizningBot), @eslatishlar va o'z xabariga javoblarni oladi. Barcha xabarlarni faqat bot admin bo'lsa va guruh egasi "Barcha xabarlarni o'qish" huquqini bergan bo'lsa oladi. Bot qo'shilishidan oldingi tarix hech qachon ko'rinmaydi. Batafsil.
Foydalanuvchining telefon raqamini qanday olaman?
Faqat foydalanuvchining roziligi bilan: reply klaviaturaga request_contact tugmasini qo'shing. Foydalanuvchi bosib, tasdiqlasa, contact'li xabar keladi. Batafsil.
Bitta odam ikki botimda bir xil id bilan ko'rinadimi?
Yo'q. Har bir bot foydalanuvchini alohida psevdonim raqam bilan ko'radi — hatto botlar bir egaga tegishli bo'lsa ham. Bitta bot ichida id doimiy.
Markdown yoki HTML formatlash bormi?
Yo'q. Matn doim oddiy matn sifatida ko'rsatiladi; parse_mode e'tiborga olinmaydi. Emoji va qator ko'chirish (\n) ishlaydi.
Telegram kutubxonalarini (python-telegram-bot, aiogram …) ishlatsam bo'ladimi?
Rasman qo'llab-quvvatlanmaydi. Shakllar Telegram'ga o'xshash bo'lgani uchun ba'zi qismlar ishlashi mumkin, lekin farqlar bor (psevdonim id'lar, maydonlar to'plami, webhook sarlavhasi, yo'q metodlar). Ishonchli yo'l — to'g'ridan-to'g'ri HTTP so'rovlar yoki kichik yordamchi klass.
Tokenni yo'qotdim. Qanday tiklayman?
Tokenni tiklab bo'lmaydi (server faqat xeshini saqlaydi). @ZaminBot'da /token yoki /revoke yangi token beradi; eskisi ishlamay qoladi va webhook o'chadi.
getUpdates 409 Conflict qaytaryapti.
Ikki sabab: webhook o'rnatilgan (avval deleteWebhook) yoki botingizning ikkinchi nusxasi ham getUpdates qilyapti (bittasini to'xtating).
Webhook yangilanishlari kelmayapti.
getWebhookInfo'ni tekshiring: last_error_message sababni aytadi. Ko'p uchraydiganlari: noto'g'ri sertifikat, yopiq port, 10 soniyadan uzoq javob, maxfiy sarlavha tekshiruvi 403 qaytaryapti. Yetkazish ketma-ket — bitta yangilanishga doim xato qaytarilsa, keyingilari kutadi.
Foydalanuvchi xabarini o'chirsa, bot biladimi?
Yo'q, o'chirish haqida yangilanish kelmaydi. Tahrirlash haqida esa edited_message keladi.
Fayl yuklashda mime_type doim application/octet-stream.
Rasm, video va audio bo'lmagan barcha fayllar (PDF, ZIP, DOCX …) uchun shunday. Turini file_name kengaytmasidan yoki fayl mazmunidan aniqlang.
Bot chatlari xavfsizmi?
Ular serverda shifrlangan holda saqlanadi, lekin uchidan-uchiga shifrlanmagan: Zamin serveri va bot egasi ularni o'qiy oladi. Ilova buni har bir bot chatida ko'rsatadi. Maxfiylik va xavfsizlik.
Botimni tasdiqlangan (verified) qilish mumkinmi?
Tasdiqlashni Zamin administratorlari beradi. Tasdiqlangan botlarga kunlik 10 000 chat limiti qo'llanmaydi.