Telegram Ads API & एकीकरण: अपने वर्कफ़्लो को स्वचालित करें

Telegram विज्ञापनदाताओं के लिए कोई API प्रकाशित नहीं करता: उसकी डेवलपर साइट पर Bot API, क्लाइंट API, TDLib, Gateway API और Payments API गिनाए गए हैं, और इनमें से कोई भी विज्ञापन कैंपेन न बनाता है, न उनकी रिपोर्ट देता है। ADSLY एक अधिकृत सेशन के ज़रिए आपके विज्ञापन कैबिनेट से जुड़ता है और उसके ऊपर इंटीग्रेशन के तीन रास्ते देता है — REST API, जो आपके आँकड़े पढ़ता है और आपकी इजाज़त हो तो कैंपेन भी मैनेज करता है; साइन किए हुए webhook; और एक endpoint जो आपके ट्रैकर से कन्वर्ज़न लेता है।

Telegram Ads का «API» कैसे काम करता है

Telegram का विज्ञापन प्लेटफ़ॉर्म ads.telegram.org पर है और वेब इंटरफ़ेस से चलाया जाता है। हमने अक्टूबर 2026 में Telegram का डेवलपर दस्तावेज़ जाँचा: core.telegram.org पर Bot API (बॉट के लिए Payments API के साथ), TDLib, Gateway API और क्लाइंट ऐप बनाने के लिए Telegram API पेश किए गए हैं। विज्ञापन से जुड़े उसके दो लेख हैं: Sponsored Messages क्लाइंट ऐप को बताता है कि विज्ञापन कैसे दिखाएँ, और दूसरा चैनल तथा बॉट मालिकों की विज्ञापन आय के बारे में है; दोनों में से कोई भी कैंपेन मैनेज करने वाले विज्ञापनदाता के लिए नहीं है। प्लेटफ़ॉर्म की अपनी शुरुआती गाइड में भी किसी API का ज़िक्र नहीं है।

इसलिए ADSLY उस Telegram अकाउंट के सेशन के ज़रिए काम करता है जिसके पास विज्ञापन कैबिनेट है। कैबिनेट जोड़ने के तीन तरीक़े हैं: फ़ोन नंबर डालकर Telegram में अनुरोध की पुष्टि करना, ads.telegram.org में लॉगिन रहते हुए हमारा ब्राउज़र एक्सटेंशन इस्तेमाल करना, या सेशन टोकन ख़ुद पेस्ट करना। यह अनुरोध सिर्फ़ विज्ञापन कैबिनेट को जोड़ता है, आपके निजी Telegram को नहीं। Adstat से आए कैबिनेट आपके Adstat लॉगिन से जुड़ते हैं। जुड़ने के बाद Euro, TON और Stars कैबिनेट एक ही तरह से सँभाले जाते हैं।

कैबिनेट जुड़ने के बाद ADSLY क्या करता है

वेब इंटरफ़ेस में जो कुछ क्लिक-दर-क्लिक होता है, पैनल में वह एक एक्शन बन जाता है:

कैंपेन बनाना — पूरी सेटिंग के साथ एक कैंपेन, या बल्क बिल्ड: कई टेक्स्ट × कई लिंक × चैनलों की सूची, चाहें तो हर देश, टॉपिक या डिवाइस के लिए अलग कैंपेन में बाँटकर।

CPM और बजट में बदलाव — चुने हुए हर कैंपेन पर बिड तय करना, उसे किसी रक़म या प्रतिशत से बढ़ाना या घटाना; बजट जोड़ना, घटाना या बची रक़म वापस निकालना।

रोकना, फिर चलाना और हटाना — किसी चयन, किसी ग्रुप या मौजूदा फ़िल्टर से मेल खाने वाले हर कैंपेन के लिए।

आँकड़ों का सिंक — हर कैंपेन के व्यू, क्लिक, एक्शन, ख़र्च, CTR और CPM घंटे में एक बार सहेजे जाते हैं।

टेक्स्ट, शीर्षक और मीडिया का संपादन — बल्क में, कैंपेन दोबारा बनाए बिना।

बैलेंस की निगरानी — डैशबोर्ड पर हर कैबिनेट उसके बैलेंस और सक्रिय, समीक्षा में, अस्वीकृत और रुके हुए कैंपेन की गिनती के साथ दिखता है; हर सिंक पर यह ताज़ा होता है।

डेटा एक्सपोर्ट और रिपोर्टिंग

