टेलीग्राम बॉट और Stars: पेड एक्शन प्लेबुक

अगर किसी क्रिएटर के पास पहले से टेलीग्राम ऑडियंस है, तो एक बॉट उस ऑडियंस को पेड एक्शन में बदल सकता है: एक रिपोर्ट, एक फ़ाइल, एक क्रेडिट पैक, एक निजी कमांड, एक मिनी-सेवा, या मीडिया से जुड़ा कोई अनलॉक।

मुश्किल हिस्सा बटन नहीं है। मुश्किल हिस्सा हैंडऑफ़ है। खरीदार को पर्याप्त Stars चाहिए, बॉट को एक साफ़ इनवॉइस चाहिए, और पेड एक्शन तभी अनलॉक होना चाहिए जब टेलीग्राम भुगतान की पुष्टि कर दे।

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

त्वरित उत्तर

एक टेलीग्राम बॉट पेड एक्शन तब सबसे अच्छा काम करता है जब आप ऑफ़र को छोटा और सत्यापन-योग्य रखते हैं।

यह फ्लो अपनाएँ:

1. एक पेड एक्शन तय करें।
2. खरीदार को दिखाएँ कि उसे क्या मिलेगा।
3. उस एक्शन के लिए एक Stars इनवॉइस भेजें।
4. भुगतान स्वीकार करने से पहले प्री-चेकआउट अनुरोध जाँचें।
5. केवल सफल भुगतान इवेंट के बाद ही डिलीवर करें।
6. भुगतान का संदर्भ संग्रहीत करें ताकि सपोर्ट और रिफंड अनुमान न रहें।
7. खरीदारों को बताएँ कि अनलॉक के पल से पहले Stars कैसे पाएँ।

टेलीग्राम के Stars पेमेंट दस्तावेज़ डिजिटल वस्तुओं और सेवाओं के लिए बुनियादी इनवॉइस क्रम बताते हैं: sendInvoice, pre_checkout_query, answerPreCheckoutQuery, successful_payment, फिर डिलीवरी। Bot API इन भुगतानों के लिए Stars करेंसी टैग के रूप में XTR का उपयोग करता है।

यही तकनीकी रीढ़ है। क्रिएटर का काम इससे सरल है: पेड एक्शन को इतना स्पष्ट बनाना कि खरीदार जान सके कि वह Stars क्यों खर्च कर रहा है।

यह प्लेबुक क्या कवर करती है

इस प्लेबुक का उपयोग बॉट द्वारा दिए जाने वाले पेड एक्शन के लिए करें, जैसे:

• एक डाउनलोड-योग्य फ़ाइल अनलॉक करना;
• एक निजी रिपोर्ट बनाना;
• किसी बॉट खाते में क्रेडिट जोड़ना;
• एक पेड कमांड खोलना;
• एक कस्टम चेकलिस्ट, प्रॉम्प्ट पैक, चार्ट या टेम्पलेट देना;
• बॉट द्वारा संभाली गई एक बार की सेवा तक पहुँच देना।

इन्हें हर टेलीग्राम Stars फ्लो के साथ न मिलाएँ।

पेड मीडिया भुगतान वाली तस्वीरों, वीडियो और समर्थित मीडिया अनलॉक के लिए है। अगर आपका उत्पाद एक मीडिया ड्रॉप है, तो टेलीग्राम पेड मीडिया खरीदार गाइड और टेलीग्राम पेड मीडिया की Stars में कीमत तय करने वाली गाइड पढ़ें।

Star सब्सक्रिप्शन मासिक शुल्क वाले एक पेड इन्वाइट लिंक के ज़रिए किसी चैनल तक पहुँच को सीमित करते हैं। मिनी ऐप्स भी Stars का उपयोग कर सकते हैं, पर खरीदार का फ्लो अलग है। अगर ऐसा है, तो Stars से टेलीग्राम मिनी ऐप्स के लिए भुगतान करने वाली गाइड का उपयोग करें।

अगर आपको पहले व्यापक नक्शा चाहिए, तो Stars से टेलीग्राम सामग्री को मॉनेटाइज़ करने के तरीके से शुरू करें।

चरण 1: पेड एक्शन तय करें

इनवॉइस से शुरू न करें। उस चीज़ से शुरू करें जो खरीदार को मिलती है।

कमज़ोर पेड-एक्शन वादे ऐसे लगते हैं:

• "प्रीमियम एक्सेस।"
• "और अनलॉक करें।"
• "बॉट का समर्थन करें।"
• "अतिरिक्त सामग्री पाएँ।"

