कार्रवाइयाँ
कार्रवाइयाँ वह होती हैं जो बॉट रिएक्शन के सक्रिय होने पर करता है। एक रिएक्शन में कई कार्रवाइयाँ हो सकती हैं, वे ऊपर से नीचे क्रमशः निष्पादित होती हैं। एडिटर के कार्रवाइयाँ अनुभाग में कार्रवाई जोड़ें बटन से जोड़ी जाती हैं। कार्रवाइयाँ निष्पादन संदर्भ (ctx) और उपयोगकर्ता पैरामीटर के ज़रिए डेटा साझा करती हैं — देखें प्रतिस्थापन और फ़ॉर्मूले।
संदेश और उत्तर
- संदेश भेजें — मुख्य कार्रवाई: ब्लॉक से उत्तर बनाता है (टेक्स्ट, फ़ोटो, फ़ाइल, देरी, AI, रिएक्शन कॉल), inline बटन, मेनू और डायलॉग चरण जोड़ता है। विस्तार से — संदेश और बटन।
- संदेश सहेजें — आने वाले संदेश का टेक्स्ट उपयोगकर्ता पैरामीटर में लिखता है।
- फ़ॉरवर्ड करें — आने वाले संदेश को निर्दिष्ट चैट में फ़ॉरवर्ड करता है (वैकल्पिक टॉपिक ID के साथ)।
- सूचना — उपयोगकर्ता, चैट और टेक्स्ट डेटा के साथ सेवा चैट में सूचना भेजता है।
उपयोगकर्ता: लेबल और पैरामीटर
- लेबल बदलें — सब्सक्राइबर के लेबल जोड़ता और/या हटाता है।
- पैरामीटर बदलें — उपयोगकर्ता पैरामीटर के मान सेट करता है, हटाता है या बढ़ाता है।
मॉडरेशन
- प्राप्त हटाएं — आने वाला संदेश हटाता है (वैकल्पिक रूप से — उपयोगकर्ता के सभी संदेश, देरी से)।
- भेजे गए हटाएं — बॉट के संदेश हटाता है (इस रिएक्शन के या चैट में सभी, देरी से)।
- अधिकार बदलें — म्यूट / म्यूट हटाएं / बैन / बैन हटाएं / अधिकार सीमित करें प्रतिभागी, अस्थायी या स्थायी; प्रतिबंध के लिए विशिष्ट अधिकार चुने जाते हैं।
- महत्वपूर्ण रिएक्शन (रंग) — ऑपरेटर के लिए डायलॉग को रंग से चिह्नित करता है।
डेटा और संग्रह
- रिकॉर्ड बनाएं — संग्रह में पंक्ति जोड़ता है; "डिडुप्लिकेशन कुंजी" के साथ upsert की तरह काम करता है (डुप्लिकेट नहीं)।
- रिकॉर्ड अपडेट करें — फ़िल्टर से मेल खाने वाली पंक्तियाँ बदलता है।
- रिकॉर्ड खोजें — पंक्तियाँ संदर्भ में array के रूप में पढ़ता है (पुनरावृत्ति के लिए)।
- रिकॉर्ड हटाएं — फ़िल्टर के अनुसार पंक्तियाँ हटाता है।
- सूची पर लूप —
ctxसे array पर पुनरावृत्ति करता है और प्रत्येक तत्व के लिए नेस्टेड कार्रवाइयाँ निष्पादित करता है (उदाहरण के लिए, सूची में ब्रॉडकास्ट)।
संग्रहों के बारे में अधिक — संग्रह और डेटा।
बाहरी अनुरोध
- वेब-अनुरोध — HTTP अनुरोध (GET/POST/PUT/DELETE) हेडर, बॉडी, सफलता कोड, टाइमआउट और रिट्राई के साथ; उत्तर JSONPath से पैरामीटर या
ctxमें सहेजा जाता है; असिंक्रोनस निष्पादन और सफलता/त्रुटि पर रिएक्शन शुरू करना संभव। - URL लोड करें — पेज डाउनलोड करता है और उसका पठनीय टेक्स्ट
ctxमें सहेजता है (बाद की प्रोसेसिंग या AI के लिए)। - स्रोत से अनुरोध — जुड़े कनेक्टर (REST / OzmaDB) से
ctxमें डेटा पढ़ता है। - स्रोत में लिखें — कनेक्टर में डेटा लिखता है (POST/PUT/DELETE)।
स्रोतों और कुंजियों के बारे में — स्रोत और कुंजियाँ।
AI और गणना
- AI — भाषा मॉडल से अनुरोध करता है: प्रॉम्प्ट, पैरामीटर/
ctxमें उत्तर सहेजना, संरचना निकालने के लिए वैकल्पिक JSON-स्कीमा, उपयोगकर्ता को उत्तर भेजना। देखें AI उत्तर। - गणना — फ़ॉर्मूले या निर्णय तालिका (नियम "जब → तब", पहला सत्य जीतता है) से गणना करता है और परिणाम
ctx/पैरामीटर में सहेजता है।
लॉजिक और परिदृश्य
- चेन रिएक्शन — नाम से दूसरी रिएक्शन शुरू करती है।
- अगली रिएक्शन — सूची की अगली उपयुक्त रिएक्शन को नियंत्रण देती है।
- परिदृश्य शुरू करें — चरण-दर-चरण विज़ार्ड (flow) शुरू करता है। देखें परिदृश्य।
- पुष्टि मांगें — अनुमोदक को कार्ड भेजता है; "स्वीकृत"/"अस्वीकृत" बटन निर्धारित रिएक्शन शुरू करते हैं।
- ऑपरेटर को सौंपें — डायलॉग ऑपरेटर इनबॉक्स में ट्रांसफर करता है। देखें चैट और ऑपरेटर।
इंटीग्रेशन
GetCourse, Google Sheets और Google Drive कार्रवाइयाँ इसी नाम के इंटीग्रेशन से जुड़ती हैं (देखें इंटीग्रेशन)। रिएक्शन बिल्डर में ये कार्रवाइयाँ "जल्द" के रूप में चिह्नित हैं — अभी के लिए इंटीग्रेशन सेटिंग्स, वेब-अनुरोध या AI के ज़रिए उपयोग करें। किसी बाहरी सेवा को सार्वभौमिक भेजना Webhook इंटीग्रेशन और वेब-अनुरोध कार्रवाई के ज़रिए उपलब्ध है।
आगे क्या करें
- संदेश और बटन — उत्तर और डायलॉग बिल्डर।
- प्रतिस्थापन और फ़ॉर्मूले — टेक्स्ट और लॉजिक में वेरिएबल।