पैनल उससे ज़्यादा इतिहास रखता है जितना एक स्टैटिस्टिक्स टैब दिखाता है, और उसे बाहर ले जाने देता है:

Excel, CSV और PDF एक्सपोर्ट — आपके चुने हुए कॉलम वाली डेटा फ़ाइल, या एक PDF रिपोर्ट — पूरे कैबिनेट, एक ग्रुप या चुने हुए कैंपेन के लिए। Pro और Agency प्लान पर उपलब्ध।

घंटेवार परफ़ॉर्मेंस डेटा — हर कैंपेन का हर घंटे एक स्नैपशॉट, 30 दिन तक रखा जाता है; लंबी अवधि रोज़ाना के जोड़ से दिखती है। दिन के घंटों के हिसाब से हमारे पास सभी कैबिनेट का कोई माप नहीं है, इसलिए अपने घंटे खोजने के लिए अपने ही कैंपेन का घंटेवार चार्ट देखिए।

सभी कैबिनेट का एनालिटिक्स — एनालिटिक्स पेज उन सभी कैबिनेट के व्यू, क्लिक और एक्शन जोड़ता है जिन तक आपकी पहुँच है। ख़र्च मुद्रा के हिसाब से अलग रहता है: यूरो, TON और Stars कभी आपस में नहीं जोड़े जाते।

बदलावों का इतिहास — कैंपेन के स्टेटस, बिड और बजट का हर बदलाव इस जानकारी के साथ दर्ज होता है कि उसे किसने या किस चीज़ ने किया — नियम और Auto CPM भी शामिल।

ऑटोमेशन हुक

नियम और अपने-आप होने वाले एक्शन हर घंटे के सिंक के बाद चलते हैं, बिना किसी के डैशबोर्ड पर नज़र रखे:

IF/THEN नियम — शर्तें व्यू, क्लिक, एक्शन, CTR, CVR, ख़र्च, CPC, CPA, CPM और बजट पर लगती हैं, और हर शर्त पूरे समय पर या पिछले 1–168 घंटों पर मापी जाती है। एक्शन: रोकना, चालू करना, CPM तय करना, CPM को किसी रक़म या प्रतिशत से बढ़ाना या घटाना, बजट जोड़ना या घटाना, या सिर्फ़ सूचना देना। उदाहरण: अगर पिछले 6 घंटों में CPM €2.50 से ऊपर है, तो बिड 15% घटा दो। नियम एक कैंपेन, एक ग्रुप, किसी चयन या पूरे कैबिनेट पर लग सकता है।

आपके अपने कन्वर्ज़न पर नियम — जब आपका ट्रैकर postback भेजने लगता है, तो वही इंजन लीड, कन्वर्ज़न, ख़रीद, रेवेन्यू, ROAS, प्रति लीड लागत और प्रति बिक्री लागत पर भी काम कर सकता है। जो कैबिनेट postback नहीं भेजता, उसे ऐसा नियम कभी नहीं रोकता: डेटा न होना «अज्ञात» माना जाता है, शून्य नहीं।

कई कैबिनेट के लिए नियमों के ड्राफ़्ट — सहेजा हुआ ड्राफ़्ट आपके ADSLY लॉगिन पर रहता है, और कैबिनेट पर लागू करें (Apply to cabinets) उसे हर टिक किए हुए कैबिनेट में कॉपी कर देता है।

Auto CPM — पैनल घंटे में एक बार जाँचता है कि विज्ञापन उन चैनलों और बॉट में सचमुच दिख रहा है या नहीं जिन्हें वह टारगेट करता है। ज़्यादातर में दिख रहा है: बिड 10% घटती है। ज़्यादातर में नहीं दिख रहा: 10% बढ़ती है। इसके लिए लगातार दो जाँचों का एक ही नतीजा चाहिए; दो बदलावों के बीच तीन घंटे का अंतर रहता है और एक कैंपेन पर दिन में ज़्यादा से ज़्यादा छह बदलाव होते हैं।

Recreate और AI Recreate — अस्वीकृत विज्ञापन अपने-आप दोबारा सबमिट होता है; AI Recreate में हर कोशिश पर टेक्स्ट नए शब्दों में लिखा जाता है। इसके लिए हम कोई रिकवरी प्रतिशत प्रकाशित नहीं करते।

एजेंसियों के लिए इंटीग्रेशन के उपयोग

इन हिस्सों से चार तरह के सेटअप बनते हैं:

क्लाइंट रिपोर्टिंग — हर क्लाइंट कैबिनेट या ग्रुप की PDF या Excel फ़ाइल एक्सपोर्ट कीजिए, या /v1/stats को उस रिपोर्टिंग टूल में खींच लीजिए जो आप पहले से इस्तेमाल करते हैं।

अलर्ट — «सूचना» एक्शन वाला नियम घंटेवार डाइजेस्ट में आता है, जो Telegram, ईमेल या ऐप के अंदर पहुँचता है। आपके अपने सिस्टम के लिए status_change webhook तब चलता है जब कोई कैंपेन Declined, Active या किसी और स्टेटस में जाता है।

अपने डैशबोर्ड — /v1/stats/total हर कैबिनेट के जोड़ और चार्ट पॉइंट लौटाता है; एक सामान्य सिंक में तीन-चार रिक्वेस्ट लगती हैं, जो एक key की 60 रिक्वेस्ट प्रति मिनट की सीमा से बहुत कम है।

ट्रैकर के साथ लूप बंद करना — लीड और बिक्री postback endpoint पर भेजिए, तो कैंपेन तालिका Telegram के अपने कॉलम के बग़ल में प्रति लीड और प्रति बिक्री लागत दिखाती है। पैनल में Keitaro, RedTrack, Binom और Voluum के लिए पेस्ट करने लायक़ तैयार postback टेम्पलेट हैं।

ADSLY REST API और webhook

API Pro और Agency अकाउंट के लिए चालू है। मेन्यू में API खोलिए, नई key (+ New key) दबाइए और चुनिए कि key किन कैबिनेट तक पहुँचेगी — एक, कई या सभी — और क्या वह कैंपेन भी मैनेज कर सकेगी। एक समय में अधिकतम पाँच key सक्रिय रह सकती हैं।

बेस URL: https://app.adsly.pro/api/v1 · प्रमाणीकरण: हेडर X-API-Key · सीमा: हर key पर 60 रिक्वेस्ट प्रति मिनट

हर key ये पढ़ सकती है:

• GET /v1/account/info — वे कैबिनेट जो यह key देख सकती है

• GET /v1/campaigns — कैंपेन और उनके मेट्रिक्स; स्टेटस, शीर्षक, बॉट या चैनल के यूज़रनेम, लैंडिंग पेज के डोमेन और विज्ञापन के प्रकार के फ़िल्टर; cursor pagination

• GET /v1/stats — किसी अवधि के लिए हर कैंपेन के आँकड़े, कैबिनेट के हिसाब से समूहित

• GET /v1/stats/total — हर कैबिनेट के जोड़ और चार्ट पॉइंट

• GET /v1/stats/analytics — टॉप कैंपेन के साथ अवधि का एनालिटिक्स

• GET /v1/campaigns/:adId/history — एक कैंपेन, एक अवधि में

• GET /v1/conversions — postback से मिले कन्वर्ज़न, कैंपेन के हिसाब से

कैंपेन मैनेज करें (Manage campaigns)। जब तक आप किसी key के लिए यह विकल्प चालू नहीं करते, वह सिर्फ़ पढ़ती है। चालू करने पर key कैंपेन बना भी सकती है (एक कॉल में 100 तक), टेक्स्ट, लिंक, CPM और डेली लिमिट बदल सकती है, कैंपेन रोक और दोबारा चला सकती है, बजट जोड़ या बचा हुआ बजट वापस ले सकती है, कॉपी कर सकती है, एक बार में 1,000 तक कैंपेन पर बल्क ऐक्शन चला सकती है, कैंपेन हटा सकती है और मीडिया अपलोड कर सकती है। कोई भी key कैबिनेट से पैसा बाहर नहीं निकाल सकती: बजट सिर्फ़ कैबिनेट के बैलेंस और उसके कैंपेन के बीच घूमता है। API से किया गया हर बदलाव पैनल में कैंपेन के इतिहास में दिखता है, और बनाने, बजट, कॉपी और बल्क वाली कॉल Idempotency-Key लेती हैं — टाइमआउट के बाद दोबारा भेजने पर काम दो बार नहीं होता।

पूरा डॉक्यूमेंटेशन adsly.pro/docs/api पर है (अंग्रेज़ी में), हर पेज के Markdown वर्ज़न और AI असिस्टेंट के लिए llms.txt इंडेक्स के साथ।

