टेलीग्राम बॉट API ट्यूटोरियल: अपना पहला बॉट बनाएं

सबसे तेज़ टेलीग्राम बॉट API ट्यूटोरियल में तीन कमांड हैं: BotFather से एक टोकन प्राप्त करें, संदेश पढ़ने के लिए getUpdates को कॉल करें, और जवाब देने के लिए sendMessage को कॉल करें। बॉट डेवलपमेंट में बाकी सब कुछ इसी लूप पर आधारित है। यह गाइड आपके पहले cURL अनुरोध से लेकर वेबहुक और लाइब्रेरी के साथ एक चालू बॉट तक का पूरा रास्ता बताता है।

बॉट API एक HTTP इंटरफ़ेस है, जिसका अर्थ है कि आप एप्लिकेशन कोड की एक भी लाइन लिखने से पहले इसे curl के साथ टेस्ट कर सकते हैं। यह इसे सीखने के लिए सबसे आसान API में से एक बनाता है। यदि आप एक डेवलपर हैं जो आज एक काम करने वाला बॉट चाहते हैं, या एक बिल्डर जो TeleClaw जैसे नो-कोड प्लेटफॉर्म के मुकाबले कोड का मूल्यांकन कर रहा है, तो आप सही जगह पर हैं।

अंत तक आप समझ जाएंगे कि API अनुरोधों को कैसे प्रमाणित करता है, संदेश कैसे प्राप्त और भेजे जाते हैं, लॉन्ग पोलिंग और वेबहुक के बीच क्या अंतर है, और दर सीमाएं जो अधिकांश पहले बॉट को परेशान करती हैं।

मुख्य बातें

• एक बॉट सिर्फ एक HTTP क्लाइंट है। हर विधि https://api.telegram.org/bot<TOKEN>/METHOD_NAME पर एक अनुरोध है, इसलिए शुरू करने के लिए cURL पर्याप्त है।
• तीन मुख्य विधियाँ आपको चालू करती हैं: टोकन को सत्यापित करने के लिए getMe, संदेश पढ़ने के लिए getUpdates, और जवाब देने के लिए sendMessage।
• लॉन्ग पोलिंग और वेबहुक परस्पर अनन्य हैं। स्थानीय परीक्षण के लिए पोल करें, उत्पादन के लिए वेबहुक पर स्विच करें।
• API मुफ्त है, लेकिन टेलीग्राम विभिन्न उपयोगकर्ताओं को प्रति सेकंड लगभग 30 संदेशों और प्रति चैट एक संदेश पर थोक भेजने की सीमा लगाता है।
• एक लाइब्रेरी समय बचाती है एक बार जब आपका बॉट एक स्क्रिप्ट से आगे बढ़ जाता है। python-telegram-bot, aiogram, या Telegraf का उपयोग करें।

टेलीग्राम बॉट API क्या है?

टेलीग्राम बॉट API एक HTTP-आधारित इंटरफ़ेस है जो आपके कोड को एक बॉट के माध्यम से टेलीग्राम से जोड़ता है। टेलीग्राम के डेवलपर परिचय के अनुसार, बॉट विशेष खाते होते हैं जिन्हें फ़ोन नंबर की आवश्यकता नहीं होती है और वे आपके सर्वर पर चल रहे कोड के लिए एक इंटरफ़ेस के रूप में कार्य करते हैं।

आपके द्वारा किया गया हर अनुरोध एक बॉट टोकन के बजाय एक उपयोगकर्ता खाते के साथ प्रमाणित होता है। टोकन बॉट की पहचान करता है, इसलिए आप इसे पासवर्ड की तरह मानते हैं और इसे कभी भी सार्वजनिक रिपॉजिटरी में कमिट नहीं करते हैं। टेलीग्राम के दस्तावेज़ स्पष्ट रूप से कहते हैं: अपना टोकन एक सुरक्षित स्थान पर सहेजें और इसे साझा न करें।

API स्वयं मुफ्त है। टेलीग्राम ने लॉन्च होने के बाद से बॉट API को मुफ्त में पेश किया है, जिसमें कोई प्रति-संदेश शुल्क नहीं है और आप कितने बॉट बनाते हैं इसकी कोई सीमा नहीं है। यही कारण है कि इतने सारे सामुदायिक उपकरण, सहायता सहायक और स्वचालन इस पर चलते हैं। यदि आप प्लेटफॉर्म पर नए हैं, तो टेलीग्राम बॉट कैसे बनाएं पर हमारी गाइड खाता सेटअप पक्ष को अधिक विस्तार से कवर करती है।

चरण 1: BotFather से एक बॉट टोकन प्राप्त करें

