X Bot सपोर्ट: ट्रबलशूटिंग, FAQ & कॉन्टैक्ट गाइड

ज़्यादातर समस्याएँ एक ही /setup एक्शन से ठीक हो जाती हैं। इस पेज का पहला आधा हिस्सा आपको सेल्फ़-डायग्नोसिस फ़्लो से गुज़ारता है; दूसरा आधा FAQ है। अगर इनमें से किसी से भी समाधान न मिले, तो सबसे नीचे का कॉन्टैक्ट फ़ॉर्म सीधे BWS डेवलपर सपोर्ट चैनल पर जाता है।

पहले — सेल्फ़-डायग्नोसिस फ़्लो

Open /setup → ℹ️ About in your chat.
└─ Copy that text. It's everything support needs to triage.

Then ask yourself, in order:

  1. Does the bot reply to /setup at all?
     ├─ No  → bot was kicked or demoted from admin → re-promote and retry
     └─ Yes → continue.

  2. Did /setup → 📊 Reports → ⚡ Generate report now produce something
     within 3 minutes?
     ├─ No DM, no post → check next question.
     ├─ DM "no posts found"  → filter too narrow or no on-topic posts;
                                /setup → 🎯 Filters to see
                                the literal X API query.
     ├─ DM "credit exhausted" → /setup → 💳 Buy Credits → 💰 Buy.
     ├─ Post landed but image looks wrong → re-fire; if persistent,
                                contact support with the chat ID.
     └─ Post landed correctly → you're fine.

  3. Are scheduled reports arriving?
     ├─ No  → /setup top screen shows the cron. Compare to actual UTC time.
              The bot's first scheduled fire happens AFTER the next cron tick,
              not immediately after setup.
     └─ Yes → all good.

अगर इनमें से किसी से भी समाधान न मिले, तो FAQ के बाद कॉन्टैक्ट लिंक तक स्क्रॉल करें।

FAQ

सेटअप और इंस्टॉल

प्र. जब मैं बॉट को जोड़ता हूँ तो वह जवाब नहीं देता। कन्फ़र्म करें कि वह admin प्रमोट है, सिर्फ़ "member" नहीं। Telegram → ग्रुप सेटिंग्स → Administrators। री-प्रमोशन तुरंत होता है; बॉट को दोबारा इंस्टॉल करने की ज़रूरत नहीं।

प्र. क्या मैं बॉट को किसी दूसरे ग्रुप में ले जा सकता हूँ? हाँ — इसे नए ग्रुप में जोड़ें, वहाँ /setup चलाएँ। दोनों चैट्स स्वतंत्र हैं (अलग चैट ID = अलग सेटिंग्स, शेड्यूल्स, स्कोर)। चैट्स के बीच कोई डेटा माइग्रेशन नहीं है।

प्र. बॉट मेन थ्रेड में रिपोर्ट करता है, पर मेरे ग्रुप में टॉपिक्स हैं — क्या मैं रीडायरेक्ट कर सकता हूँ? वांछित फ़ोरम टॉपिक के अंदर से भेजें:

/set_topic Reports

भविष्य की रिपोर्ट्स उसी टॉपिक में जाएँगी। /set_topic clear से रीसेट करें।

प्र. मैं कैसे अनइंस्टॉल करूँ?

• पहले रिपोर्ट्स रोकें: /setup → ⏰ Schedule → ✕ Disable schedule।
• बॉट हटाएँ: Telegram → group → admins → @BWS_X_Bot को किक करें।
• सेटिंग्स डेटाबेस में बनी रहती हैं। बॉट को उसी चैट ID में दोबारा जोड़ने पर सब कुछ फिर से शुरू हो जाता है। हार्ड डिलीट के लिए support से पूछें।

रिपोर्ट्स और फ़िल्टरिंग

प्र. मेरे नंबर थर्ड-पार्टी ट्रैकर्स से अलग क्यों हैं? X Bot सीधे आधिकारिक X API से डेटा लेता है। ज़्यादातर थर्ड-पार्टी ट्रैकर्स स्क्रैप या एक्सट्रापोलेट करते हैं — हमने 20–50% की विसंगतियाँ मापी हैं। X API नंबर ही सोर्स ऑफ़ ट्रुथ है।

