X Bot ट्रबलशूट करें: रिपोर्ट्स, फ़िल्टर्स, शेड्यूल्स, बिलिंग

हर "कुछ गड़बड़ लग रहा है, अब क्या करें" पाथ का एक कंसॉलिडेटेड इंडेक्स। installation / setup-menu / support में मौजूद मैट्रिक्स भी यहाँ रहते हैं ताकि आप तीन पेज की बजाय एक पेज सर्च कर सकें।

यहाँ से शुरू करें: अपने ग्रुप में /setup → ℹ️ About खोलें। उस स्क्रीन की चार लाइनें (चैट ID, प्लान, शेड्यूल, प्रोजेक्ट नाम) वही हैं जो support को ट्राएज के लिए चाहिए। कुछ भी करने से पहले इन्हें कॉपी कर लें।

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

इन सवालों को क्रम में चलाएँ। ज़्यादातर समस्याएँ पहले दो चेक्स में ही सुलझ जाती हैं।

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

2.  Does /setup → 📊 Reports → ⚡ Generate report now produce a post
    within 3 minutes?
    ├─ No DM, no post                  → check matrix in §"Reports not arriving"
    ├─ DM "no posts found"              → see §"Filter / no posts"
    ├─ DM "credit exhausted"            → see §"Billing & credits"
    ├─ Post landed but renders wrong    → see §"Render quality"
    └─ Post landed correctly            → you're fine.

3.  Are scheduled reports arriving on time?
    ├─ No  → see §"Schedule not firing"
    └─ Yes → all good.

4.  X Posts Auto-relay issues?
    └─ See §"X Posts Auto-relay"

अगर नीचे के मैट्रिक्स से कोई समाधान नहीं मिलता, तो Escalation तक स्क्रॉल करें।

रिपोर्ट्स नहीं आ रहीं

लक्षण	संभावित कारण	समाधान
बॉट पहले सक्रिय था, अचानक चुप हो गया	बॉट को चुपचाप एडमिन से डिमोट / किक किया गया	Telegram → ग्रुप एडमिन्स → दोबारा प्रमोट करें। फिर भी चुप हो तो support से संपर्क करें — chat-gone पर ऑटो-डिसेबल ट्रिगर हो सकता है।
Manual generate-now कुछ नहीं देता	बॉट एडमिन है पर क्रेडिट्स ज़ीरो हैं	/setup → 💳 Buy Credits। अगर FREE "100/100 used" है — मंथली रीसेट का इंतज़ार करें (महीने की 1 तारीख UTC)। अगर PRO·credits के साथ REMAINING=0 है — चैट पहले ही FREE में डाउनग्रेड हो चुकी है; टॉप अप के लिए /setup → 💳 → 💰 Buy।
Manual generate-now: "no posts found" एडमिन DM	फ़िल्टर बहुत संकरा है OR विंडो में कोई पोस्ट नहीं	/setup → 🎯 Filters। लिटरल X API क्वेरी में टाइपो चेक करें। चौड़ा करें या अवधि हटाएँ।
इमेज रेंडर होती है पर टेक्स्ट खाली है	AI कमेंट्री टाइमआउट हुई	दोबारा चलाएँ; अस्थायी है। लगातार हो तो support से संपर्क करें।
इमेज बिल्कुल रेंडर नहीं होती	अस्थायी रेंडरिंग गड़बड़ी	दोबारा चलाएँ। किसी एक चैट के लिए बार-बार फ़ेल हो रहा हो तो चैट ID के साथ support से संपर्क करें।
एडमिन DM में Error "Unauthorized" / "Forbidden"	X API टोकन समस्या (ऑपरेटर-साइड)	Support से संपर्क करें; यूज़र कुछ ठीक नहीं कर सकता।

फ़िल्टर / कोई पोस्ट नहीं