ये पंक्तियाँ सपोर्ट सवाल पैदा करती हैं क्योंकि खरीदार बता नहीं पाता कि भुगतान के बाद क्या बदलता है।

एक मज़बूत पेड-एक्शन वादा विशिष्ट होता है:

• "एक निजी ऑडिट रिपोर्ट बनाएँ।"
• "पूरा PDF टेम्पलेट पैक अनलॉक करें।"
• "अपने बॉट बैलेंस में 50 क्रेडिट जोड़ें।"
• "उन्नत चार्ट कमांड एक बार चलाएँ।"
• "इस पाठ के लिए निजी चेकलिस्ट खोलें।"

कुछ भी कीमत तय करने से पहले एक वाक्य लिखें:

भुगतान के बाद, खरीदार को मिलता है ________।

अगर वाक्य अस्पष्ट है, तो बॉट फ्लो भी अस्पष्ट लगेगा।

चरण 2: Stars इनवॉइस भेजें

एक मानक बॉट इनवॉइस के लिए, टेलीग्राम की Bot API मेथड sendInvoice है। Stars भुगतान के लिए, इनवॉइस Stars करेंसी टैग XTR का उपयोग करता है।

एक व्यावहारिक इनवॉइस चेकलिस्ट:

• currency को XTR रखें;
• जहाँ टेलीग्राम दस्तावेज़ अनुमति दें, वहाँ Stars भुगतान के लिए प्रोवाइडर टोकन खाली रखें;
• एक Stars भुगतान के लिए एक ही प्राइस आइटम का उपयोग करें;
• अपना आंतरिक ऑर्डर संदर्भ payload में रखें;
• शीर्षक और विवरण इतना छोटा रखें कि खरीदार एक्शन पहचान सके;
• एक ही payload को असंबंधित एक्शन के लिए दोबारा उपयोग न करें।

payload मायने रखता है क्योंकि भुगतान स्क्रीन आपका पूरा ऑर्डर सिस्टम नहीं है। आपके बॉट को फिर भी जानना होता है कि यह इनवॉइस किस उपयोगकर्ता, एक्शन और कीमत से संबंधित है।

अच्छे आंतरिक payload डेटा में आमतौर पर शामिल होते हैं:

• खरीदार उपयोगकर्ता ID;
• पेड एक्शन ID;
• अपेक्षित Stars राशि;
• ऑर्डर टाइमस्टैम्प;
• nonce या यूनिक ऑर्डर ID;
• created, pending, paid, delivered या refunded जैसा स्टेटस।

सार्वजनिक इनवॉइस टेक्स्ट को मानवीय रखें। खरीदार को आंतरिक ID या डेवलपर भाषा नहीं दिखनी चाहिए।

ख़राब इनवॉइस शीर्षक:

SKU_XTR_CMD_ADV_2026

बेहतर इनवॉइस शीर्षक:

उन्नत चार्ट रिपोर्ट

ख़राब इनवॉइस विवरण:

कॉलबैक सत्यापन के बाद पेड एक्शन निष्पादित करें।

बेहतर इनवॉइस विवरण:

इस बॉट से एक निजी चार्ट रिपोर्ट अनलॉक करें।

चरण 3: प्री-चेकआउट को एक सुरक्षा-रेलिंग की तरह संभालें

टेलीग्राम भुगतान पूरा होने से पहले एक प्री-चेकआउट क्वेरी भेजता है। इसे एक औपचारिकता नहीं, बल्कि अंतिम सुरक्षा जाँच मानें।

अनुमोदन से पहले पुष्टि करें कि:

• उपयोगकर्ता अब भी ऑर्डर से मेल खाता है;
• पेड एक्शन अब भी मौजूद है;
• अपेक्षित Stars राशि अब भी मेल खाती है;
• एक्शन अब भी उपलब्ध है;
• ऑर्डर पहले से भुगतान या रद्द नहीं हुआ है;
• payload की समय-सीमा समाप्त नहीं हुई है।

अगर कुछ मेल न खाए, तो प्री-चेकआउट क्वेरी को एक स्पष्ट त्रुटि संदेश के साथ अस्वीकार करें। किसी पुराने इनवॉइस को ग़लत एक्शन अनलॉक न करने दें।

यह उन बॉट्स के लिए ख़ासकर ज़रूरी है जो सीमित आइटम, समयबद्ध एक्सेस या जनरेट किए गए आउटपुट बेचते हैं। कोई उपयोगकर्ता ऑफ़र बदलने के बाद किसी पुराने इनवॉइस लिंक पर टैप कर सकता है। आपके बॉट को पता होना चाहिए कि क्या करना है।

