# कमांड वेरिएबल

> KickBot के हर कमांड वेरिएबल की लिस्ट उदाहरण के साथ: Kick followage के लिए {{sender.followage}} से लेकर चैट जवाबों में रैंडम नंबर और API रिक्वेस्ट तक।

Source: https://kickbot.com/hi/docs/chat-bot/command-variables

वेरिएबल किसी कमांड के जवाब में खाली जगह की तरह होते हैं। कमांड जब भी चलती है, KickBot उसमें उस समय की असली वैल्यू डाल देता है। उदाहरण के लिए, `{{sender.followage}}` वाला `!followage` जवाब पोस्ट करता है कि दर्शक आपके Kick चैनल को कब से फ़ॉलो कर रहा है। वेरिएबल [कस्टम कमांड्स](https://kickbot.com/hi/docs/chat-bot/custom-commands) में और [बिल्ट-इन कमांड्स](https://kickbot.com/hi/docs/chat-bot/built-in-commands) के जवाबों में काम करते हैं।

हर वेरिएबल को दोनों तरफ़ दो कर्ली ब्रैकेट के साथ लिखें, ठीक वैसे ही जैसे इस पेज पर दिखाया है। छोटे-बड़े अक्षर मायने रखते हैं: `{{sender.username}}` काम करता है, `{{Sender.Username}}` नहीं।

## जवाब में वेरिएबल जोड़ें

1. [कस्टम कमांड्स](https://kickbot.com/dashboard/commands) पेज पर कोई कमांड खोलें, या **कमांड जोड़ें** पर क्लिक करें।
2. **जवाब** बॉक्स के नीचे **वेरिएबल डालें** इस्तेमाल करें। एक ग्रुप चुनें (**भेजने वाला**, **स्ट्रीमर**, **टैग किया यूज़र / पैरामीटर**, **स्ट्रीम**, **रैंडम** या **API रिक्वेस्ट**)।
3. किसी वेरिएबल पर क्लिक करें। KickBot उसे वहाँ जोड़ देता है जहाँ आपका कर्सर है।

**Kick चैट में** प्रीव्यू सैंपल वैल्यू दिखाता है, ताकि सेव करने से पहले आप जवाब जाँच सकें।

![वेरिएबल डालें मेन्यू, जिसमें स्ट्रीम ग्रुप खुला है, और followage, कैटेगरी और दर्शकों की सैंपल वैल्यू वाला प्रीव्यू है](https://kickbot.com/docs/images/chat-bot/command-variables/01-variables.webp "प्रीव्यू में सैंपल वैल्यू भरी जाती हैं। चैट में KickBot असली वैल्यू इस्तेमाल करता है।")

नीचे के उदाहरणों में KickBotDev नाम का एक दर्शक है और चैनल का नाम yourchannel है।

## भेजने वाला

वह दर्शक जिसने कमांड टाइप की।

| वेरिएबल | क्या पोस्ट करता है | उदाहरण आउटपुट |
| --- | --- | --- |
| `{{sender.username}}` | दर्शक का नाम, जैसा उसके चैनल लिंक में है (छोटे अक्षरों में) | `kickbotdev` |
| `{{sender.followers}}` | दर्शक के अपने चैनल के कितने फ़ॉलोअर्स हैं | `128` |
| `{{sender.followage}}` | दर्शक आपके चैनल को कब से फ़ॉलो कर रहा है | `4 months 12 days` |
| `{{sender.url}}` | दर्शक के Kick चैनल का लिंक | `https://kick.com/kickbotdev` |
| `{{sender.bio}}` | दर्शक की Kick प्रोफ़ाइल का बायो | `Variety streamer from Texas` |
| `{{sender.instagram}}` | दर्शक की Kick प्रोफ़ाइल पर Instagram नाम | `yourhandle` |
| `{{sender.twitter}}` | दर्शक की Kick प्रोफ़ाइल पर X (Twitter) नाम | `yourhandle` |
| `{{sender.youtube}}` | दर्शक की Kick प्रोफ़ाइल पर YouTube | `yourhandle` |
| `{{sender.discord}}` | दर्शक की Kick प्रोफ़ाइल पर Discord | `discord.gg/your-server-code` |
| `{{sender.tiktok}}` | दर्शक की Kick प्रोफ़ाइल पर TikTok नाम | `yourhandle` |
| `{{sender.facebook}}` | दर्शक की Kick प्रोफ़ाइल पर Facebook नाम | `yourhandle` |

### Kick followage

अगर दर्शक आपके चैनल को फ़ॉलो नहीं करता, तो KickBot आपके जवाब की जगह यह पोस्ट करता है: `@kickbotdev is not following @yourchannel`।

बिल्ट-इन `!followage` कमांड यही वेरिएबल इस्तेमाल करती है। इसका जवाब `@{{sender.username}} has been following for {{sender.followage}}` है, इसलिए चैट में यह `@kickbotdev has been following for 4 months 12 days` जैसा दिखता है।

## स्ट्रीमर

आप, यानी चैनल के मालिक।

| वेरिएबल | क्या पोस्ट करता है | उदाहरण आउटपुट |
| --- | --- | --- |
| `{{streamer.username}}` | आपके चैनल का नाम, जैसा आपके चैनल लिंक में है | `yourchannel` |
| `{{streamer.followers}}` | आपके फ़ॉलोअर्स की संख्या | `2450` |
| `{{streamer.url}}` | आपके Kick चैनल का लिंक | `https://kick.com/yourchannel` |
| `{{streamer.bio}}` | आपका Kick बायो | `Chill streams every night` |
| `{{streamer.instagram}}` | आपकी Kick प्रोफ़ाइल पर Instagram नाम | `yourhandle` |
| `{{streamer.twitter}}` | आपकी Kick प्रोफ़ाइल पर X (Twitter) नाम | `yourhandle` |
| `{{streamer.youtube}}` | आपकी Kick प्रोफ़ाइल पर YouTube | `yourhandle` |
| `{{streamer.discord}}` | आपकी Kick प्रोफ़ाइल पर Discord | `discord.gg/your-server-code` |
| `{{streamer.tiktok}}` | आपकी Kick प्रोफ़ाइल पर TikTok नाम | `yourhandle` |
| `{{streamer.facebook}}` | आपकी Kick प्रोफ़ाइल पर Facebook नाम | `yourhandle` |

> **Caution:** प्रोफ़ाइल वाले वेरिएबल (बायो, Instagram, X, YouTube, Discord, TikTok, Facebook) Kick प्रोफ़ाइल से पढ़ते हैं। अगर प्रोफ़ाइल पर वह फ़ील्ड खाली है, तो वेरिएबल जवाब में सादे टेक्स्ट की तरह ही रह जाता है, जैसे `{{streamer.tiktok}}`। इन्हें सिर्फ़ उन्हीं प्रोफ़ाइल के लिए इस्तेमाल करें जिनमें वह फ़ील्ड भरी हुई है।

## टैग किया यूज़र और पैरामीटर

वह टेक्स्ट या नाम जो दर्शक कमांड के बाद टाइप करता है। उदाहरण के लिए, कोई दर्शक `!so @SomeChannel` या `!hug @friend` टाइप करता है।

| वेरिएबल | क्या पोस्ट करता है | `!so @SomeChannel great stream` के लिए उदाहरण |
| --- | --- | --- |
| `{{param}}` | कमांड के बाद का पूरा टेक्स्ट | `@SomeChannel great stream` |
| `{{taggedUser.username}}` | पहले `@` के बाद का नाम | `SomeChannel` |
| `{{taggedUser.url}}` | टैग किए गए चैनल का लिंक | `https://kick.com/SomeChannel` |
| `{{taggedUser.followers}}` | टैग किए गए चैनल के फ़ॉलोअर्स की संख्या | `57` |
| `{{taggedUser.followage}}` | टैग किया गया दर्शक आपके चैनल को कब से फ़ॉलो कर रहा है | `2 months 3 days` |

टैग किए यूज़र के लिए भी प्रोफ़ाइल वाले वेरिएबल हैं: `{{taggedUser.bio}}`, `{{taggedUser.instagram}}`, `{{taggedUser.twitter}}`, `{{taggedUser.youtube}}`, `{{taggedUser.discord}}`, `{{taggedUser.tiktok}}` और `{{taggedUser.facebook}}`।

अगर दर्शक किसी को टैग नहीं करता, तो `{{taggedUser.username}}` खाली रहता है। अगर टैग किया गया नाम कोई Kick चैनल नहीं है, तो जानकारी खोजने वाले वेरिएबल (फ़ॉलोअर्स, बायो और बाकी प्रोफ़ाइल फ़ील्ड) काम नहीं कर पाते, और KickBot जवाब की जगह `404 tagged user not found` पोस्ट करता है।

उदाहरण: बिल्ट-इन `!so` (शाउट-आउट) कमांड का जवाब `Go check @{{taggedUser.username}}'s channel! {{taggedUser.url}}` है।

## स्ट्रीम

आपकी मौजूदा स्ट्रीम। ये वेरिएबल तब काम करते हैं जब आप लाइव हों।

| वेरिएबल | क्या पोस्ट करता है | उदाहरण आउटपुट |
| --- | --- | --- |
| `{{stream.title}}` | आपकी स्ट्रीम का टाइटल | `Chill stream, come hang out` |
| `{{stream.category}}` | आपकी स्ट्रीम की कैटेगरी | `Just Chatting` |
| `{{stream.viewers}}` | अभी आपके दर्शकों की संख्या | `342` |

ऑफ़लाइन रहने पर KickBot आपकी स्ट्रीम नहीं पढ़ सकता, इसलिए इन वेरिएबल वाली कमांड अपना सामान्य जवाब पोस्ट नहीं करती। इसकी जगह वह `404 stream not found` पोस्ट कर सकती है।

## रैंडम

इन्हें गेम और मज़ेदार कमांड्स के लिए इस्तेमाल करें। हर बार चलने पर नई वैल्यू चुनी जाती है।

| वेरिएबल | क्या पोस्ट करता है | उदाहरण आउटपुट |
| --- | --- | --- |
| `{{randomRange(1,100)}}` | पहले नंबर से दूसरे नंबर तक कोई पूरा नंबर, दोनों शामिल | `42` |
| `{{randomItem("rock","paper","scissors")}}` | लिस्ट में से एक आइटम, हर एक का बराबर चांस | `paper` |
| `{{randomItemPercentage("common":70,"rare":25,"legendary":5)}}` | लिस्ट में से एक आइटम, हर आइटम के लिए आपके दिए चांस के साथ | `common` |

नियम:

- `randomRange` में 0 या उससे बड़े दो पूरे नंबर होते हैं। पहला नंबर दूसरे से बड़ा नहीं होना चाहिए।
- हर आइटम को सीधे डबल कोट (`"`) में रखें, कॉमा से अलग करके। आइटम में स्पेस हो सकते हैं, जैसे `"Ask again later"`।
- `randomItemPercentage` में नंबर कोलन के ठीक बाद लिखें, बिना स्पेस के। ये नंबर वज़न (वेट) हैं। 70, 25 और 5 के साथ पहला आइटम 100 में से लगभग 70 बार आता है। `randomItemPercentage` **वेरिएबल डालें** मेन्यू में नहीं है। इसे खुद टाइप करें।

## API रिक्वेस्ट

`{{request("https://...")}}` किसी वेब एड्रेस (API) से डेटा लाता है और उसे जवाब में डाल देता है। इसे कोई जोक, गेम रैंक या कोई भी ऐसी चीज़ दिखाने के लिए इस्तेमाल करें जो कोई पब्लिक API देता है।

```text
{{request("https://uselessfacts.jsph.pl/api/v2/facts/random").text}}
```

KickBot एड्रेस खोलता है, JSON जवाब पढ़ता है और `text` फ़ील्ड पोस्ट करता है। जैसे: `The praying mantis is the only insect that can turn its head`।

यह कैसे काम करता है:

- **एक फ़ील्ड चुनें।** बंद होने वाले ब्रैकेट के बाद पाथ जोड़ें। नामों के लिए डॉट और लिस्ट आइटम के लिए `[0]` इस्तेमाल करें, जैसे `.data[0].name`। बिना पाथ के, या अगर पाथ जवाब में नहीं है, तो KickBot पूरा जवाब पोस्ट करता है।
- **एड्रेस में वेरिएबल इस्तेमाल करें।** जैसे `{{request("https://example.com/rank?user={{sender.username}}").rank}}`। KickBot वैल्यू डाल देता है और उसे वेब एड्रेस के लिए सुरक्षित बना देता है (स्पेस `%20` बन जाता है)। रिक्वेस्ट के अंदर रिक्वेस्ट की अनुमति नहीं है।
- **सिर्फ़ GET रिक्वेस्ट।** KickBot बॉडी या हेडर नहीं भेज सकता। अगर API को की चाहिए, तो उसे एड्रेस में क्वेरी पैरामीटर के रूप में डालें।
- **लिमिट।** सिर्फ़ पब्लिक इंटरनेट पर `http` और `https` एड्रेस। KickBot जवाब के लिए ज़्यादा से ज़्यादा 3 सेकंड इंतज़ार करता है, इसलिए ऐसा API इस्तेमाल करें जो छोटा जवाब तेज़ी से दे।

> **Caution:** जो भी आपकी कमांड सेटिंग्स देख सकता है, वह एड्रेस में API की भी देख सकता है। सिर्फ़ ऐसी कीज़ इस्तेमाल करें जो बस पब्लिक डेटा पढ़ती हैं।

## और वेरिएबल

ये वेरिएबल काम करते हैं, लेकिन **वेरिएबल डालें** मेन्यू में नहीं हैं।

| वेरिएबल | क्या पोस्ट करता है | उदाहरण आउटपुट |
| --- | --- | --- |
| `{{user}}` | दर्शक का नाम, उसके बड़े अक्षरों के साथ | `KickBotDev` |
| `{{sender.fullUsername}}` | आगे `@` के साथ दर्शक का नाम | `@KickBotDev` |
| `{{commands}}` | चालू सभी कमांड्स, कॉमा से अलग | `commands, followage, lurk, me, so, welcome, discord` |

बिल्ट-इन `!commands` कमांड `{{commands}}` इस्तेमाल करती है। इसका जवाब `Enabled commands: {{commands}}` है।

## आम गलतियाँ

- **दो की जगह एक ब्रैकेट।** `{sender.username}` टेक्स्ट ही रह जाता है। `{{sender.username}}` इस्तेमाल करें।
- **नाम की गलत स्पेलिंग।** अनजान वेरिएबल, जैसे `{{sender.name}}`, कमांड को जवाब पोस्ट करने से रोक देता है। इस पेज से स्पेलिंग मिलाकर देखें।
- **घुमावदार कोट।** `randomItem` और `request` को सीधे कोट (`"`) चाहिए। कुछ फ़ोन और टेक्स्ट एडिटर इन्हें घुमावदार कोट (`“ ”`) में बदल देते हैं। सुरक्षित रहने के लिए इन्हें डैशबोर्ड में ही टाइप करें।

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

**मैं Kick पर followage कमांड कैसे बनाऊँ?**

KickBot में बिल्ट-इन `!followage` कमांड है, जो हर चैनल पर चालू है। अपनी खुद की बनाने के लिए `@{{sender.username}} has followed for {{sender.followage}}` जैसे जवाब वाली कमांड जोड़ें।

**मैं कमांड में दर्शक का नाम कैसे दिखाऊँ?**

चैनल लिंक जैसे नाम के लिए `{{sender.username}}` इस्तेमाल करें, या बड़े अक्षरों वाले नाम के लिए `{{user}}`। अगर आप चाहते हैं कि Kick इसे मेंशन की तरह दिखाए, तो आगे `@` लगाएँ, जैसे `@{{sender.username}}`।

**क्या कोई कमांड मेरे दर्शकों की संख्या या स्ट्रीम टाइटल दिखा सकती है?**

हाँ। `{{stream.viewers}}` और `{{stream.title}}` इस्तेमाल करें। ये तब काम करते हैं जब आप लाइव हों।