पहली बार इंटीग्रेशन करने वाले दो जगह अटकते हैं। पैसों वाले फ़ील्ड (spent, budget, cpm, cpc, cpa, ctr) सटीकता बचाने के लिए स्ट्रिंग के रूप में आते हैं, इसलिए गणना से पहले उन्हें पार्स कीजिए। और ad_id सिर्फ़ एक कैबिनेट के अंदर यूनीक है — Telegram आईडी दोबारा इस्तेमाल करता है — इसलिए उसे हमेशा account_id के साथ सहेजिए।

Webhook। key पर एक Postback URL लगाइए, तो ADSLY उस पर साइन किया हुआ JSON भेजता है: सिंक के समय किसी कैंपेन का स्टेटस बदलने पर status_change, और हर घंटे के पाँच मिनट बाद hourly_digest, जिसमें अभी-अभी बंद हुए घंटे के लिए हर कैंपेन के व्यू, क्लिक, ख़र्च और एक्शन होते हैं। हर रिक्वेस्ट में X-Adsly-Signature हेडर में HMAC-SHA256 सिग्नेचर, एक टाइमस्टैम्प और एक यूनीक डिलीवरी आईडी होती है। endpoint सार्वजनिक HTTPS होना चाहिए; असफल डिलीवरी एक बार दोहराई जाती है।

कन्वर्ज़न की रिसीविंग। key पर postback प्राप्त करें (Receive postbacks) चालू कीजिए, फिर या तो अपने बैकएंड से हेडर में key के साथ POST /v1/postback भेजिए, या ट्रैकर URL बनाएँ (Generate tracker URL) से मिला write-only URL अपने ट्रैकर को दीजिए। इवेंट lead, conversion और purchase हैं, रक़म और मुद्रा वैकल्पिक; एक रिक्वेस्ट में 1,000 तक इवेंट आ सकते हैं और एक key हर सेकंड 20 इवेंट लेती है। इवेंट अपने कैंपेन से उस वैल्यू के ज़रिए मिलाया जाता है जो विज्ञापन के लिंक में जाती है: बॉट विज्ञापनों में ?start= पैरामीटर, वेबसाइट विज्ञापनों में आपके ट्रैकर का पैरामीटर।

सुरक्षा और एक्सेस

इन कैबिनेट में असली बजट रहता है, इसलिए हर रास्ता जान-बूझकर संकरा रखा गया है:

पासवर्ड नहीं, सेशन — Telegram Ads कैबिनेट Telegram में अनुरोध की पुष्टि से, ब्राउज़र एक्सटेंशन से या सेशन टोकन से जुड़ता है। कनेक्शन विज्ञापन कैबिनेट तक सीमित है, आपके निजी Telegram तक नहीं।

डिफ़ॉल्ट रूप से सिर्फ़ पढ़ने वाली, हैश में सहेजी हुई key — जब तक मालिक कैंपेन मैनेज करें चालू न करे, key सिर्फ़ पढ़ती है, और चालू होने पर भी कैबिनेट से पैसा नहीं निकाल सकती। key SHA-256 हैश के रूप में रखी जाती हैं, इसलिए खोई हुई key वापस नहीं मिल सकती — उसे सिर्फ़ रद्द करके नई बनाई जा सकती है।

साइन किए हुए webhook — HMAC सिग्नेचर जाँचिए और जिन रिक्वेस्ट का टाइमस्टैम्प पाँच मिनट से पुराना हो, उन्हें ठुकरा दीजिए। ADSLY बिना HTTPS वाले, loopback या प्राइवेट पतों पर डिलीवरी नहीं करता।

कैबिनेट के हिसाब से टीम एक्सेस — Agency प्लान पर टीम के हर सदस्य के लिए हर कैबिनेट पर तीन में से एक स्तर तय होता है: Viewer, Manager या बिना एक्सेस। सदस्य अपनी API key ख़ुद बनाते हैं, और key सिर्फ़ उन्हीं कैबिनेट तक पहुँचती है जो उस सदस्य के साथ शेयर किए गए हैं: जहाँ वह Viewer है वहाँ सिर्फ़ पढ़ना, जहाँ Manager है वहाँ बदलाव भी।

अपने Telegram Ads वर्कफ़्लो को ऑटोमेट कीजिए। ADSLY 500,000+ कैंपेन मैनेज करता है — और Euro कैबिनेट किसी भी देश के लिए खुलता है। तीनों कैबिनेट प्रकार (TON, Euro, Stars)। IF/THEN नियम, बल्क ऑपरेशन, आँकड़ों और कैंपेन मैनेजमेंट के लिए API, webhook और एक्सपोर्ट। मुफ़्त शुरू करें — 3 दिन का Pro ट्रायल →