चरण 4: केवल सफलता के बाद डिलीवर करें

बटन टैप करना भुगतान नहीं है। प्री-चेकआउट अनुमोदन डिलीवरी नहीं है। टेलीग्राम द्वारा सफल भुगतान इवेंट भेजने के बाद डिलीवर करें।

एक साफ़ डिलीवरी फ्लो ऐसा दिखता है:

1. successful_payment प्राप्त करें।
2. इसे आंतरिक ऑर्डर से मिलाएँ।
3. टेलीग्राम पेमेंट चार्ज ID संग्रहीत करें।
4. ऑर्डर को भुगतान-किया-गया चिह्नित करें।
5. पेड एक्शन डिलीवर करें।
6. ऑर्डर को डिलीवर-किया-गया चिह्नित करें।
7. खरीदार को एक छोटा पुष्टि संदेश भेजें।

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

सपोर्ट को व्यावहारिक रखें। अगर आप ऑर्डर ID, पेड एक्शन, Stars राशि, पेमेंट चार्ज ID और डिलीवरी स्टेटस संग्रहीत करते हैं, तो आप अधिकांश सपोर्ट सवालों का उत्तर चैट इतिहास खंगाले बिना दे सकते हैं।

चरण 5: खरीदार का टॉप-अप समय स्पष्ट बनाएँ

खरीदार वाला पक्ष भूलना आसान है। क्रिएटर आमतौर पर बॉट को तब टेस्ट करते हैं जब उनके पास पहले से Stars होते हैं। असली खरीदार खाली बैलेंस के साथ आ सकते हैं।

टेलीग्राम के Stars पेमेंट दस्तावेज़ कहते हैं कि उपयोगकर्ता डिजिटल वस्तुओं और सेवाओं के लिए भुगतान करने से पहले ज़रूरत पड़ने पर Stars प्राप्त कर सकते हैं। इसका यह अर्थ नहीं कि यह अतिरिक्त कदम हर खरीदार के लिए घर्षण-रहित है। अगर आपका पेड एक्शन किसी ख़ास समय पर लाइव होता है, तो ऑडियंस को पहले ही सचेत करें।

एक सरल लॉन्च संदेश ऐसा कह सकता है:

बॉट टेलीग्राम Stars से पेड रिपोर्ट अनलॉक करेगा। अगर आपके पास अभी पर्याप्त Stars नहीं हैं, तो लॉन्च से पहले टॉप-अप कर लें ताकि चेकआउट के दौरान ऐसा न करना पड़े।

यहीं MyStars स्वाभाविक रूप से फिट बैठता है। क्रिएटर को पेड एक्शन के लिए खरीदार को टेलीग्राम से बाहर ले जाने की ज़रूरत नहीं है। उन्हें बस यह चाहिए कि खरीदारों के पास अनलॉक के पल से पहले Stars तैयार हों। खरीदारों को ड्रॉप से पहले टेलीग्राम Stars टॉप-अप करें पर भेजें, न कि तब जब वे पहले ही निराश हो चुके हों।

अगर आप पेड मीडिया ड्रॉप भी चलाते हैं, तो टीज़र, खरीदार रिमाइंडर और लॉन्च के बाद मापन शेड्यूल करने के लिए पेड मीडिया लॉन्च प्लान का उपयोग करें।

निर्णय शाखाएँ

अगर पेड वैल्यू एक फ़ाइल या टेम्पलेट है

भुगतान को एक-बार का रखें। सफल भुगतान के बाद फ़ाइल डिलीवर करें, फिर एक छोटा रसीद-शैली संदेश भेजें।

खरीदार को फ़ाइल के लिए किसी एडमिन से मैन्युअल रूप से न पूछना पड़े। इससे एक बॉट फ्लो एक सपोर्ट कतार में बदल जाता है।

अगर पेड वैल्यू एक जनरेट की गई रिपोर्ट है

खरीदार को बताएँ कि रिपोर्ट तत्काल है या कतार में।

अगर जनरेशन विफल हो सकती है, तो भुगतान पुष्टि को डिलीवरी स्टेटस से अलग करें:

• भुगतान हुआ, बन रही है;
• भुगतान हुआ, डिलीवर हुई;
• भुगतान हुआ, विफल - सपोर्ट चाहिए।

इससे रिफंड और सपोर्ट आसान होते हैं।

अगर पेड वैल्यू क्रेडिट हैं

क्रेडिट केवल सफल भुगतान के बाद जोड़ें। नया बैलेंस तुरंत दिखाएँ।

