GetMyBot नॉलेज बेस

संदेश और बटन

बॉट का उत्तर टेक्स्ट, फ़ोटो और बटन से बनाएं, प्रश्न पूछें और उपयोगकर्ता का जवाब सहेजें।

इस पृष्ठ पर

बॉट से टेक्स्ट, फ़ोटो और ‘चुनें’ बटन भेजने के लिए संदेश भेजें क्रिया जोड़ें। उत्तर अलग-अलग ब्लॉक से बनता है, जैसे उत्पाद की फ़ोटो, फिर उसके नीचे बटनों वाला विवरण। संदेश के नीचे लगे बटन inline-बटन भी कहलाते हैं।

उसी क्रिया में सवाल पूछकर जवाब की प्रतीक्षा कर सकते हैं। जैसे फ़ोन नंबर पूछें और ग्राहक के रिकॉर्ड में सहेजें। आगे ब्लॉक, बटन और सवाल वाले चरण समझाए गए हैं।

संदेश ब्लॉक

ब्लॉक जोड़ें दबाकर भेजने वाली चीज़ चुनें। स्वागत टेक्स्ट, तस्वीर और कक्षा की जानकारी वाली फ़ाइल साथ रख सकते हैं।

  • टेक्स्ट: स्वरूपित टेक्स्ट, अधिकतम 4096 अक्षर, प्रतिस्थापन और बटनों के साथ।
  • फ़ोटो: कैप्शन वाली तस्वीर।
  • फ़ाइल: कैप्शन वाला दस्तावेज़।
  • Voice (वॉइस): OGG/OPUS, MP3 या M4A ऑडियो, अधिकतम 50 MB, जिसे Telegram वॉइस संदेश के रूप में दिखाता है (sendVoice)।
  • GIF: बिना आवाज़ का एनीमेशन या MP4, अधिकतम 50 MB (sendAnimation)।
  • Video note (वीडियो नोट): चौकोर MP4, अधिकतम 60 सेकंड (sendVideoNote)। इसमें कैप्शन नहीं होता। मीडिया लाइब्रेरी की फ़ाइल हर बार नई अपलोड होती है: Telegram sendVoice, sendAnimation या sendVideoNote में दूसरे तरीके से मिले file_id को स्वीकार नहीं करता।
  • Carousel (कार्डों की सूची): फ़ोटो, कैप्शन और अपने बटन वाले 2 से 10 कार्ड। Telegram में ‘‹ ›’ बटन से editMessageMedia के ज़रिए एक संदेश में कार्ड तभी बदलते हैं जब हर फ़ोटो का इस्तेमाल योग्य file_id हो। ID कार्ड में दिया गया हो सकता है या मीडिया लाइब्रेरी की फ़ाइल से मिला हो। एक फ़ोटो का भी सही ID न मिल सके तो सभी कार्ड अलग-अलग फ़ोटो संदेशों में जाते हैं। VK जैसे दूसरे चैनलों में भी अलग जाते हैं। हर कार्ड का कैप्शन और बटन बने रहते हैं।
  • देरी: अगले ब्लॉक से पहले कुछ सेकंड रुकना।
  • AI: मॉडल के प्रॉम्प्ट से बना जवाब।
  • रिएक्शन: दूसरा रिएक्शन चलाना, चाहें तो उसका परिणाम आने तक इंतज़ार करना।

Voice, GIF, Video note और Carousel भी दूसरे ब्लॉक की तरह रिएक्शन में चलते हैं और रिएक्शन के त्वरित ब्रॉडकास्ट में जाते हैं। ब्रॉडकास्ट देखें।

ब्लॉक खींचकर क्रम बदल सकते हैं। दिखाने का मोड क्रम से या विविध उत्तर के लिए यादृच्छिक है। बॉट का मुख्य मेनू जैसा है वैसा छोड़ें, नया तय करें या छिपाएं।

ब्लॉक विकल्प

टेक्स्ट और मीडिया ब्लॉक में पिन करें, बिना आवाज़, अग्रेषण से बचाव, स्पॉइलर, लिंक पूर्वावलोकन नहीं, N सेकंड बाद अपने आप हटाएं विकल्प हैं।

Inline-बटन