टेलीग्राम खोलें और @BotFather खोजें, जो अन्य बॉट बनाने और प्रबंधित करने के लिए आधिकारिक बॉट है। एक चैट शुरू करें और /newbot कमांड भेजें।

BotFather फिर दो चीजें क्रम में पूछता है:

1. आपके बॉट के लिए एक डिस्प्ले नाम, जैसे “First API Bot”।
2. एक उपयोगकर्ता नाम जो bot में समाप्त होता है, जैसे first_api_demo_bot।

जब आप समाप्त करते हैं, तो BotFather एक API टोकन लौटाता है जो 123456789:AAExampleTokenStringHere जैसा दिखता है। यह टोकन इस ट्यूटोरियल के बाकी हिस्सों के लिए आपको एकमात्र क्रेडेंशियल चाहिए।

ध्यान दें: आपके टोकन वाला कोई भी व्यक्ति आपके बॉट को नियंत्रित करता है। इसे स्रोत कोड में नहीं, बल्कि एक पर्यावरण चर में रखें। यदि यह लीक हो जाता है, तो BotFather को /revoke भेजें और एक नया प्राप्त करें।

चरण 2: अपनी पहली बॉट API विधि को कॉल करें

कोई भी प्रोग्राम लिखने से पहले, पुष्टि करें कि टोकन काम करता है। getMe विधि आपके बॉट के बारे में बुनियादी जानकारी लौटाती है और मानक स्वास्थ्य जांच है। <YOUR_TOKEN> को BotFather से प्राप्त मान से बदलें।

curl https://api.telegram.org/bot<YOUR_TOKEN>/getMe

एक सफल प्रतिक्रिया JSON है जिसमें "ok": true और आपके बॉट का आईडी, नाम और उपयोगकर्ता नाम होता है। यदि आपको "ok": false दिखाई देता है, तो टोकन गलत है या उसमें टाइपो है।

वह एकल अनुरोध पूरा पैटर्न है। हर टेलीग्राम बॉट API विधि एक ही आकार का अनुसरण करती है: https://api.telegram.org/bot<TOKEN>/METHOD_NAME पर एक HTTPS कॉल, क्वेरी स्ट्रिंग या POST बॉडी में पैरामीटर के साथ, और बदले में एक JSON ऑब्जेक्ट। पूरी सूची बॉट API संदर्भ में रहती है, जो आपको कभी भी आवश्यक हर विधि और ऑब्जेक्ट का दस्तावेजीकरण करती है।

चरण 3: संदेश प्राप्त करें और भेजें

अब बॉट को उपयोगी बनाएं। एक नियम है जो शुरुआती लोगों को आश्चर्यचकित करता है: एक बॉट बातचीत शुरू नहीं कर सकता। उपयोगकर्ता को पहले बॉट को संदेश भेजना होगा। तो टेलीग्राम में अपना बॉट खोलें और उसे कोई भी टेक्स्ट भेजें, जैसे “hello”।

अगला, getUpdates के साथ उस संदेश को पढ़ें, जो लॉन्ग पोलिंग का उपयोग करके आने वाले अपडेट को प्राप्त करता है और अपडेट ऑब्जेक्ट्स का एक सरणी लौटाता है।

curl https://api.telegram.org/bot<YOUR_TOKEN>/getUpdates

प्रतिक्रिया में, message.chat.id खोजें। वह chat_id वह पता है जिस पर आप जवाब देते हैं। इसे कॉपी करें, फिर sendMessage को कॉल करें:

curl -X POST https://api.telegram.org/bot<YOUR_TOKEN>/sendMessage \
 -d chat_id=<CHAT_ID> \
 -d text="Hello from my first bot"

आपका बॉट चैट में जवाब देता है। वह राउंड ट्रिप, getUpdates के साथ पढ़ें और sendMessage के साथ जवाब दें, अधिकांश टेलीग्राम बॉट के पीछे का मुख्य लूप है। text पैरामीटर प्रति संदेश 4096 वर्णों तक स्वीकार करता है, इसलिए लंबे जवाबों को विभाजित करने की आवश्यकता होती है।

इस टेलीग्राम बॉट API उदाहरण को वास्तविक कोड में बदलने पर याद रखने योग्य दो विवरण:

• ऑफसेट की पुनर्गणना करें। अपने अगले getUpdates कॉल पर अंतिम अपडेट के update_id प्लस एक को offset पैरामीटर के रूप में पास करें, या टेलीग्राम वही अपडेट लौटाता रहेगा।
• एक समय में एक विधि। getUpdates काम करना बंद कर देता है जिस क्षण आप एक वेबहुक पंजीकृत करते हैं, जो अगले चरण का विषय है।

चरण 4: लॉन्ग पोलिंग या वेबहुक चुनें