अक्सर पूछे जाने वाले प्रश्न

क्या Telegram Ads का कोई सार्वजनिक API है?

विज्ञापनदाताओं के लिए नहीं। Telegram की डेवलपर साइट पर Bot API, क्लाइंट API, TDLib, Gateway API और Payments API गिनाए गए हैं (अक्टूबर 2026 में जाँचा गया); इनमें से कोई भी विज्ञापन कैंपेन मैनेज नहीं करता, और Sponsored Messages सेक्शन उन ऐप के लिए है जो विज्ञापन दिखाते हैं। ads.telegram.org का विज्ञापन प्लेटफ़ॉर्म वेब इंटरफ़ेस से चलता है। ADSLY उसके ऊपर एक अधिकृत सेशन के ज़रिए काम करता है।

ADSLY मेरे Telegram Ads कैबिनेट से कैसे जुड़ता है?

उस Telegram अकाउंट के सेशन के ज़रिए जिसके पास विज्ञापन कैबिनेट है। आप फ़ोन नंबर डालने के बाद Telegram में अनुरोध की पुष्टि करते हैं, ब्राउज़र एक्सटेंशन इस्तेमाल करते हैं या सेशन टोकन पेस्ट करते हैं। अनुरोध सिर्फ़ विज्ञापन कैबिनेट को जोड़ता है। Euro, TON और Stars कैबिनेट इसी तरह जुड़ते हैं; Adstat से आए कैबिनेट Adstat लॉगिन से जुड़ते हैं।

क्या मेरा Telegram Ads डेटा ADSLY के पास सुरक्षित है?

इंटीग्रेशन के रास्ते डिज़ाइन से ही संकरे हैं। API key तब तक सिर्फ़ पढ़ती हैं जब तक आप कैंपेन मैनेज करें चालू न करें, कभी भी कैबिनेट से पैसा नहीं निकाल सकतीं और हैश के रूप में रखी जाती हैं; API से हुआ हर बदलाव कैंपेन के इतिहास में दर्ज होता है; webhook हर key के अपने सीक्रेट से साइन होते हैं और केवल सार्वजनिक HTTPS endpoint पर जाते हैं; ट्रैकर का write-only URL कन्वर्ज़न भेज सकता है पर कुछ पढ़ नहीं सकता; और Agency प्लान पर एक्सेस हर कैबिनेट और हर व्यक्ति के हिसाब से दिया जाता है।

क्या मैं Telegram Ads का डेटा Google Sheets में एक्सपोर्ट कर सकता हूँ?

Google Sheets का कोई सीधा कनेक्टर नहीं है। पैनल से CSV या Excel फ़ाइल एक्सपोर्ट करके उसे इम्पोर्ट कीजिए, या किसी स्क्रिप्ट से API पढ़िए — /v1/stats किसी भी अवधि के लिए हर कैंपेन के आँकड़े लौटाता है।

क्या ADSLY, Telegram Ads के लिए webhook सपोर्ट करता है?

हाँ। Postback URL वाली key को कैंपेन का स्टेटस बदलने पर हर बार status_change मिलता है, और घंटे में एक बार hourly_digest, जिसमें हर कैंपेन के व्यू, क्लिक, ख़र्च और एक्शन होते हैं। दोनों HMAC-SHA256 से साइन होते हैं, और key पर Test बटन एक ping भेजता है ताकि आप अपना रिसीवर जाँच सकें।

क्या ADSLY REST API अभी उपलब्ध है?

हाँ, Pro और Agency प्लान पर, और key आप पैनल में ख़ुद बनाते हैं। हर key कैबिनेट की सूची, कैंपेन, आँकड़े, एनालिटिक्स, हर कैंपेन का इतिहास और मिले हुए कन्वर्ज़न पढ़ती है — हर key पर 60 रिक्वेस्ट प्रति मिनट। जिस key में कैंपेन मैनेज करें चालू है, वह कैंपेन बना, बदल, रोक और दोबारा चला सकती है, उनमें बजट डाल सकती है, उन्हें कॉपी कर और हटा सकती है, और मीडिया अपलोड कर सकती है। डॉक्यूमेंटेशन: adsly.pro/docs/api।