प्र. लीडरबोर्ड ऐसे यूज़र्स दिखाता है जिनकी मुझे उम्मीद नहीं थी। फ़िल्टर्स एडिटिव हैं। अगर कोई चैट $YOUR_TOKEN कैशटैग ट्रैक करती है, तो वह कैशटैग ट्वीट करने वाला कोई भी रैंक होता है, सिर्फ़ आपके लिस्ट किए गए अकाउंट्स नहीं। किसी अकाउंट और कैशटैग दोनों को अनिवार्य बनाने के लिए /set_x_filtering के ज़रिए from:@x cashtags:$YOUR_TOKEN फ़ॉर्म इस्तेमाल करें (नेम्ड फ़िल्टर्स का AND-of-everything सेमांटिक)।

प्र. रिपोर्ट "0 posts" कहती है — अब क्या करें? संभावना के क्रम में तीन विकल्प:

1. फ़िल्टर बहुत संकरा है — /setup → 🎯 Filters लिटरल X API क्वेरी दिखाता है। आम टाइपो: $BTC (ट्रेलिंग स्पेस) बनाम $BTC।
2. अवधि बहुत संकरी है — अगर आपने कस्टम अवधि सेट की है, तो उस विंडो के बाहर की पोस्ट्स नहीं गिनी जातीं। /setup → 📊 Reports → 🗑 Clear period रोलिंग 24 h पर वापस लाता है।
3. जिन अकाउंट्स को आप ट्रैक करते हैं उन्होंने सच में 24 h में कुछ ऑन-टॉपिक पोस्ट नहीं किया — फ़ॉलबैक सिग्नल के लिए कैशटैग्स या कीवर्ड्स से बढ़ाएँ।

प्र. क्या मैं किसी प्राइवेट/प्रोटेक्टेड X अकाउंट को ट्रैक कर सकता हूँ? नहीं — X API सिर्फ़ पब्लिक पोस्ट्स रिटर्न करता है।

प्र. क्या मैं किसी चैट के लीडरबोर्ड से खास यूज़र्स एक्सक्लूड कर सकता हूँ (जैसे स्पैम बॉट्स)? हाँ: /setup → 🎯 Filters → 🙈 Ignore → ➕ Add। सूचीबद्ध हैंडल फ़ेच के बाद नतीजों से हटा दिए जाते हैं।

प्र. मेरी चैट में दिन में कई बार रिपोर्ट क्यों फ़ायर होती है? या तो आपने मल्टी-फ़ायर cron सेट किया है (cron(0 14,22 ? * * *)) या आपके पास एक ही शेड्यूल पर चलने वाले कई नेम्ड फ़िल्टर्स हैं। हर नेम्ड फ़िल्टर अपनी अलग रिपोर्ट बनाता है।

प्र. "Best Tweet" चुनाव अजीब लगता है। AI सिलेक्टर सबसे ज़्यादा-एंगेजमेंट वाली उस पोस्ट को चुनता है जो हाल में नहीं चुनी गई। अगर नतीजे लगातार अजीब लगें, तो support से संपर्क करें — प्रॉम्प्ट ट्यून-योग्य है।

X Posts Auto-relay

प्र. रिले ने एक साथ 6 पोस्ट्स का एक थ्रेड फ़ॉरवर्ड कर दिया। मुझे सिर्फ़ पहली चाहिए थी। यह X API का exclude=replies है जो सिर्फ़ दूसरे यूज़र्स को दिए गए रिप्लाई फ़िल्टर करता है; सेल्फ़-रिप्लाई (थ्रेड कंटीन्यूएशंस) इसे बायपास कर जाती हैं। /setup → 📡 X Posts Auto-relay → @account → ☐ Thread continuations ऑफ़ करें। बॉट फिर सिर्फ़ हर थ्रेड का हेड रखता है।

प्र. रिले दिन के बीच में फ़ॉरवर्ड करना बंद कर गई। प्रति-रिले स्क्रीन चेक करें — अगर Today: 10/10 forwarded दिखे, तो आपने डेली कैप हिट कर दी। बढ़ाने के लिए ✏️ Cap टैप करें। कैप UTC आधी रात को अपने-आप रीसेट होती है।

