Telegram Bot API
Telegram Bot API bu dasturingiz Telegram bilan muloqot qilishi uchun rasmiy interfeys. Bot API orqali bot xabarlarni qabul qiladi, javob yuboradi, rasm va fayllarni jo'natadi, tugmalar ko'rsatadi va guruhlarni boshqaradi. Barchasi oddiy HTTPS so'rovlari orqali ishlaydi, shuning uchun botni deyarli istalgan dasturlash tilida yozish mumkin. Ushbu maqolada Bot API qanday ishlashini, getUpdates va webhook farqini, xabar, rasm va tugma yuborishni, cheklovlar va limitlarni hamda rasmiy hujjatlardan qanday foydalanishni oddiy tilda tushuntiramiz.
Bot tokeni botingizning paroli. Uni kodda ochiq qoldirmang va hech kimga bermang; oshkor bo'lsa, BotFather orqali darhol yangilang.
Bot API qanday ishlaydi
Har bir bot @BotFather orqali yaratiladi va o'z tokenini oladi. Dasturingiz Telegram serveriga quyidagi ko'rinishdagi manzilga so'rov yuboradi: api.telegram.org, keyin bot va token, so'ng metod nomi. Masalan, sendMessage metodi xabar yuboradi, getMe esa bot haqidagi ma'lumotni qaytaradi. Javob JSON formatida keladi. Bot foydalanuvchiga birinchi bo'lib yoza olmaydi: foydalanuvchi avval botni ishga tushirishi kerak.
getUpdates va webhook farqi
| Usul | Qanday ishlaydi | Qachon qulay |
|---|---|---|
| getUpdates (polling) | Bot muntazam ravishda yangi yangilanishlarni so'raydi | Sinov, kompyuterda yoki VPS'da ishlaydigan bot |
| Webhook | Telegram yangilanishlarni botning HTTPS manziliga o'zi yuboradi | Ko'p foydalanuvchili botlar, server tomonida |
Ikki usulni bir vaqtda ishlatib bo'lmaydi: webhook o'rnatilgan bo'lsa, getUpdates ishlamaydi. Botni doimiy ishlatish uchun qayerga joylash haqida alohida maqolamiz bor.
Xabar, rasm va tugma yuborish
- sendMessage: matnli xabar; formatlash uchun HTML yoki Markdown rejimi.
- sendPhoto, sendDocument: rasm va fayl; havola, fayl ID yoki yuklash orqali.
- Inline klaviatura: xabar ostidagi tugmalar; bosilganda bot callback oladi.
- Oddiy klaviatura: yozish maydoni o'rniga chiqadigan tugmalar.
- Web App tugmasi: mini ilovani ochadi: Telegram mini ilovalar.
Cheklovlar va limitlar
Telegram spamning oldini olish uchun bot yuboradigan xabarlar soniga cheklov qo'yadi: bitta chatga juda tez-tez, ko'p chatlarga esa soniyasiga ma'lum sondan ortiq xabar yuborib bo'lmaydi. Limitdan oshsangiz, server «Too Many Requests» xatosi bilan qancha kutish kerakligini aytadi. Bot yuboradigan va yuklab oladigan fayllar hajmi ham cheklangan. Ommaviy xabar yuborishda so'rovlarni sekinlashtiring va foydalanuvchilar rozilik berganiga ishonch hosil qiling. Pullik xizmatlar uchun Telegram Stars ishlatiladi: Telegram Stars.
Rasmiy hujjatlardan foydalanish
Telegram Bot API'ning to'liq hujjati core.telegram.org saytida joylashgan va har bir yangi versiyada yangilanadi. Hujjatda barcha metodlar, ularning parametrlari va qaytaradigan obyektlari tasvirlangan. Yangi funksiyani ishlatishdan oldin «Recent changes» bo'limiga qarang: ba'zi parametrlar eskiradi yoki o'zgaradi. Ingliz tilini yaxshi bilmasangiz ham, metod nomlari va misollar ko'pincha tushunarli.
Kutubxonalar: noldan yozish shart emas
Python uchun aiogram va python-telegram-bot, JavaScript uchun grammY va Telegraf, PHP va boshqa tillar uchun ham mashhur kutubxonalar bor. Ular so'rovlarni yuborish, yangilanishlarni qabul qilish va xatolarni qayta ishlashni soddalashtiradi. Kutubxonani tanlashda yangilanib turganiga va hujjati borligiga e'tibor bering. Yangi boshlovchilar uchun avval kichik bot yozib, /start buyrug'iga javob qaytarishdan boshlash, keyin esa tugmalar va ma'lumotlar bazasini qo'shish eng oson yo'l.
Telegram'dagi o'yin
TotalHash Telegram'dagi bepul mayning o'yini. Vazifalar TON hamyoniga kichik miqdorda USD₮ va GRAM yuboradi. Daromad va'da qilinmaydi.
Telegram'dagi bepul o'yin.
TotalHash'ni ochishQisqa javoblar
Telegram Bot API nima?
Dasturlar Telegram bot orqali xabar yuborishi va qabul qilishi uchun rasmiy HTTPS interfeys.
getUpdates va webhook farqi nima?
getUpdates'da bot o'zi so'raydi, webhook'da Telegram yangilanishlarni o'zi yuboradi.
Telegram bot hujjatlari qayerda?
core.telegram.org saytida.
Bot qancha xabar yubora oladi?
Cheklangan; limitdan oshsa, server kutish vaqtini aytadi.