ब्लॉक में बटन टेक्स्ट और बटन प्रकार सेट करें:

  • टेक्स्ट: बटन का शब्द उपयोगकर्ता के जवाब की तरह भेजता है। Telegram और VK में यह उत्तर कीबोर्ड है; दबाने पर सवाल का जवाब आ सकता है या टेक्स्ट से रिएक्शन शुरू हो सकता है। WhatsApp, Instagram, Messenger और वेब-विजेट में स्थायी कीबोर्ड के बिना जवाब बटन है।
  • लिंक: URL खोलता है।
  • वेब-ऐप: Telegram Mini App खोलता है। Mini App देखें।
  • रिएक्शन: दबाने पर दूसरा रिएक्शन शुरू करता है।
  • Inline query: मौजूदा चैट के इनपुट में ‘@bot query’ रखता है या दूसरी चैट चुनने देता है (switch_inline_query/switch_inline_query_current_chat)। केवल Telegram में, @BotFather पर /setinline से inline मोड चालू करने पर। GetMyBot इन अनुरोधों का उत्तर नहीं देता (answerInlineQuery लागू नहीं है), इसलिए यह बटन केवल टेक्स्ट तैयार करता है, खोज नहीं करता।
  • Prefilled text: https://t.me/<bot>?text=… लिंक से बॉट चैट खोलकर टेक्स्ट लिखने की जगह रखता है, कुछ भेजता नहीं (prefill)।
  • Payment link: आवश्यक भुगतान URL खोलता है। भुगतान ‘भुगतान बनाएं’ क्रिया से बनता है। यह Telegram का अपना बिल नहीं, बाहरी भुगतान पृष्ठ है।
  • सूचना: दबाने पर टेक्स्ट दिखाता है, रिएक्शन नहीं चलाता और बटन का सहेजा Carry डेटा नहीं भेजता। Telegram में 200 अक्षर तक छोटी सूचना या पॉपअप; VK में बिना पॉपअप 90 अक्षर तक पट्टी।

टेक्स्ट या पहले से लिखा टेक्स्ट

कामबटन प्रकार और सेटिंगदबाने पर
फ़ॉर्म में ‘हाँ’ चुनना‘टेक्स्ट’, शब्द ‘हाँ’; संदेश उत्तर की प्रतीक्षा करे‘हाँ’ बातचीत के चरण को मिलता है
बॉट को संदेश लिखने की तैयारी‘Prefilled text’, बटन ‘लिखें’, तैयार टेक्स्ट ‘मैं ऑर्डर करना चाहता हूँ’चैट के लिखने वाले बॉक्स में ड्राफ़्ट दिखेगा; उपयोगकर्ता खुद बदलकर भेजेगा

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

रिएक्शन बटन दबाने पर बॉट को अलग callback इवेंट मिलता है। Inline query और Prefilled text Telegram ऐप के भीतर ही काम करते हैं, इसलिए उनका callback नहीं होता। वे answerCallbackQuery या Carry डेटा नहीं भेज सकते।

बटन का आइकन और रंग

बटन टेक्स्ट से पहले प्रीमियम इमोजी दिखा सकते हैं। Premium emoji ID में icon_custom_emoji_id के रूप में धनात्मक 64-बिट पूर्णांक दें। 007 को 7 माना जाता है। अक्षर, शून्य, ऋणात्मक या बहुत बड़ी संख्या हट जाएगी और बटन बिना आइकन सहेजा जाएगा।

Telegram इसे केवल ज़रूरी अधिकार वाले बॉट के लिए दिखाता है: Fragment से अतिरिक्त नाम वाला बॉट, या मालिक के पास Telegram Premium हो और सीधे निजी चैट या समूह में संदेश जाए। बाकी मामलों में Telegram इसे सामान्य इमोजी से बदले बिना अनदेखा करता है।

बटन शैली रंग तय करती है: साधारण बिना रंग, मुख्य नीला, सफलता हरा, खतरनाक लाल। तकनीकी फ़ील्ड style है।

एकल उपयोग (दबाने के बाद नष्ट करें) (single_use) सहेजे गए बटन डेटा को एक बार ही उपयोग करने देता है, जैसे चयन की पुष्टि। दबाने पर बटन का नाम बदलना या संदेश हटाना अलग सेटिंग है।

बटन फ़्लैग

फ़्लैग वह अतिरिक्त विकल्प है जिसे चेकबॉक्स से चालू या बंद करते हैं:

  • नई पंक्ति से: बटन अगली पंक्ति में जाता है।
  • पूरी चौड़ाई में फैलाएं: बटन अकेली पंक्ति लेता है और अगला बटन भी नई पंक्ति शुरू करता है।

अनुमानित रूप, वर्ग कोष्ठक बटन हैं:

एक पंक्ति:        [कैटलॉग] [मदद]

नई पंक्ति:        [कैटलॉग]
                   [मदद]

पूरी चौड़ाई:       [        मदद        ]

