I-troubleshoot ang X Bot: Reports, Filters, Schedules, Billing
Isang pinagsama-samang index ng bawat "may mali, ano na" na landas. Ang mga matrix sa installation / setup-menu / support ay nandito rin kaya iisang pahina na lang ang hahanapin mo sa halip na tatlo.
Magsimula rito: buksan ang
/setup→ ℹ️ About sa iyong grupo. Ang apat na linya sa screen na iyon (chat ID, plano, schedule, pangalan ng proyekto) ang kailangan ng support para sa triage. I-copy ang mga ito bago ka gumawa ng iba pa.
Self-diagnosis flow
Dumaan sa mga tanong na ito ayon sa pagkakasunod-sunod. Karamihan sa mga isyu ay naaayos na sa una at ikalawang check.
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"Kung wala sa mga matrix sa ibaba ang nagdala sa iyo sa isang ayos, mag-scroll pababa sa Escalation.
Hindi dumarating ang mga report
| Sintomas | Malamang na dahilan | Ayos |
|---|---|---|
| Aktibo dati ang bot, biglang tumahimik | Na-demote o na-kick ang bot mula sa admin nang tahimik | Telegram → group admins → i-promote ulit. Kung tahimik pa rin, makipag-ugnayan sa support — baka na-trigger ang auto-disable sa chat-gone. |
| Walang nalikhang resulta ang manual na generate-now | Admin ang bot pero zero na ang credits | /setup → 💳 Buy Credits. Kung FREE at "100/100 used" — hintayin ang buwanang reset (ika-1 ng buwan UTC). Kung PRO·credits na may REMAINING=0 — nag-auto-downgrade na ang chat sa FREE; /setup → 💳 → 💰 Buy para mag-top up. |
| Manual generate-now: DM na "no posts found" sa admin | Masyadong makitid ang filter O walang post sa window | /setup → 🎯 Filters. Tingnan ang literal na X API query para sa typo. Subukang palawakin o alisin ang period. |
| Nag-render ang image pero walang text | Nag-timeout ang AI commentary | Patakbuhin ulit; pansamantala lang. Kung patuloy, makipag-ugnayan sa support. |
| Hindi na-render ang image nang tuluyan | Pansamantalang render hiccup | Patakbuhin ulit. Kung paulit-ulit na nabibigo para sa isang chat, makipag-ugnayan sa support kasama ang chat ID. |
| Error na "Unauthorized" / "Forbidden" sa admin DM | Isyu sa X API token (sa panig ng operator) | Makipag-ugnayan sa support; wala nang maaayos ang user. |
Filter / walang posts
| Sintomas | Malamang na dahilan | Ayos |
|---|---|---|
| "0 posts" ang report sa lahat ng dako | Walang tumugma ang filter sa naka-configure na panahon | Hakbang 1: /setup → 🎯 Filters — kumpirmahin ang query. Hakbang 2: /setup → 📊 Reports → 🗑 Clear period (mas mapagbigay ang rolling 24h). Hakbang 3: palawakin ang mga filter (magdagdag ng cashtag fallback, alisin ang mahihigpit na keyword group). |
| May mga user sa leaderboard na hindi ko idinagdag sa filter | Additive ang mga filter — sinuman na nag-tweet ng sinusubaybayang cashtag/keyword ay binibilang | Para hingin ang parehong account at cashtag, gamitin ang /set_x_filtering name from:@x cashtags:$Y (named filter, AND-of-categories). |
| Iisang user ang nag-spam sa leaderboard | Lehitimong na-score ng bot ang bawat post | /setup → 🎯 Filters → 🙈 Ignore → ➕ Add @spammer — aalisin sila sa mga resulta pagkatapos ng fetch. |
| Cashtag na may kakaibang karakter ay hindi tumutugma | Nino-normalize ng X API ang case; mahalaga ang trailing/leading space sa filter input | Idagdag ulit sa pamamagitan ng /setup → 🎯 Filters → 💵 Cashtags → ➕ Add — walang kailangang $, walang space. |
Hindi sinusubaybayan ang cashtag na may numerong prefix (hal. $1INCH) | Maaaring hindi consistent ang search behavior ng X API sa mga leading number | Gamitin bilang keyword sa halip na cashtag: "$1INCH" sa 🔍 Keywords na may quotes. |
| Parang mali ang pinili sa "Best Tweet" | Kamakailan ay pumili ang AI deduplication ng katulad na tweet | Hintayin ang isang cycle. Kung patuloy na parang mali, i-report ito; naaayos ang prompt. |
Hindi tumatakbo ang schedule
| Sintomas | Malamang na dahilan | Ayos |
|---|---|---|
Schedule na "rejected" na may FREQUENCY_ERROR | Sinusubukan ng cron na mag-fire nang mas madalas kaysa kada 12h | Ipinapatupad ng spacing check ang ≥ 12h na agwat. Pinapangalanan ng error message ang nagkasalang pares ng oras. Pumili ng mas malawak na agwat. |
| Naka-set ang schedule, pero hindi dumating sa oras ang report | Nagpapaputok ang scheduled cron sa loob ng ~1–2 minuto ng tick | Maghintay ng 5 minuto pagkatapos ng naka-configure na oras bago ipagpalagay na nagkulang. Bihirang nangyayari ang upstream delay pero naaayos ang mga ito nang mag-isa. |
| Isang beses lang nag-fire ang multi-fire cron | Hindi ayos o may duplicate sa listahan ng oras | cron(0 14,22 ? * * *) — pataas na pagkakasunod-sunod. Tatanggihan ang cron(0 22,14 ? * * *). |
| Kada 5 minuto nag-fire ang schedule sa staging, hindi sa prod | Ibang RULE_NAME namespace | Kumpirmahin na tama ang environment na tinitingnan mo. Ipinapakita ng /setup → ℹ️ About ang env. |
| Mukhang mali ang time zone | UTC ang schedule sa disenyo | I-convert ang iyong lokal na oras sa UTC. Tumatanggap din ang set-schedule input ng mga named timezone sa ilang edge case — tingnan ang docstring ng entry. |
| Nag-fire ang X Posts Auto-relay pero hindi ang mga report | Ibang cron schedule | Gumagamit ang X Posts Auto-relay ng 5-minutong poll kada relay; gumagamit ang mga report ng pangunahing schedule cron ng chat (karaniwan ay daily). Independiyente sila sa isa't isa. |
Kalidad ng render
| Sintomas | Malamang na dahilan | Ayos |
|---|---|---|
| Nabalik ang custom title / kulay kinabukasan | Na-invalidate ang cache, ipapakita ng susunod na fetch ang bagong value | Hintayin ang isang report cycle (~1 araw). Nire-rebuild ang render cache sa susunod na fetch. |
| Malabo / naputol ang logo | Masyadong maliit o hindi square ang source image | Mag-upload ulit sa ≥ 512×512 PNG, square aspect. /setup → 🎨 Customization → 🖼 Logo. |
| Umaapaw ang username sa leaderboard image | Mahabang display name | Pinuputol ito ng bot gamit ang ellipsis; walang kailangang ayusin maliban kung patuloy. |
Nagpapakita ng raw <a href> HTML ang best-tweet text | Hindi tugma ang parse mode ng Telegram | Bug — mangyaring i-report kasama ang tweet URL. |
| Iba ang report image kumpara sa Telegram preview | Cine-cache ng Telegram ang unang image bytes ayon sa URL; may timestamp ang presigned URLs kaya natatangi ang bawat fetch | Hindi dapat mangyari; kung mangyari, i-rotate sa pamamagitan ng /recreate. |
X Posts Auto-relay
| Sintomas | Malamang na dahilan | Ayos |
|---|---|---|
| Nagfo-forward ang relay ng 6-tweet na thread nang sabay-sabay | Naiiwasan ng self-replies ang exclude=replies ng X API | /setup → 📡 X Posts Auto-relay → @account → i-toggle na off ang ☐ Thread continuations. Pananatilihin na lang ng bot ang ulo. |
| Tumigil ang relay kalagitnaan ng araw | Naabot ang daily cap | Ipinapakita ng per-relay screen ang Today: N/N forwarded. I-tap ang ✏️ Cap at itaas. Nagre-reset sa hatinggabi UTC. |
| Nagpapakita ng ⏸ Paused ang relay pero hindi ko ito ni-pause | Auto-paused sa Telegram chat-gone (na-kick / na-block / na-upgrade ang chat) | Ihinto rin ng bot ang polling schedule. Para ibalik: /setup → 📡 X Posts Auto-relay → @account → ▶️ Resume. Kung nabibigo pa rin, baka nagbago ang ID ng chat mismo (super-group upgrade) — idagdag ulit ang bot sa bagong chat. |
| Nagforward ng 50 posts ang unang poll ng relay | Hindi dapat ganito ang bootstrap — dapat i-seed lang ang LAST_POST_ID nang walang forward | Kung nakita mo ito, mangyaring i-report. Dapat maiwasan ito ng fix na idinagdag noong 2026-04. |
| Patuloy pa ring lumilitaw ang mga quote tweet kahit naka-toggle | Walang server-side na exclude=quotes ang X API — client-side ang pag-filter ng bot pagkatapos ng fetch | Gumagana ang toggle, pero babayaran mo pa rin ang mga quote tweet na ibinalik ng API. Cosmetic-only ang pagtitipid. |
| Walang katapusang polling ng relay kahit na-delete ang chat | Lumang bersyon ng relay — idinagdag ang auto-cleanup noong 2026-05 | Hilingin sa support na pilitin ang paghinto ng relay. Sarili nang naglilinis ang mga bagong deployment. |
Billing & credits
| Sintomas | Malamang na dahilan | Ayos |
|---|---|---|
| Bumili ng credits, hindi nagbago ang balance | Naantala ang Stripe webhook | Maghintay ng 5 minuto. Kung mali pa rin, makipag-ugnayan sa support kasama ang Stripe receipt + chat ID. |
| Mas mataas ang credit count kaysa sa inaasahan ko | May relay na nag-poll nang maraming beses habang aktibo ang sinusubaybayang account | Sinisingil ng X Posts Auto-relay kada post. I-tap ang relay → tingnan ang Today counter. |
| May overage charge sa PRO·sub kahit kaunti lang ang na-post ko | May ibang usage sa chat (relays, reports, fetch retries) | /setup → 💳 Buy Credits → Usage this month. Ikumpara sa metered na charge. |
| Nasingil ang FREE na chat | Hindi dapat mangyari — walang Stripe customer ang FREE | I-report agad; billing bug ito. |
| Nagpapakita ng "canceled" ang subscription pero hindi ko ito kinansela | Puwedeng na-trigger ng nabigong auto-renew ng card ang Stripe cancellation | Tingnan ang email para sa Stripe receipts, i-update ang card sa pamamagitan ng /setup → 💳 → 🛠 Manage subscription (Stripe Customer Portal). |
| Kinansela ang subscription, PRO pa rin | Cancel-at-period-end: PRO hanggang katapusan ng bayad na panahon | Inaasahan. Babalik sa FREE sa katapusan ng susunod na billing cycle. |
Pampublikong dashboard
| Sintomas | Malamang na dahilan | Ayos |
|---|---|---|
| Wala sa xbot.ninja ang proyekto | Hindi natutugunan ang mga threshold (≥ 300 top score, ≥ 5 posts, ≥ 2 aktibong user ngayong buwan) | Gumagana pa rin ang direktang URL. Hintayin na maabot ng metric ang threshold. Sinasadyang itinatago ang mga solo-KOL na setup mula sa showcase. |
| Nasa xbot.ninja ang proyekto pero kulang ang logo | Hindi na-upload ang logo, o nabigo ang upload | /setup → 🎨 Customization → 🖼 Logo. Magpadala ng square PNG. |
| Ipinapakita ng public URL ang lumang pangalan ng proyekto | Mag-refresh sa susunod na report cycle | Palitan ang pangalan sa pamamagitan ng /setup → 🎨 Customization → 🏷 Name. Mag-re-refresh ang URL slug + card kapag nag-fire na ang susunod na report. |
| 404 ang ibinibigay ng URL | Hard-deleted na ang chat, O hindi pa natutugunan ang mga threshold kaya itinatago ito ng showcase | Kumpirmahin ang chat ID sa pamamagitan ng /setup → ℹ️ About. Subukan ang direktang URL na https://xbot.ninja/?chatId=<id>. |
Escalation
Kapag hindi naayos ng mga matrix sa itaas, makipag-ugnayan sa support gamit ang template sa ibaba.
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>Ang chat ID lang ay nagbibigay sa support ng 80% ng impormasyon para sa triage — pakisama lagi ito.
Saan magpapadala:
- Pangkalahatang support: bws.ninja contact form
- GitHub issues (open-source aware): bws-api-telegram-xbot/issues
- Direktang Telegram: @BlockchainWebServices
Mga oras ng pagtugon ayon sa severity:
- Kritikal (offline ang buong platform ng bot, mga kabiguan sa billing): 1 oras ng negosyo sa panahon ng EU+US business overlap
- Mataas (hindi nagde-deliver ang report ng isang chat): sa parehong araw ng negosyo
- Normal (mga tanong sa feature, tulong sa configuration): 1–2 araw ng negosyo
Kapaki-pakinabang na diagnostic command
| Command | Ano ang ipinapakita nito |
|---|---|
/setup → ℹ️ About | Chat ID, plano, schedule, proyekto — i-copy ito nang verbatim papunta sa support |
/setup → 🎯 Filters | Literal na X API query string |
/setup → 💳 Buy Credits → 📊 Usage this month | Daily + monthly na fetched_posts counters — nakakatukoy ng mga tahimik na kabiguan (mataas na attempts, zero posts → malamang 402s) |
/setup → 📡 X Posts Auto-relay → @account | Estado ng bawat relay (aktibo / naka-pause, mga forward ngayong araw, daily cap) |
/get_chatid | Ang chat ID lang (isang linya kung sobra na ang About) |
Saan susunod
- Installation — malinis na muling pag-install kung nabigo ang lahat
- The /setup menu — buong sanggunian ng menu
- Pricing — troubleshooting sa panig ng billing
- Support — FAQ + contact escalation