अगर क्रेडिट समाप्त होते हैं, तो चेकआउट से पहले बताएँ। छिपे हुए समाप्ति नियम शिकायतें पैदा करते हैं।

अगर पेड वैल्यू मीडिया है

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

अगर पेड वैल्यू चैनल एक्सेस है

वह एक Star सब्सक्रिप्शन या कोई अन्य एक्सेस फ्लो हो सकता है, एक-बार का बॉट एक्शन नहीं। अपने टेक्स्ट में मासिक एक्सेस, एक-बार के पेड एक्शन और पेड मीडिया को अलग रखें।

जिन गलतियों से बचें

• यह बताए बिना कि क्या अनलॉक होता है, एक अस्पष्ट प्रीमियम वादा बेचना।
• बटन टैप को भुगतान मानना।
• सफल भुगतान के बजाय प्री-चेकआउट के बाद डिलीवर करना।
• टेलीग्राम पेमेंट चार्ज ID संग्रहीत करना भूल जाना।
• एक payload फ़ॉर्मैट को असंबंधित एक्शन के लिए दोबारा उपयोग करना।
• पुराने इनवॉइस लिंक को बदले हुए ऑफ़र अनलॉक करने देना।
• भुगतान के बाद तक समाप्ति या उपयोग सीमाएँ छिपाना।
• खरीदार को दिखने वाले इनवॉइस टेक्स्ट में डेवलपर लेबल का उपयोग करना।
• खरीदारों को टॉप-अप के लिए तभी भेजना जब लॉन्च पहले ही शुरू हो चुका हो।
• हर Stars फ्लो को पेड पोस्ट कहना, जो पेड मीडिया, सब्सक्रिप्शन, बॉट इनवॉइस और केवल-टेक्स्ट चैनल सामग्री को भ्रमित कर सकता है।

समस्या निवारण

खरीदार कहता है उसने भुगतान किया, पर बॉट ने अनलॉक नहीं किया

संभावित कारण:

• बॉट को successful_payment नहीं मिला या उसने प्रोसेस नहीं किया;
• आंतरिक ऑर्डर ID payload से मेल नहीं खाया;
• भुगतान के बाद डिलीवरी विफल हुई;
• बॉट ने ऑर्डर को भुगतान-किया-गया चिह्नित किया पर डिलीवर-किया-गया नहीं।

समाधान:

• उपयोगकर्ता ID और ऑर्डर ID से खोजें;
• संग्रहीत पेमेंट चार्ज ID जाँचें;
• पेड एक्शन स्टेटस सत्यापित करें;
• अगर भुगतान सफल रहा और आइटम मान्य है तो मैन्युअल रूप से डिलीवर करें;
• विफलता को लॉग करें ताकि वही बग दोबारा न हो।

खरीदार भुगतान नहीं कर पा रहा क्योंकि उसके पास Stars नहीं हैं

संभावित कारण:

• खरीदार पर्याप्त Stars तैयार किए बिना भुगतान के पल तक पहुँच गया।

समाधान:

• एक लॉन्च-पूर्व रिमाइंडर जोड़ें;
• लॉन्च निर्देशों में एक टेलीग्राम Stars टॉप-अप करें लिंक शामिल करें;
• बॉट का भुगतान संदेश छोटा और स्पष्ट रखें;
• टॉप-अप मार्गदर्शन को किसी लंबी घोषणा में न दबाएँ।

प्री-चेकआउट विफल होता है

संभावित कारण:

• ऑर्डर की समय-सीमा समाप्त हो गई;
• payload ग़लत-स्वरूप में है;
• अपेक्षित राशि बदल गई;
• पेड एक्शन अब उपलब्ध नहीं है;
• बॉट ने ऑर्डर पहले ही प्रोसेस कर दिया।

समाधान:

• एक स्पष्ट त्रुटि संदेश लौटाएँ;
• उपयोगकर्ता को एक नया इनवॉइस बनाने दें;
• बिना स्पष्टीकरण के चुपचाप विफल होने से बचें।

कोई रिफंड या सपोर्ट अनुरोध आता है

संभावित कारण:

• खरीदार ने ग़लत एक्शन के लिए भुगतान किया;
• डिलीवरी विफल हुई;
• ऑफ़र टेक्स्ट अस्पष्ट था;
• खरीदार ने सब्सक्रिप्शन या मीडिया अनलॉक की उम्मीद की, पर एक बॉट एक्शन ख़रीदा।

समाधान:

• पेमेंट चार्ज ID और डिलीवरी लॉग जाँचें;
• तय करें कि आपकी नीति और टेलीग्राम के उपलब्ध तरीक़ों के अनुसार रिफंड उपयुक्त है या नहीं;
• अगर कई खरीदार एक ही बिंदु को ग़लत समझते हैं तो ऑफ़र दोबारा लिखें।

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

क्या एक टेलीग्राम बॉट किसी पेड एक्शन के लिए Stars स्वीकार कर सकता है?

हाँ, टेलीग्राम के Stars पेमेंट दस्तावेज़ बॉट और मिनी ऐप्स के ज़रिए बिकने वाली डिजिटल वस्तुओं और सेवाओं को कवर करते हैं। बॉट इनवॉइस के लिए ज़रूरी हिस्से हैं Stars करेंसी टैग XTR, प्री-चेकआउट हैंडलिंग, सफल भुगतान की पुष्टि, और भुगतान के बाद डिलीवरी।

XTR का क्या अर्थ है?

XTR वह करेंसी टैग है जिसका उपयोग टेलीग्राम Bot API पेमेंट फ्लो में Stars के लिए करता है। Stars को सामान्य फिएट करेंसी कोड की तरह मानने के बजाय Stars इनवॉइस के लिए इसी का उपयोग करें।

क्या Stars इनवॉइस को पेमेंट प्रोवाइडर टोकन की ज़रूरत होती है?

टेलीग्राम के Bot API दस्तावेज़ कहते हैं कि जहाँ यह पैरामीटर दिखे वहाँ टेलीग्राम Stars भुगतान के लिए खाली प्रोवाइडर टोकन पास करें। लागू करने से पहले मौजूदा Bot API दस्तावेज़ जाँचें, क्योंकि API के विवरण बदल सकते हैं।

बॉट को एक्शन कब डिलीवर करना चाहिए?

सफल भुगतान इवेंट के बाद, न कि उपयोगकर्ता द्वारा भुगतान बटन दबाने के बाद, और केवल प्री-चेकआउट अनुमोदन के बाद भी नहीं।

अगर खरीदार के पास पर्याप्त Stars न हों तो क्या करें?

लॉन्च से पहले खरीदारों को सचेत करें। वे पहले अपना बैलेंस तैयार कर सकते हैं, फिर बॉट इनवॉइस दिखने पर टेलीग्राम के भीतर ही अनलॉक कर सकते हैं। अगर उन्हें और Stars चाहिए, तो उन्हें टेलीग्राम Stars टॉप-अप करें पर भेजें।

क्या बॉट पेड एक्शन और पेड मीडिया एक ही चीज़ हैं?

नहीं। पेड मीडिया भुगतान वाली तस्वीरों, वीडियो और समर्थित मीडिया अनलॉक के लिए है। एक बॉट पेड एक्शन एक फ़ाइल, रिपोर्ट, क्रेडिट पैक, कमांड या बॉट द्वारा दी गई सेवा हो सकता है। फ्लो और टेक्स्ट अलग रखें।

क्या Stars भुगतान रिफंड किए जा सकते हैं?

टेलीग्राम के Bot API में सफल Stars भुगतान के लिए refundStarPayment शामिल है। पेमेंट चार्ज ID और अपना आंतरिक ऑर्डर स्टेटस संग्रहीत करें ताकि आप सपोर्ट और रिफंड निर्णय साफ़-सुथरे ढंग से संभाल सकें।

स्रोत और प्रमाण

• टेलीग्राम Stars लॉन्च: Telegram Stars: Pay for Digital Goods and More।
• बॉट के लिए Stars पेमेंट फ्लो: Telegram Stars Payments।
• बॉट इनवॉइस पैरामीटर: Bot API sendInvoice।
• पेड मीडिया दायरा: Bot API sendPaidMedia।
• Star सब्सक्रिप्शन और पेड मीडिया घोषणा: Telegram Super Channels, Star Reactions and Subscriptions।
• Stars शर्तें और बैलेंस दायरा: Telegram Stars Terms।

अंतिम चेकलिस्ट

एक बॉट पेड एक्शन लॉन्च करने से पहले:

• पेड एक्शन विशिष्ट है;
• इनवॉइस शीर्षक मनुष्य के पढ़ने योग्य है;
• payload एक ही आंतरिक ऑर्डर से मैप होता है;
• Stars राशि भुगतान से पहले जाँची जाती है;
• डिलीवरी सफल भुगतान के बाद होती है;
• सपोर्ट चार्ज ID और डिलीवरी स्टेटस ढूँढ सकता है;
• खरीदारों को पता है कि बॉट प्रॉम्प्ट से पहले Stars कैसे टॉप-अप करें।