Telegram और VK में पंक्तियां और रंग उपलब्ध हैं। दोबारा एडिटर खोलने पर बटनों की पंक्ति व्यवस्था बनी रहती है। Telegram प्रीमियम इमोजी केवल संगत कनेक्शन पर उपलब्ध है। “Telegram के भीतर खोलें” फ़्लैग से इस व्यवहार को नियंत्रित नहीं कर सकते, क्योंकि Bot API ऐसा विकल्प नहीं देता।

चैनलों की सीमाएं

ब्लॉक या बटन का कनेक्शन चुनें। सभी चैनल पर एडिटर साझा सुविधाएं दिखाता है; असमर्थित प्रकार सहेज नहीं सकते:

  • Telegram: URL, Mini App, रिएक्शन, सूचना/alert, पंक्ति, रंग और अधिकार होने पर custom emoji।
  • VK: URL, रिएक्शन, snackbar, पंक्ति और रंग। VK Mini App और VK Pay केवल संगत VK कनेक्शन पर।
  • WhatsApp: एक संदेश में दूसरे बटन के बिना एक URL CTA बटन। सामान्य उत्तर बटन अधिकतम 3; 4 से 10 सूची में दिखते हैं। शीर्षक 20 अक्षर तक। पंक्ति, रंग, Mini App और सूचना नहीं।
  • Instagram / Messenger: मौजूदा एडाप्टर केवल उत्तर बटन (quick replies) भेजता है, शीर्षक अधिकतम 20 अक्षर। URL, Mini App, सूचना, पंक्ति और रंग नहीं।
  • वेब-विजेट: URL और उत्तर बटन, लेकिन पंक्ति, रंग और सूचना नहीं।
  • Email: भुगतान लिंक सहित लिंक, लेकिन उत्तर बटन और सूचना नहीं।

सूची से बने बटन की कॉलम संख्या केवल पंक्ति समर्थित चैनल में दे सकते हैं। दूसरे चैनल अपना लेआउट चुनते हैं। बटनों की संख्या और नाम की लंबाई भेजते समय जाँची जाती है।

दबाने पर क्या होगा

जो बटन बॉट को क्लिक भेजते हैं, उनमें समर्थित चैनल पर संदेश को टेक्स्ट या दूसरे रिएक्शन की सामग्री से बदलना, संदेश हटाना, लेबल लगाना या पैरामीटर सहेजना संभव है। दबाने के बाद बटन के अपने टेक्स्ट को बदलना केवल Telegram में है, जैसे ‘बुक करें’ से ‘चुना गया’। VK में संदेश संपादन का समर्थन बटन शीर्षक बदलने का समर्थन नहीं है।

Telegram answerCallbackQuery से क्लिक की पुष्टि चाहती है। GetMyBot आमतौर पर खुद भेजकर बटन का लोडिंग संकेत हटा देता है। answerCallbackQuery छोड़ें इसे बंद करता है।

रिएक्शन बटन के Text on press (notification) में ‘कक्षा चुनी गई’ जैसा छोटा टेक्स्ट दें। Telegram में अधिकतम 200, VK में 90 अक्षर; प्रतिस्थापन काम करता है। आम तौर पर Telegram इसे चैट के ऊपर थोड़ी देर दिखाती है। केवल Telegram का Show as a popup (alert) answerCallbackQuery के show_alert से विंडो खोलता है। टेक्स्ट खाली हो तो केवल लोडिंग संकेत हटता है। answerCallbackQuery छोड़ने पर टेक्स्ट और पॉपअप दोनों नहीं भेजे जाते।

बटन डेटा (Carry)

Carry बटन को याद दिलाता है कि वह किस चीज़ का है। कोट और ड्रेस पर समान ‘खरीदें’ बटन हो तो कोट में product_id=101 और ड्रेस में product_id=102 सहेजें। ड्रेस का बटन दबाने पर अगला रिएक्शन {{ctx.product_id}} = 102 पाएगा।

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

बटन के डेटा की वैधता, सेकंड में (ttl_seconds, TTL): 3600 एक घंटा है, 0 डिफ़ॉल्ट 30 दिन चुनता है। समय के बाद डेटा उपलब्ध नहीं। एकल उपयोग (दबाने के बाद नष्ट करें) (single_use) पहले क्लिक के बाद डेटा हटा देता है। कैटलॉग बदलने पर सहेजी कीमत नहीं बदलती; भुगतान से पहले उत्पाद ID से नई कीमत जाँचें। डायनामिक बटन और पैरामीटर देखें।

डायनामिक बटन

उत्पाद या कक्षाएं पहले से सूची में हों तो हर बटन हाथ से न बनाएं। सूची से डायनामिक बटन ब्लॉक हर आइटम का बटन बनाता है। ctx में सूची का स्थान, एक आइटम का उपनाम, प्रति पंक्ति बटन संख्या और शीर्षक टेम्पलेट दें। {{item.name}} मौजूदा उत्पाद का नाम डालेगा। डायनामिक बटन और पैरामीटर देखें।