लक्षण	संभावित कारण	समाधान
रिपोर्ट में हर जगह "0 posts" दिखता है	कॉन्फ़िगर की गई अवधि में फ़िल्टर कुछ भी मैच नहीं करता	स्टेप 1: /setup → 🎯 Filters — क्वेरी कन्फ़र्म करें। स्टेप 2: /setup → 📊 Reports → 🗑 Clear period (रोलिंग 24h ज़्यादा नरम है)। स्टेप 3: फ़िल्टर्स चौड़े करें (एक कैशटैग फ़ॉलबैक जोड़ें, सख़्त कीवर्ड ग्रुप्स हटाएँ)।
लीडरबोर्ड ऐसे यूज़र्स दिखाता है जिन्हें मैंने फ़िल्टर में नहीं जोड़ा	फ़िल्टर्स एडिटिव हैं — कोई भी ट्रैक किया गया कैशटैग/कीवर्ड ट्वीट करने वाला गिना जाता है	किसी अकाउंट और कैशटैग दोनों को अनिवार्य बनाने के लिए /set_x_filtering name from:@x cashtags:$Y इस्तेमाल करें (नेम्ड फ़िल्टर, कैटेगरीज़ का AND)।
एक ही यूज़र ने लीडरबोर्ड स्पैम कर दिया	बॉट ने सही में हर पोस्ट स्कोर की	/setup → 🎯 Filters → 🙈 Ignore → ➕ Add @spammer — वे फ़ेच के बाद नतीजों से हटा दिए जाते हैं।
अजीब कैरेक्टर्स वाला कैशटैग मैच नहीं हो रहा	X API केस नॉर्मलाइज़ करता है; फ़िल्टर इनपुट में आगे/पीछे के स्पेस मायने रखते हैं	/setup → 🎯 Filters → 💵 Cashtags → ➕ Add से दोबारा जोड़ें — $ की ज़रूरत नहीं, कोई स्पेस नहीं।
नंबर-प्रीफ़िक्स्ड कैशटैग (जैसे $1INCH) ट्रैक नहीं हो रहा	लीडिंग नंबर्स के साथ X API सर्च व्यवहार असंगत हो सकता है	कैशटैग की बजाय कीवर्ड इस्तेमाल करें: 🔍 Keywords में कोट्स के साथ "$1INCH"।
"Best Tweet" चुनाव अजीब लगता है	AI डीड्युप्लिकेशन ने हाल ही में एक जैसी ट्वीट चुनी	एक साइकल का इंतज़ार करें। लगातार अजीब लगे तो रिपोर्ट करें; प्रॉम्प्ट ट्यून-योग्य है।

शेड्यूल फ़ायर नहीं हो रहा

लक्षण	संभावित कारण	समाधान
Schedule FREQUENCY_ERROR के साथ "rejected"	Cron हर 12h से ज़्यादा बार फ़ायर होने की कोशिश करता है	स्पेसिंग चेक ≥ 12h गैप लागू करता है। एरर मैसेज ज़िम्मेदार घंटों की जोड़ी बताता है। ज़्यादा चौड़ा गैप चुनें।
Schedule सेट है, पर रिपोर्ट समय पर नहीं आई	शेड्यूल्ड cron टिक के ~1–2 मिनट के अंदर फ़ायर होता है	कोई मिस मान लेने से पहले कॉन्फ़िगर किए गए समय के 5 मिनट बाद तक इंतज़ार करें। कभी-कभार अपस्ट्रीम देरी होती है पर वह अपने-आप ठीक हो जाती है।
मल्टी-फ़ायर cron सिर्फ़ एक बार फ़ायर होता है	घंटों की सूची क्रम में नहीं है या डुप्लिकेट है	cron(0 14,22 ? * * *) — बढ़ते क्रम में घंटे। cron(0 22,14 ? * * *) रिजेक्ट होता है।
Staging पर शेड्यूल हर 5 मिनट में फ़ायर होता है, prod पर नहीं	अलग RULE_NAME नेमस्पेस	कन्फ़र्म करें कि आप सही एनवायरनमेंट चेक कर रहे हैं। /setup → ℹ️ About एनवायरनमेंट दिखाता है।
टाइम ज़ोन गलत लगता है	शेड्यूल डिज़ाइन से UTC में है	अपने लोकल समय को UTC में बदलें। सेट-शेड्यूल इनपुट कुछ खास मामलों में नाम वाले टाइमज़ोन भी स्वीकार करता है — एंट्री की docstring चेक करें।
X Posts Auto-relay फ़ायर होता है पर रिपोर्ट्स नहीं	अलग-अलग cron शेड्यूल	X Posts Auto-relay प्रति-रिले 5-मिनट पोल इस्तेमाल करता है; रिपोर्ट्स चैट के मेन शेड्यूल cron (आमतौर पर डेली) का इस्तेमाल करती हैं। ये दोनों स्वतंत्र हैं।

रेंडर क्वालिटी

