GetMyBot नॉलेज बेस

चैनल: Telegram, WhatsApp और VK

Telegram, WhatsApp और VK को एक प्रोजेक्ट से जोड़ें। जानें कि चैनलों की क्षमताएँ कैसे अलग हैं और बॉट का जवाब कहाँ जाता है।

इस पृष्ठ पर

GetMyBot का एक प्रोजेक्ट Telegram, WhatsApp और VK पर जवाब दे सकता है। उदाहरण के लिए, क्लास का समय बताने वाला एक रिएक्शन तीनों मैसेंजर में काम कर सकता है। जवाब उसी ऐप में जाता है जिससे व्यक्ति ने लिखा था।

दूसरा मैसेंजर जोड़ते समय बटन और कार्रवाइयाँ जाँचें: हर ऐप की सुविधाएँ अलग हैं। नीचे इनका अंतर और जोड़ने के चरण दिए हैं।

चैनल क्या है?

चैनल संदेश भेजने और पाने के लिए जुड़ा हुआ खाता है: कोई ख़ास Telegram बॉट, WhatsApp Business नंबर या VK समुदाय। GetMyBot के एक बॉट में कई चैनल हो सकते हैं। रिएक्शन साझा रहते हैं: ग्राहक WhatsApp पर लिखे तो संदेश उन्हीं रिएक्शन से गुज़रता है जो Telegram में हैं, और जवाब WhatsApp पर लौटता है।

बटन, टेक्स्ट फ़ॉर्मैट और कार्रवाइयाँ हर मैसेंजर में समान नहीं हैं। एडिटर अनुपलब्ध विकल्प छिपा सकता है या उसका उपलब्ध रूप इस्तेमाल कर सकता है। शुरू करने से पहले हर जुड़े चैनल में संदेश जाँचें।

मुख्य चैनल (primary_channel)

हर बॉट का एक मुख्य चैनल (primary_channel) होता है, यानी वह ऐप जिससे बॉट मुख्य रूप से जुड़ा माना जाता है। आमतौर पर यह Telegram है, लेकिन बिना Telegram के सीधे WhatsApp या VK बॉट भी बना सकते हैं। मुख्य चैनल बनाते समय तय होता है और बॉट सूची में दिखता है; दूसरे चैनल बाद में जोड़े जाते हैं।

चैनलों की क्षमताएँ

नीचे हर मैसेंजर की उपलब्ध सुविधाएँ दी गई हैं। मशीन से पढ़ी जा सकने वाली नवीनतम सूची API के GET /api/channels/capabilities से मिलती है।

Telegram: सबसे अधिक सुविधाओं वाला चैनल है। इसमें संदेश के भीतर बटन और जवाब वाला कीबोर्ड, बटन दबाने पर रिएक्शन (callback), इमोजी रिएक्शन, /start डीप लिंक, संदेश संपादित करना, हटाना और आगे भेजना, किसी संदेश के जवाब को ट्रिगर बनाना, सदस्य संबंधी घटनाएँ, अधिकार और मॉडरेशन उपलब्ध हैं। सही फ़ाइल ID हों तो फ़ोटो कैरोसेल के कार्ड एक ही संदेश में बटन से बदले जाते हैं। टेक्स्ट फ़ॉर्मैट: Plain / HTML / Markdown। WhatsApp के टेम्पलेट, सूची और 24 घंटे की सेशन विंडो यहाँ नहीं हैं; Telegram को इनकी ज़रूरत नहीं होती।

WhatsApp (WhatsApp Cloud API): संदेश के भीतर बटन, callback, इमोजी रिएक्शन और /start डीप लिंक के अलावा संदेश टेम्पलेट, इंटरैक्टिव सूची (interactive list) और 24 घंटे की सेशन विंडो देता है। टेक्स्ट फ़ॉर्मैट: Plain / Markdown। जवाब वाला स्थायी कीबोर्ड, संदेश संपादित करना, हटाना और आगे भेजना, जवाब को ट्रिगर बनाना, सदस्य घटनाएँ, अधिकार और मॉडरेशन, तथा एक संदेश में कैरोसेल पलटना समर्थित नहीं है। विवरण: WhatsApp।