टेलीग्राम अपडेट प्राप्त करने के दो तरीके प्रदान करता है, और आप एक समय में प्रति बॉट केवल एक का उपयोग कर सकते हैं।

• लॉन्ग पोलिंग का अर्थ है कि आपका कोड बार-बार getUpdates को कॉल करता है। यह सीखने और स्थानीय विकास के लिए सबसे आसान तरीका है क्योंकि इसे किसी सार्वजनिक URL की आवश्यकता नहीं होती है, बस एक प्रक्रिया जो चलती रहती है।
• वेबहुक का अर्थ है कि टेलीग्राम प्रत्येक अपडेट को आपके HTTPS एंडपॉइंट पर एक POST अनुरोध के रूप में भेजता है जैसे ही यह होता है। यह उत्पादन मानक है: कम विलंबता, कोई निष्क्रिय पोलिंग नहीं, और यह स्थिर ट्रैफ़िक के तहत बेहतर स्केल करता है।

वेबहुक पर स्विच करने के लिए, अपने सार्वजनिक HTTPS URL को एक बार पंजीकृत करें:

curl "https://api.telegram.org/bot<YOUR_TOKEN>/setWebhook?url=https://yourdomain.com/webhook"

आपके एंडपॉइंट को एक वैध TLS प्रमाणपत्र की आवश्यकता है और इसे HTTP 200 को जल्दी से वापस करना होगा। यदि अपडेट आना बंद हो जाते हैं, तो पहला कदम हमेशा त्रुटि का निरीक्षण करना होता है। पूर्ण पंजीकरण, सत्यापन और समस्या निवारण प्रवाह के लिए, हमारी टेलीग्राम बॉट वेबहुक सेटअप गाइड देखें। संक्षिप्त संस्करण: जब आप निर्माण करते हैं तो पोलिंग से शुरू करें, लॉन्च करने से पहले वेबहुक पर जाएं।

चरण 5: API को एक लाइब्रेरी में लपेटें

कच्चा cURL सीखने के लिए बहुत अच्छा है, लेकिन उत्पादन बॉट एक लाइब्रेरी का उपयोग करते हैं। एक लाइब्रेरी API कॉल, अपडेट पार्सिंग, रिट्राई और बातचीत की स्थिति को संभालती है, इसलिए आप केवल अपने बॉट-विशिष्ट लॉजिक लिखते हैं। टेलीग्राम अपनी बॉट API नमूना पृष्ठ पर लगभग हर भाषा के लिए सामुदायिक लाइब्रेरी सूचीबद्ध करता है।

उस भाषा से चुनें जिसे आप पहले से जानते हैं:

• पायथन: python-telegram-bot शुद्ध पायथन है, पूरी तरह से एसिंक्रोनस है, और पायथन 3.10 और ऊपर का समर्थन करता है। aiogram और pyTelegramBotAPI लोकप्रिय विकल्प हैं।
• Node.js: Telegraf परिपक्व और TypeScript-अनुकूल है। node-telegram-bot-api एक लंबे समय से चला आ रहा विकल्प है।

यहां पायथन में वही इको बॉट है, जो टेलीग्राम बॉट API पायथन ट्यूटोरियल के लिए सबसे आम शुरुआती बिंदु है:

from telegram import Update
from telegram.ext import Application, MessageHandler, filters, ContextTypes

TOKEN = "YOUR_TOKEN"

async def echo(update: Update, context: ContextTypes. DEFAULT_TYPE):
 await update.message.reply_text(update.message.text)

app = Application.builder().token(TOKEN).build()
app.add_handler(MessageHandler(filters. TEXT & ~filters. COMMAND, echo))
app.run_polling()

और Telegraf के साथ Node.js समकक्ष:

import { Telegraf } from 'telegraf'

const bot = new Telegraf(process.env. BOT_TOKEN)
bot.on('text', (ctx) => ctx.reply(ctx.message.text))
bot.launch()

दोनों चरण 3 से cURL लूप के समान काम करते हैं, लेकिन कुछ पंक्तियों में और आपके लिए गंदे हिस्सों को संभाला जाता है। मारिया, एक बैकएंड डेवलपर जो एक सपोर्ट बॉट का प्रोटोटाइप कर रही थी, एक दोपहर में cURL परीक्षणों से python-telegram-bot में चली गई और उसी दिन कमांड हैंडलर और इनलाइन बटन काम कर रहे थे। API अवधारणाएं सीधे स्थानांतरित हो गईं क्योंकि लाइब्रेरी समान HTTP विधियों पर एक पतली रैपर है।

दर सीमाएं और कोटा जानने के लिए