प्र. रिले ⏸ Paused दिखाती है पर मैंने कभी पॉज़ नहीं किया। बॉट Telegram chat-gone एरर्स (किक / ब्लॉक / चैट अपग्रेड) पर अपने-आप पॉज़ हो जाता है और पोलिंग शेड्यूल रोक देता है। /setup → 📡 X Posts Auto-relay में वह रो दिखती है, अगर आप बॉट को दोबारा जोड़ें।

बिलिंग और क्रेडिट्स

प्र. "क्रेडिट" बिल्कुल क्या है? एक क्रेडिट = X API से रिटर्न हुई एक पोस्ट। FREE चैट्स को 100 फ़्री क्रेडिट्स/महीना मिलते हैं; PRO चैट्स Stripe (सब्सक्रिप्शन) या ETH (क्रेडिट पैक) के ज़रिए बिल होती हैं।

प्र. मुझे अपना क्रेडिट बैलेंस कहाँ दिखता है?/setup → 💳 Buy Credits। इस्तेमाल हुए / बचे / रीसेट डेट दिखाता है।

प्र. मैंने अभी-अभी पे किया पर मेरा बैलेंस / प्लान अपडेट नहीं हुआ।

• Stripe पाथ (कार्ड सब्सक्रिप्शन): वेबहुक आमतौर पर कुछ सेकंड में PRO एक्टिवेट कर देता है। अगर 5+ मिनट बाद भी /setup → 💳 Buy Credits में PRO ✓ न दिखे, तो अपनी Stripe रसीद और चैट ID के साथ support से संपर्क करें।
• ETH पाथ (क्रेडिट पैक): ऑन-चेन कन्फ़र्मेशन में 1–3 मिनट लग सकते हैं। अगर 10 मिनट बाद भी क्रेडिट्स न दिखें, तो ट्रांज़ैक्शन हैश और चैट ID के साथ support से संपर्क करें।

प्र. क्या मेरी एक ही चैट पर Stripe सब्सक्रिप्शन AND ETH क्रेडिट्स दोनों हो सकते हैं? हाँ — वे लेयर होते हैं। जो PRO·credits चैट सब्सक्राइब करती है वह अपना मौजूदा ETH बैलेंस रखती रहती है, और प्रति-फ़ेच बिलिंग सब्सक्रिप्शन के मंथली ग्रांट के शुरू होने से पहले ETH क्रेडिट्स खर्च करती है। व्यावहारिक असर: अगर आपके पास 5,000 ETH क्रेडिट्स हैं और आप सब्सक्राइब करते हैं, तो पहली 5,000 फ़ेच बिल्कुल Stripe को नहीं छूतीं; बाद की फ़ेच सब के 1,000/महीना ग्रांट का इस्तेमाल करती हैं; उससे आगे $0.02/पोस्ट मीटर्ड ओवरेज है। ETH बैलेंस कभी एक्सपायर नहीं होता।

एक शर्त: जो चैट पहले से PRO·sub पर है वह आज उसी buy फ़्लो से एक नया ETH पैक नहीं जोड़ सकती (buy कमांड इसे ब्लॉक करता है)। क्रेडिट्स-ओनली पर वापस स्विच करने के लिए पहले सब्सक्रिप्शन कैंसिल करें।

प्र. मेरी PRO·credits बैलेंस ज़ीरो पर पहुँचने पर क्या होता है? लाइसेंस अपने-आप FREE पर डाउनग्रेड हो जाता है। बॉट 100/महीना FREE कैप के तहत फ़ेच करना जारी रखता है, जब तक वह भी खत्म न हो जाए। फिर अगला /setup → 💳 → 💰 Buy दोनों पाथ फिर से देता है।

प्र. क्रेडिट बैलेंस प्रति-चैट है या प्रति-यूज़र? प्रति-चैट। हर Telegram ग्रुप का अपना क्रेडिट और लाइसेंस होता है।

पब्लिक डैशबोर्ड

प्र. मेरा प्रोजेक्ट xbot.ninja पर नहीं दिखता।मौजूदा महीने में तीनों थ्रेशोल्ड पूरे होने चाहिए:

• टॉप यूज़र स्कोर ≥ 300
• ट्रैक की गई पोस्ट्स ≥ 5
• सक्रिय यूज़र्स ≥ 2

पहला महीना आमतौर पर सबसे बड़ी रुकावट होता है। डायरेक्ट URL https://xbot.ninja/?chatId=<your-id> फिर भी काम करता है।

प्र. मुझे अपनी चैट ID कैसे मिलेगी?/setup → ℹ️ About। नेगेटिव-प्रीफ़िक्स्ड लंबा इंटीजर।

प्र. क्या मैं पब्लिक xbot.ninja कार्ड को कस्टमाइज़ कर सकता हूँ?/setup → 🎨 Customization। Name, Description, Logo, URLs सेट करें। अगले रिपोर्ट साइकल पर कार्ड रीफ़्रेश होता है।

X API की खासियतें

प्र. कुछ पोस्ट्स अपेक्षा से ज़्यादा पुरानी क्यों गिनी जाती हैं? बॉट tweets/search/all (फ़ुल-आर्काइव एंडपॉइंट) इस्तेमाल करता है। जब आप एक अवधि सेट करते हैं, तो बॉट उसके अंदर कभी भी की गई पोस्ट्स फ़ेच कर सकता है। डिफ़ॉल्ट रोलिंग 24 h है, पर एक कस्टम अवधि बैकडेटेड हो सकती है।

प्र. कभी-कभी किसी पोस्ट को रिले में दिखने में 5+ मिनट लग जाते हैं। X Posts Auto-relay हर 5 मिनट में पोल करता है। लेटेंसी एक पोलिंग इंटरवल तक हो सकती है (~2.5 मिनट औसत / ~5 मिनट सबसे खराब स्थिति)। साथ ही थोड़ी X API + Telegram डिलीवरी लेटेंसी।

प्र. X API ने एरर लौटाया — ऑपरेटर को क्या दिखता है? इंटरनल एरर काउंटर्स बढ़ते हैं, तय किए गए एडमिन्स को एक प्राइवेट DM मिलता है (कॉन्फ़िगर करने के लिए /setup → 👥 Admins)। आम 4xx कोड्स: 401/403 (ऑपरेटर-साइड क्रेडेंशियल्स), 402 (क्रेडिट्स खत्म), 429 (रेट-लिमिटेड — बॉट बैकऑफ़ के साथ रीट्राई करता है)।

सपोर्ट रिक्वेस्ट में क्या शामिल करें

यह टेम्पलेट कॉपी-पेस्ट करें:

Project: <your project name>
Chat ID: <from /setup → ℹ️ About>
Plan: FREE / PRO·credits / PRO·sub
What's wrong: <1–2 sentences>
What you tried: </setup → … → … steps you ran>
When it broke: <approx UTC time>
Recent change: <any new filter / schedule / payment in the last 24 h>

अकेली चैट ID support को 80% ट्राएज जानकारी दे देती है — कृपया इसे हमेशा शामिल करें।

अपेक्षित रिस्पॉन्स टाइम

• Critical: बॉट प्लेटफ़ॉर्म-वाइड ऑफ़लाइन, बिलिंग फ़ेल्योर → EU+US बिज़नेस ओवरलैप के दौरान 1 बिज़नेस घंटे के अंदर रिस्पॉन्स
• High: किसी एक चैट के लिए रिपोर्ट डिलीवर नहीं हो रही → उसी बिज़नेस डे में
• Normal: फ़ीचर सवाल, कॉन्फ़िगरेशन मदद → 1–2 बिज़नेस डे

उपयोगी लिंक

• Telegram bot: @BWS_X_Bot
• Public dashboard: xbot.ninja
• Documentation: /docs/
• GitHub issues: blockchain-web-services/bws-api-telegram-xbot
• Direct support: bws.ninja — कॉन्टैक्ट फ़ॉर्म BWS डेवलपर सपोर्ट पर रूट होता है

Support से संपर्क करने से पहले, Troubleshooting सेल्फ़-डायग्नोसिस फ़्लो को आज़माएँ — ज़्यादातर समस्याएँ पहले दो चेक्स में ही सुलझ जाती हैं।