टेक्स्ट में प्रीमियम इमोजी

टेक्स्ट ब्लॉक का प्रीमियम इमोजी फ़ॉर्मेटिंग बटन <tg-emoji emoji-id="…">🙂</tg-emoji> डालता है। Telegram Premium उपयोगकर्ता कस्टम इमोजी और बाकी लोग टैग में दिया बैकअप इमोजी देखते हैं। HTML और Markdown दोनों ब्लॉक फ़ॉर्मेट में चलता है। ID अधिकतम 32 अंकों की है। इसे getCustomEmojiStickers से या इमोजी वाला संदेश @idstickerbot जैसे बॉट को भेजकर जानें।

बॉट लिंक और पहले से लिखा टेक्स्ट

t.me/<bot>?start=<parameter> Telegram में /start <parameter> चलाता है। इस लिंक से /start के बिना पैरामीटर देकर चैट खोलना संभव नहीं।

  • चुपचाप /start: /start कमांड ट्रिगर और तय शुरू करने वाले लिंक का टैग वाले रिएक्शन में ‘संदेश भेजें’ को बिना ब्लॉक छोड़ सकते हैं। /start का साफ़ दिखाई देने वाला उत्तर नहीं होगा, पर टैग इवेंट कॉन्टेक्स्ट में मिल जाएगा और उसी रिएक्शन की शर्तों व क्रियाओं में उपयोग होगा।
  • Prefilled text: https://t.me/<bot>?text=<text> लिंक, चाहे ‘Prefilled text’ बटन हो या सामान्य लिंक बटन, चैट में टेक्स्ट लिखने की जगह रखता है, भेजता नहीं। /start नहीं चलता; उपयोगकर्ता खुद भेजता है।
  • लिंक खोलने पर ‘उपयोगकर्ता की ओर से’ अपने आप संदेश: Bot API में संभव नहीं; बॉट उपयोगकर्ता के नाम से संदेश नहीं भेज सकता। पास का विकल्प ?start= deep-link और ऐसा रिएक्शन है जो बॉट की ओर से आवश्यक टेक्स्ट भेजे।

अपेक्षित उत्तर (बातचीत के चरण)

टेक्स्ट ब्लॉक उपयोगकर्ता के उत्तर की प्रतीक्षा कर सकता है। तब संदेश बातचीत का चरण बनता है और उत्तर आने तक प्रक्रिया रुकती है। लगातार चरणों से चैट में फ़ॉर्म या निर्देशित सवाल बनते हैं।

अपेक्षित सामग्री का प्रकार

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

टेक्स्ट जाँच

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

उत्तर सहेजना

उत्तर पैरामीटर में सहेजें तो आगे {{param.key}} प्रतिस्थापन और शर्त में मिलेगा। इस तरह बातचीत के चरण ग्राहक की छोटी प्रोफ़ाइल बनाते हैं।

त्रुटि, अनुस्मारक और टाइमआउट

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

कमांड से चरण छोड़ना

/cancel या अक्षरशः रूसी शब्द отмена प्रतीक्षा हटाकर Отменено. जवाब देता है, या सेट होने पर रद्द करने वाला रिएक्शन चलाता है। दूसरे कमांड डिफ़ॉल्ट रूप से सामान्य टेक्स्ट उत्तर की तरह जाँचे जाते हैं। बॉट कमांड (जैसे /start) प्रतीक्षा रोकते हैं (escape_on_command) चालू हो तो फ़ॉर्म के बीच /start जैसा कोई भी कमांड चुपचाप प्रतीक्षा हटाकर सामान्य रूप से चलता है। हिंदी ‘रद्द’ अपने आप अंतर्निहित रद्द कमांड नहीं है।

प्रतिस्थापन

प्रतिस्थापन बटन से प्रेषक ({{first_name}}, {{username}}, {{user_id}}), इवेंट ({{text}}, {{chat_id}}, {{datetime}}) और पैरामीटर ({{param.key}}) डालें। पूरी सूची प्रतिस्थापन और फ़ॉर्मूला में है।

बॉट मेनू बटन

Menu button क्रिया सामान्य मेनू, कमांड सूची या टेक्स्ट और URL वाला Mini App बटन चुनती है। इसे मौजूदा चैट या बॉट की साझा सेटिंग पर लागू कर सकते हैं। जैसे केवल एक ग्राहक को उसका Mini App दिखाएं। उपलब्धता चैनल की क्षमताओं पर निर्भर है।

आगे क्या करें