टेलीग्राम
टेलीग्राम AiHummer का उत्पादन-ग्रेड, अनुशंसित पहला चैनल है। यह असली लोगों के सामने एक काम करने वाले एजेंट को प्राप्त करने का सबसे तेज़ तरीका है: एक बॉट बनाएं @BotFather, कनेक्टर को टोकन दें, और इनबाउंड संदेश गेटवे की ओर बहना शुरू हो जाएंगे।
टेलीग्राम कनेक्टर इन-प्रोडक्ट से इंस्टॉल किया गया है बाजार और एडमिन यूआई में कॉन्फ़िगर किया गया। यह होस्ट-नेटिव रूप में चलता है और इनबाउंड एपीआई के माध्यम से गेटवे से बात करता है, इसलिए यह टर्न इंजन से स्वतंत्र रूप से स्केल और रिस्टार्ट होता है।
6 चरणों में टेलीग्राम कनेक्ट करें
यहाँ शून्य से लेकर एक बॉट तक का संपूर्ण मार्ग है जो आपको Telegram में जवाब देता है। आपको केवल एक Telegram खाता और अपने AiHummer वेब एडमिन UI तक पहुँच की आवश्यकता है।
- BotFather के साथ एक बॉट बनाएं। टेलीग्राम में खोलें
@BotFather, भेजें
/newbot, और बॉट का नाम सेट करें और यूज़रनेम। जो आप देखेंगे: BotFather लौटाता है एक टोकन पसंद123456789:AA…— यह बॉट की एक्सेस कुंजी है, इसे कॉपी करें। - टेलीग्राम कनेक्टर स्थापित करें। एडमिन UI में खोलें प्लगइन्स/मार्केटप्लेस, में टेलीग्राम कनेक्टर ढूंढें कैटलॉग और ‘इंस्टॉल’ पर क्लिक करें। कार्ड के ‘ऑनलाइन’ होने तक प्रतीक्षा करें (एक इंस्टॉल) प्रगति बार दिखाया गया है)।
- टोकन चिपकाएँ। जाओ चैनल स्क्रीन → यह इंस्टॉल किए गए चैनलों को कॉन्फ़िगर करें ब्लॉक, टेलीग्राम कार्ड खोलें और पेस्ट करें बोट टोकन कनेक्टर फॉर्म से फ़ील्ड में। सहेजें।
- एक एजेंट बनाएं (अगर आपके पास अभी तक नहीं है) — देखें एजेंट्स: एक नाम और एक सिस्टम प्रॉम्प्ट पर्याप्त हैं।
- एजेंट को चैनल से बाँधें। पर चैनल स्क्रीन, में बाइंडिंग्स ब्लॉक, चुनें एक डिफ़ॉल्ट एजेंट टेलीग्राम के लिए — नियम “नई टेलीग्राम बातचीत एजेंट Y द्वारा संचालित की जाती है”। चयन तुरंत सहेज लिया जाता है।
- बॉट को संदेश भेजें। अपने बोट को टेलीग्राम में खोलें और उसे एक संदेश भेजें। क्या आप देखेंगे: एजेंट चैट में जवाब देता है, और मेल खाती बातचीत दिखाई देती है एडमिन UI में “सत्र” स्क्रीन पर।
[!NOTE] डिफ़ॉल्ट रूप से एजेंट उत्तर देता है केवल ज्ञात उपयोगकर्ता (पंजीकृत लोग AiHummer)। अगर बोट आपके संदेश पर चुप रहता है — तो या तो खुद को जोड़ें जैसा कि एक उदाहरण उपयोगकर्ता, या “केवल ज्ञात उपयोगकर्ताओं को जवाब दें” को बंद करें चैनल स्क्रीन।
टेलीग्राम से क्यों शुरू करें
टेलीग्राम किसी भी AiHummer चैनल की तुलना में सबसे कम रुकावट वाला है: कोई कैरियर नहीं, कोई OAuth सहमति स्क्रीन नहीं, कोई ऐप समीक्षा नहीं। संदेश भेजने और प्राप्त करने के लिए केवल एक बॉट टोकन पर्याप्त है, और वही कनेक्टर आंतरिक स्टाफ चैट और ग्राहक-सामना करने वाले बॉट दोनों को कवर करता है। क्योंकि यह उत्पादन-स्तरीय और पूरी तरह से परीक्षण किया हुआ है, यही वह चैनल है जिसे हम आपको AiHummer का मूल्यांकन करते समय सबसे पहले जोड़ने की सलाह देते हैं।
पोलिंग या वेबहुक
कनेक्टर दोनों इनजेशन मोड्स का समर्थन करता है, इसलिए यह काम करता है चाहे आपका गेटवे सार्वजनिक इंटरनेट से सुलभ हो या नहीं।
- लॉन्ग पोलिंग — कनेक्टर Telegram से अपडेट खींचता है। कोई इनबाउंड पोर्ट नहीं या TLS की आवश्यकता होती है, जो इसे स्थानीय विकास और निजी के लिए आदर्श बनाता है नेटवर्क्स।
- वेबहुक — टेलीग्राम अपडेट्स को एक सार्वजनिक HTTPS URL पर भेजता है। कम विलंब और टीएलएस समाप्त करने वाले रिवर्स प्रॉक्सी के पीछे उत्पादन के लिए बेहतर उपयुक्त।
कनेक्टर सुनता है पोर्ट 8800 सामान्य परिनियोजन में, या 8091 स्थानीय रन के लिए। प्रत्येक इनबाउंड संदेश को गेटवे URL पर पोस्ट किया जाता है जो में कॉन्फ़िगर किया गया है AIHUMMER_INBOUND_URL, साझा इनबाउंड सीक्रेट के साथ प्रमाणित।
समृद्ध संदेश, संदेश प्रतिक्रियाएँ और मतदान
साधारण टेक्स्ट के परे, टेलीग्राम चैनल प्रस्तुत करता है संपन्न संदेश — स्वरूपित उत्तर जो एक एजेंट के संरचित आउटपुट को टेलीग्राम की मूल संदेश सुविधाओं पर मैप करते हैं। यह भी समर्थन करता है संदेश प्रतिक्रियाएँ और सर्वेक्षण, ताकि एक एजेंट उपयोगकर्ता के संदेश पर प्रतिक्रिया दे सके या एक टर्न के हिस्से के रूप में चैट में जल्दी पोल डाल सके।
[!TIP] टेलीग्राम उस चैनल के रूप में पहचाना गया है जिसे AiHummer के रूप में जाना गया है
telegram. उस चैनल का उपयोग करें जब आप किसी एजेंट को बाइंड करते हैं या स्रोत द्वारा वार्तालाप को फ़िल्टर करते हैं तो आईडी।
समूहों में व्यवहार और प्रतिक्रियाएँ (कनेक्टर 1.0.2)
Core 1.3 हस्ताक्षरित Telegram कनेक्टर 1.0.2 को पिन करता है: यह संदेशों पर प्रतिक्रियाओं को संसाधित करता है, बटन callback अनुरोधों का सही प्रेषक कोर को देता है और समूहों में व्यवहार की सेटिंग पाई है। ये सभी कनेक्टर कार्ड पर हैं («चैनल» स्क्रीन → «इंस्टॉल किए गए चैनलों की सेटिंग»):
| सेटिंग | क्या करती है |
|---|---|
TELEGRAM_REQUIRE_MENTION |
समूहों में केवल उन संदेशों का जवाब देना जिनमें बॉट का @उल्लेख हो (डिफ़ॉल्ट रूप से बंद)। |
TELEGRAM_GROUP_HISTORY_LIMIT / TELEGRAM_DM_HISTORY_LIMIT |
समूह या निजी चैट के कितने संदेश (0–500) एजेंट के संदर्भ में जाते हैं; 0 — एजेंट नीति के अनुसार। |
TELEGRAM_GROUP_ACK_REACTION |
इमोजी प्रतिक्रिया जो बॉट समूह में उसे संबोधित संदेश पर लगाता है; खाली — नहीं लगाना। |
TELEGRAM_FORWARD_REACTIONS |
उपयोगकर्ताओं की आने वाली प्रतिक्रियाएँ घटनाओं के रूप में कोर को भेजना। |
TELEGRAM_GUEST_MODE |
अतिथि मोड: केवल ज्ञात उपयोगकर्ताओं को नहीं, किसी भी चैट में जवाब देना। |
TELEGRAM_ALLOW_BOT_TO_BOT |
अन्य बॉट के साथ आदान-प्रदान की अनुमति (लूप सुरक्षा के साथ)। |
TELEGRAM_STREAMING |
जवाब को बनते-बनते दिखाना (डिफ़ॉल्ट रूप से चालू)। |
TELEGRAM_RICH_MESSAGES |
नेटिव Rich Messages (डिफ़ॉल्ट रूप से चालू)। |
बॉट समूह के संदेश देख सके, इसके लिए BotFather में प्राइवेसी मोड बंद होना चाहिए
(/setprivacy → Disable) — अन्यथा वह चुप रहता है।
लूप गार्ड के साथ बोट-से-बोट
एजेंट अन्य बॉट्स से बात कर सकते हैं। इसे सुरक्षित बनाने के लिए, कनेक्टर एक शिप करता है लूप गार्ड: यह बच जाता है और अनियंत्रित बॉट-से-बॉट एक्सचेंज को तोड़ देता है इससे पहले कि वे अनंत पिंग- पोंग में बदल जाएँ। यह आपको बहु-बॉट वर्कफ़्लो बनाने देता है बिना पारंपरिक फीडबैक-लूप विफलता मोड के।
OIDC पर गुप्त दलाली
बोट टोकन और अन्य कनेक्टर रहस्य कभी भी सेवा में हार्ड-कोडेड नहीं होते। इसके बजाय कनेक्टर उन्हें रनटाइम पर प्राप्त करता है ओआईडीसी पर सीक्रेट्स सर्विस — यह प्रमाणीकरण करता है, फिर आवश्यक प्रमाण-पत्र प्राप्त करता है। रहस्य एन्क्रिप्टेड वॉल्ट में रहते हैं और कॉन्फ़िग फाइलों और प्रोसेस आर्गुमेंट्स से बाहर रहते हैं।
[!NOTE] इनबाउंड संदेश पोस्ट किए जाते हैं
AIHUMMER_INBOUND_URLऔर द्वारा सुरक्षित साझा HMAC इनबाउंड सीक्रेट (AIHUMMER_INBOUND_SECRET). गेटवे में होना चाहिए डिफ़ॉल्ट कार्यक्षेत्र उन्हें भेजने के लिए कॉन्फ़िगर किया गया।
अगर यह काम नहीं किया
- टेलीग्राम कनेक्टर “चैनल” स्क्रीन पर नहीं है — इसे पहले पर स्थापित करें का प्लगइन्स/मार्केटप्लेस स्क्रीन; जब तक स्थापित न हो चैनल दिखाई नहीं दे रहा है। Community में Telegram और MAX शामिल हैं।
- बोट जवाब नहीं देता — जांच करें: (1) टोकन सही ढंग से चिपकाया गया है और टेलीग्राम कार्ड “ऑनलाइन” है; (2) चैनल “बाइंडिंग्स” में एक एजेंट से जुड़ा हुआ है; (3) प्रेषक सिस्टम में पंजीकृत है (डिफ़ॉल्ट रूप से एजेंट केवल उत्तर देता है जानकारी वाले उपयोगकर्ता)।
- अगर कोई प्रदाता कॉन्फ़िगर नहीं है, तो यह त्रुटि दिखती है:
अभी तक कोई AI मॉडल प्रदाता कॉन्फ़िगर नहीं किया गया है - मॉडल अनुभाग में एक जोड़ेंमॉडल्स - “अनधिकृत” / टोकन अस्वीकृत — टोकन गलत है या रद्द कर दिया गया है; एक जेनरेट करें
नई के साथ @BotFather (
/token) और इसे फिर से चिपकाएँ। - वेबहुक नहीं आता — वेबहुक मोड में गेटवे तक पहुँचना आवश्यक है एक सार्वजनिक HTTPS URL; एक निजी नेटवर्क पर लंबी पोलिंग का उपयोग करें, जिसे किसी इनबाउंड की आवश्यकता नहीं होती पोर्ट या TLS।
अगला कहाँ
- चैनलों की तुलना करें मैक्स, बिट्रिक्स24 और एसआईपी टेलीफ़ोनी मार्गदर्शक।
- बिंडिंग और एक्सेस सेटअप — चैनल.
- गैर-चैट स्रोतों के लिए, देखें सामान्य इनबाउंड.
- एपीआई के खिलाफ निर्माण कर रहे हैं? देखें चैट/पूर्णताएँ.
इंटरैक्टिव Telegram विजेट
Telegram कनेक्टर 1.2.0, Bot API 10.4 और बॉट के साथ निजी चैट में HTML विजेट का समर्थन करता है: अधिकतम 32 KiB UTF-8 और संपीड़न के बाद 4 KiB। अनुरोध वर्तमान उपयोगकर्ता की अनुमतियों का पालन करते हैं; वॉलेट डेटा कार्रवाई की स्वीकृति नहीं है। विजेट समर्थन न होने की स्पष्ट अस्वीकृति पर सामान्य HTML अटैचमेंट भेजा जा सकता है। अनिश्चित डिलीवरी परिणाम पर बिना जाँच दोबारा नहीं भेजा जाता।