VK: संदेश और अटैचमेंट, संदेश के भीतर बटन और जवाब वाला कीबोर्ड, callback, इमोजी रिएक्शन, /start डीप लिंक, संदेश संपादित करना, हटाना और आगे भेजना, सदस्य घटनाएँ, ब्लॉक और अनब्लॉक करना, बंद समुदाय में पहले से दिए गए शामिल होने के अनुरोध को स्वीकार करना और भुगतान सदस्यता के VK Donut इवेंट उपलब्ध हैं। यह सिर्फ़ साधारण टेक्स्ट दिखाता है; HTML/Markdown रेंडर होते समय हटा दिए जाते हैं। WhatsApp टेम्पलेट, सूचियाँ, एक संदेश में कैरोसेल पलटना और सेशन विंडो VK में नहीं हैं।

सभी चैनलों में संदेश के भीतर बटन, callback, इमोजी रिएक्शन और /start डीप लिंक उपलब्ध हैं। फ़ोटो समर्थित हो तो फ़ोटो कैरोसेल ब्लॉक भी इस्तेमाल किया जा सकता है। Telegram में कार्ड एक ही संदेश में तभी पलटते हैं जब हर फ़ोटो के लिए उपयुक्त file_id हो। WhatsApp और VK में, और Telegram में भी अगर किसी एक फ़ोटो का ID नहीं मिल पाता, तो सभी कार्ड अलग-अलग फ़ोटो संदेश बनकर जाते हैं; हर कार्ड का कैप्शन और बटन बना रहता है। देखें संदेश और बटन।

VK Donut

समुदाय में VK Donut चालू हो तो बॉट को भुगतान सदस्यता से जुड़े ये सिस्टम इवेंट मिलते हैं:

एडिटर में इवेंटकुंजीउपलब्ध मान
VK Donut: subscription created (सदस्यता शुरू)donut_subscription_created{{event.donut_amount}}, {{event.donut_amount_without_fee}}
VK Donut: subscription prolonged (सदस्यता बढ़ी)donut_subscription_prolonged{{event.donut_amount}}, {{event.donut_amount_without_fee}}
VK Donut: subscription expired (सदस्यता समाप्त)donut_subscription_expiredकोई नहीं
VK Donut: subscription cancelled (सदस्यता रद्द)donut_subscription_cancelledकोई नहीं

{{event.donut_amount}} भुगतान की राशि है और {{event.donut_amount_without_fee}} VK की फ़ीस हटाने के बाद की राशि। समाप्ति और रद्द करने वाले इवेंट में राशि नहीं होती। भुगतान अवधि समाप्त होना नया भुगतान नहीं है; पुरानी राशि दिखाना ग़लत होगा।

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

भुगतान वाले क्लब का उदाहरण:

  1. VK Donut: subscription created और VK Donut: subscription prolonged के लिए रिएक्शन बनाएँ। लेबल बदलें से “क्लब” लेबल ttl_days = 31 दिन के लिए जोड़ें। बंद समुदाय का लिंक भेजकर ग्राहक से शामिल होने का अनुरोध करने को कहें।
  2. अनुरोध जमा होने के बाद ही स्वीकृति दें। अधिकार बदलें → शामिल होने का अनुरोध स्वीकृत करें केवल पहले से दिए गए अनुरोध को स्वीकार करता है (groups.approveRequest)। अनुरोध न हो तो स्वीकार करने के लिए कुछ नहीं है। यह कार्रवाई पहले चरण के बाद चलने वाले रिएक्शन में रखें, जैसे उसी संदेश के नीचे “मैंने अनुरोध भेजा” बटन या अगले VK Donut: subscription prolonged इवेंट पर।
  3. Label expired (label_expired) ट्रिगर पर अधिकार बदलें → हटाएँ जोड़ें। तब लेबल की अवधि ख़त्म होने पर ग्राहक क्लब से निकल जाएगा, भले VK से समाप्ति इवेंट न आया हो। देखें ट्रिगर → लेबल की अवधि समाप्त।
  4. VK Donut: subscription cancelled और VK Donut: subscription expired पर लेबल बदलें → “क्लब” हटाएँ और चाहें तो तुरंत हटाएँ भी चलाएँ।