लक्षण	संभावित कारण	समाधान
कस्टम टाइटल / कलर रातों-रात रिवर्ट हो गया	कैश इनवैलिडेट हुआ, अगला फ़ेच नई वैल्यू दिखाता है	एक रिपोर्ट साइकल (~1 दिन) का इंतज़ार करें। अगले फ़ेच पर रेंडर कैश दोबारा बनता है।
लोगो धुंधला / कटा हुआ	सोर्स इमेज बहुत छोटी या non-square है	≥ 512×512 PNG, स्क्वेयर आस्पेक्ट में दोबारा अपलोड करें। /setup → 🎨 Customization → 🖼 Logo।
लीडरबोर्ड इमेज में यूज़रनेम ओवरफ़्लो हो रहा है	लंबा डिस्प्ले नाम	बॉट एलिप्सिस के साथ ट्रंकेट करता है; लगातार हो तभी फ़िक्स ज़रूरी।
Best-tweet टेक्स्ट में रॉ <a href> HTML दिखता है	Telegram parse mode मिसमैच	बग — ट्वीट URL के साथ रिपोर्ट करें।
रिपोर्ट इमेज और Telegram प्रीव्यू अलग हैं	Telegram पहली इमेज बाइट्स को URL से कैश करता है; प्रीसाइन्ड URLs में टाइमस्टैम्प होता है इसलिए हर फ़ेच यूनीक है	ऐसा नहीं होना चाहिए; अगर हो, तो /recreate से रोटेट करें।

X Posts Auto-relay

लक्षण	संभावित कारण	समाधान
रिले एक साथ 6-ट्वीट थ्रेड फ़ॉरवर्ड करता है	सेल्फ़-रिप्लाई X API के exclude=replies को बायपास कर जाती हैं	/setup → 📡 X Posts Auto-relay → @account → ☐ Thread continuations ऑफ़ करें। बॉट फिर सिर्फ़ हेड रखता है।
रिले दिन के बीच रुक गई	डेली कैप पहुँच गई	प्रति-रिले स्क्रीन Today: N/N forwarded दिखाती है। ✏️ Cap टैप करें और बढ़ाएँ। UTC आधी रात को रीसेट होता है।
रिले ⏸ Paused दिखाती है पर मैंने कभी पॉज़ नहीं किया	Telegram chat-gone पर ऑटो-पॉज़ हुआ (किक / ब्लॉक / चैट अपग्रेड)	बॉट ने पोलिंग शेड्यूल भी रोक दिया। रीस्टोर के लिए: /setup → 📡 X Posts Auto-relay → @account → ▶️ Resume। फिर भी फ़ेल हो, तो चैट ID ही बदल गई हो सकती है (सुपर-ग्रुप अपग्रेड) — नई चैट में बॉट दोबारा जोड़ें।
रिले के पहले पोल ने 50 पोस्ट्स फ़ॉरवर्ड कर दीं	बूटस्ट्रैप को फ़ॉरवर्ड किए बिना सिर्फ़ LAST_POST_ID सीड करना चाहिए था	ऐसा दिखे तो रिपोर्ट करें। 2026-04 में जोड़ा गया फ़िक्स इसे रोकना चाहिए।
टॉगल के बावजूद कोट ट्वीट्स दिखते रहते हैं	X API के पास कोई सर्वर-साइड exclude=quotes नहीं है — बॉट क्लाइंट-साइड फ़िल्टर करता है	टॉगल काम करता है, पर आप फिर भी API से रिटर्न हुई कोट ट्वीट्स के लिए पे करते हैं। सिर्फ़ कॉस्मेटिक बचत।
चैट डिलीट होने के बावजूद रिले हमेशा के लिए पोल करती रहती है	पुराने वर्ज़न की रिले — ऑटो-क्लीनअप 2026-05 में जोड़ा गया	Support से रिले को फ़ोर्स-स्टॉप करने के लिए कहें। नए डिप्लॉयमेंट्स अपने-आप क्लीन होते हैं।

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