API मुफ्त है, लेकिन यह असीमित नहीं है। टेलीग्राम के बॉट FAQ में वह मार्गदर्शन सूचीबद्ध है जो आपके बॉट को थ्रॉटल होने से बचाता है।

• प्रति चैट प्रति सेकंड एक संदेश। एक ही बातचीत में, इससे तेज़ भेजने से बचें।
• लगभग 30 संदेश प्रति सेकंड कुल जब कई अलग-अलग उपयोगकर्ताओं को भेज रहे हों। इससे अधिक होने पर आपको HTTP 429 “Too Many Requests” प्रतिक्रियाएं मिलना शुरू हो जाती हैं।
• लगभग 20 संदेश प्रति मिनट उसी समूह को।

जब एक प्रसारण को वास्तव में अधिक की आवश्यकता होती है, तो आप @BotFather में पेड ब्रॉडकास्ट सक्षम कर सकते हैं, जो प्रति सेकंड 1000 संदेशों तक की सीमा बढ़ाता है। प्रति सेकंड 30 से अधिक मुफ्त संदेशों की लागत प्रत्येक 0.1 टेलीग्राम स्टार है। अधिकांश बॉट को इसकी कभी आवश्यकता नहीं होती है, लेकिन यह जानना अच्छा है कि एक अधिसूचना सुविधा डिजाइन करने से पहले सीमा मौजूद है।

टेलीग्राम द्वारा लौटाए गए retry_after मान को पढ़कर और उतने सेकंड के लिए रुककर 429 का सम्मान करें। एक लाइब्रेरी आपके लिए इसे संभालती है, जो एक और कारण है कि एक बार जब आपका ट्रैफ़िक वास्तविक हो जाता है तो कच्चे अनुरोधों से स्नातक हो जाएं।

कोड छोड़ें: सर्वर के बिना AI बॉट

हर परियोजना को कस्टम कोडबेस की आवश्यकता नहीं होती है। यदि आपका लक्ष्य एक टेलीग्राम समूह में एक AI सहायक है, तो बॉट API एक प्लंबिंग है जिसे आप स्वयं बनाए रखना नहीं चाहते हैं, खासकर होस्टिंग, HTTPS और वेबहुक परत।

TeleClaw एक नो-कोड प्लेटफॉर्म है जो आपके लिए बॉट चलाता है और Claude AI को बॉक्स से बाहर कनेक्ट करता है। आप अपने समूह में @claw जोड़ते हैं, अपने BotFather टोकन को डैशबोर्ड में पेस्ट करते हैं, और setWebhook या दर-सीमा हैंडलिंग को छुए बिना व्यवहार को कॉन्फ़िगर करते हैं। टॉमस, जो 4,000 सदस्यों वाले क्रिप्टो समुदाय को चलाता है, ने एक आधे-अधूरे कस्टम बॉट को TeleClaw से बदल दिया और उसी शाम AI मॉडरेशन और FAQ उत्तर लाइव कर दिए।

यह नीचे वही बॉट API है। आप चुन रहे हैं कि सर्वर परत को स्वयं संचालित करना है या किसी प्लेटफॉर्म को ऐसा करने देना है। TeleClaw सुविधाओं पृष्ठ पर यह क्या कवर करता है, इसका अन्वेषण करें, और हमारे सर्वश्रेष्ठ टेलीग्राम बॉट राउंडअप में विकल्पों की तुलना करें। एक शुद्ध डैशबोर्ड निर्माण के लिए, हमारी नो-कोड टेलीग्राम चैटबॉट गाइड देखें।

निष्कर्ष

अब आपके पास टेलीग्राम बॉट API का एक काम करने वाला मानसिक मॉडल है: BotFather से एक टोकन, getMe, getUpdates, और sendMessage जैसी HTTP विधियाँ, लॉन्ग पोलिंग और वेबहुक के बीच एक विकल्प, और एक लाइब्रेरी जो आपके बॉट के बढ़ने पर सब कुछ लपेटती है। API मुफ्त, अच्छी तरह से प्रलेखित और cURL के साथ मिनटों में परीक्षण करने के लिए पर्याप्त सुलभ है।

सबसे तेज़ अगला कदम सबसे छोटा है। @BotFather खोलें, /newbot चलाएं, और टोकन की पुष्टि करने के लिए अपना पहला getMe अनुरोध भेजें। वहां से आप पायथन या नोड में निर्माण कर सकते हैं, या सर्वर को पूरी तरह से छोड़ सकते हैं। दिनों के बजाय मिनटों में एक AI-संचालित बॉट लॉन्च करने के लिए, अपने समूह में @claw जोड़ें और इसे TeleClaw डैशबोर्ड में कॉन्फ़िगर करें।