VK में अधिकार बदलने वाली कार्रवाई का चैट (chat_id) फ़ील्ड जुड़े हुए समुदाय की संख्यात्मक ID होना चाहिए। यही संख्या VK चैनल के पास चैनल सूची में दिखती है। VK इसी समुदाय के सदस्यों को संभाल सकता है। दूसरी ID देने पर कार्रवाई VK को भेजने से पहले ही अस्वीकार हो जाएगी। दूसरा समुदाय संभालना है तो उसे अलग चैनल के रूप में जोड़ें।

इवेंट चालू करने का तरीका:

  • Long Poll: चैनल कनेक्ट होने पर और प्लेटफ़ॉर्म की हर शुरुआत में बॉट इन इवेंट का सब्सक्रिप्शन खुद करता है। पहले से जुड़े समुदायों के लिए कुछ और करने की ज़रूरत नहीं।
  • Callback API: समुदाय सेटिंग में API के साथ काम → Callback API → इवेंट के प्रकार → VK Donut खोलें और तालिका के चारों इवेंट चालू करें।

चैनल कैसे जोड़ें?

चैनल प्रोजेक्ट पेज से जोड़े जाते हैं:

  1. प्रोजेक्ट खोलकर सही प्रोजेक्ट ढूँढें।
  2. प्रोजेक्ट कार्ड में चैनल जोड़ें दबाएँ।
  3. Telegram, WhatsApp या VK चुनें।
  4. चैनल का विवरण दें: Telegram टोकन, WhatsApp के Meta विवरण या VK समुदाय के विवरण।
  5. सत्यापित करें दबाएँ। प्लेटफ़ॉर्म मैसेंजर से विवरण की जाँच करेगा।
  6. कनेक्ट करें दबाएँ।

WhatsApp और VK जुड़ने के बाद चैनल के पास 🔗 आइकन से webhook पता दिखाई देता है। इनकमिंग इवेंट बॉट तक पहुँचाने के लिए यह पता संबंधित प्लेटफ़ॉर्म पर दर्ज करें: WhatsApp के लिए Meta ऐप में और VK के लिए समुदाय सेटिंग में। WhatsApp के लिए webhook सेटअप देखें।

आगे क्या करें?

चैनल के क्रेडेंशियल

Telegram को BotFather का पूरा टोकन चाहिए। VK के लिए समुदाय टोकन और उसकी संख्यात्मक ID चाहिए; Callback API इस्तेमाल करें तो गुप्त स्ट्रिंग और पुष्टि कोड भी चाहिए। WhatsApp के लिए Phone Number ID, WhatsApp Business Account ID, अकाउंट एक्सेस टोकन, webhook Verify Token और Meta ऐप का App Secret भरें।

कनेक्ट करने से पहले जानकारी जाँच लें। कोई कुंजी बदलते समय प्रदाता के यहाँ उससे जुड़ी सेटिंग भी बदलें: Verify Token webhook पते की पुष्टि करता है और App Secret इनकमिंग इवेंट के हस्ताक्षर जाँचता है। ये API एक्सेस टोकन का विकल्प नहीं हैं।

आने वाले इवेंट और webhook पते

VK Callback API के लिए MyBot में दिखा पता समुदाय की सर्वर सेटिंग में दर्ज करें और दोनों तरफ़ एक जैसी गुप्त स्ट्रिंग और पुष्टि कोड दें। Long Poll के लिए सार्वजनिक पता या ये दोनों मान नहीं चाहिए। WhatsApp में पता Meta ऐप में दर्ज करें, वही Verify Token दें और आवश्यक संदेश इवेंट सब्सक्राइब करें। केवल संदेश भेजने के क्रेडेंशियल दर्ज करने से इनकमिंग संदेश चालू नहीं होते।

Instagram और Messenger को अनुमति देना

कनेक्शन विज़ार्ड Meta का अनुमति पेज खोलता है। उस अकाउंट से साइन इन करें जो संबंधित Facebook पेज या प्रोफ़ेशनल Instagram अकाउंट चलाता है, माँगी गई अनुमतियाँ दें और इस प्रोजेक्ट के लिए अकाउंट चुनें। विज़ार्ड अधिकार, webhook सब्सक्रिप्शन और संदेश डिलीवरी की तैयारी जाँचता है। चैनल इस्तेमाल करने से पहले असफल जाँचें ठीक करें। पहले से जुड़े कनेक्शन में चुने गए अकाउंट बाद में फिर देख सकते हैं।