लक्षण	संभावित कारण	समाधान
क्रेडिट्स खरीदे, बैलेंस नहीं बदला	Stripe वेबहुक में देरी	5 मिनट इंतज़ार करें। फिर भी गलत हो, तो Stripe रसीद + चैट ID के साथ support से संपर्क करें।
क्रेडिट काउंट अपेक्षा से ज़्यादा है	जिस अवधि में ट्रैक किया गया अकाउंट सक्रिय था उसमें रिले ने कई बार पोल किया	X Posts Auto-relay प्रति पोस्ट चार्ज करता है। रिले टैप करें → Today काउंटर चेक करें।
मैंने थोड़ा पोस्ट किया फिर भी PRO·sub पर ओवरेज चार्ज	चैट पर अन्य उपयोग (रिले, रिपोर्ट्स, फ़ेच रीट्राईज़)	/setup → 💳 Buy Credits → Usage this month। मीटर्ड चार्ज से तुलना करें।
FREE चैट को चार्ज किया गया	ऐसा नहीं होना चाहिए — FREE का कोई Stripe कस्टमर नहीं होता	तुरंत रिपोर्ट करें; यह एक बिलिंग बग है।
सब्सक्रिप्शन "canceled" दिखाता है पर मैंने कैंसिल नहीं किया	Stripe कैंसिलेशन फ़ेल्ड कार्ड ऑटो-रिन्यू से भी ट्रिगर हो सकता है	Stripe रसीदों के लिए ईमेल चेक करें, /setup → 💳 → 🛠 Manage subscription (Stripe Customer Portal) से कार्ड अपडेट करें।
सब्सक्रिप्शन कैंसिल की, फिर भी PRO है	Cancel-at-period-end: पेड पीरियड के अंत तक PRO	अपेक्षित। अगले बिलिंग साइकल के अंत में FREE में रिवर्ट होता है।

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

लक्षण	संभावित कारण	समाधान
प्रोजेक्ट xbot.ninja पर नहीं है	थ्रेशोल्ड पूरे नहीं होते (≥ 300 टॉप स्कोर, ≥ 5 पोस्ट्स, इस महीने ≥ 2 सक्रिय यूज़र्स)	डायरेक्ट URL अब भी काम करता है। मेट्रिक थ्रेशोल्ड तक पहुँचने का इंतज़ार करें। सोलो-KOL सेटअप्स जान-बूझकर शोकेस से छिपे रहते हैं।
प्रोजेक्ट xbot.ninja पर है पर लोगो गायब है	लोगो कभी अपलोड नहीं हुआ, या अपलोड फ़ेल हो गया	/setup → 🎨 Customization → 🖼 Logo। एक स्क्वेयर PNG भेजें।
पब्लिक URL पुराना प्रोजेक्ट नाम दिखाता है	अगले रिपोर्ट साइकल पर रीफ़्रेश होगा	/setup → 🎨 Customization → 🏷 Name से नाम बदलें। अगली रिपोर्ट फ़ायर होते ही URL स्लग + कार्ड रीफ़्रेश होते हैं।
URL 404 देता है	चैट हार्ड-डिलीट हो चुकी है, OR थ्रेशोल्ड अभी पूरे नहीं हुए इसलिए शोकेस छुपा रहा है	/setup → ℹ️ About से चैट ID कन्फ़र्म करें। डायरेक्ट URL https://xbot.ninja/?chatId=<id> टेस्ट करें।

Escalation

जब ऊपर के मैट्रिक्स से समस्या न सुलझे, तो नीचे दिए टेम्पलेट के साथ support से संपर्क करें।

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% ट्राएज जानकारी दे देती है — कृपया इसे हमेशा शामिल करें।

कहाँ भेजें:

• सामान्य सपोर्ट: bws.ninja कॉन्टैक्ट फ़ॉर्म
• GitHub इश्यूज़ (ओपन-सोर्स अवेयर): bws-api-telegram-xbot/issues
• डायरेक्ट Telegram: @BlockchainWebServices

सेवेरिटी के हिसाब से रिस्पॉन्स टाइम:

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

उपयोगी डायग्नोस्टिक्स कमांड्स

कमांड	क्या दिखाता है
/setup → ℹ️ About	चैट ID, प्लान, शेड्यूल, प्रोजेक्ट — इसे हूबहू support में कॉपी करें
/setup → 🎯 Filters	लिटरल X API क्वेरी स्ट्रिंग
/setup → 💳 Buy Credits → 📊 Usage this month	डेली + मंथली fetched_posts काउंटर्स — चुपचाप हो रही फ़ेल्योर्स ढूँढते हैं (ज़्यादा एटेम्प्ट्स, ज़ीरो पोस्ट्स → संभवतः 402s)
/setup → 📡 X Posts Auto-relay → @account	प्रति-रिले स्थिति (active / paused, आज के फ़ॉरवर्ड्स, डेली कैप)
/get_chatid	सिर्फ़ चैट ID (अगर About ज़्यादा है तो एक-लाइनर)

आगे कहाँ जाएँ

• Installation — अगर बाकी सब फ़ेल हो जाए तो एक साफ़ री-इंस्टॉल
• /setup मेन्यू — पूरा मेन्यू संदर्भ
• Pricing — बिलिंग-साइड ट्रबलशूटिंग
• Support — FAQ + कॉन्टैक्ट एस्केलेशन