Support ng X Bot: Troubleshooting, FAQ, at Gabay sa Pakikipag-ugnayan

Karamihan sa mga isyu ay naaayos ng iisang aksyon sa /setup. Ang unang kalahati ng pahinang ito ay dadaanin ka sa self-diagnosis flow; ang ikalawang kalahati ay FAQ. Kung wala sa dalawa ang nakaayos, ang contact form sa ilalim ay dumederetso sa support channel ng BWS developer.

Una — self-diagnosis flow

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.

Kung wala sa mga iyon ang nagdala sa iyo sa isang ayos, mag-scroll lagpas sa FAQ patungo sa contact link.

FAQ

Setup at pag-install

T. Hindi sumasagot ang bot kapag idinagdag ko ito. Kumpirmahin na naka-promote ito bilang admin, hindi lang "member". Telegram → group settings → Administrators. Instant ang re-promotion; hindi na kailangang i-reinstall ang bot.

T. Puwede ko bang ilipat ang bot sa ibang grupo? Oo — idagdag ito sa bagong grupo, patakbuhin ang /setup doon. Independiyente ang dalawang chat (magkaibang chat ID = magkaibang settings, schedules, scores). Walang data migration sa pagitan ng mga chat.

T. Nagre-report ang bot sa main thread, pero may topics ang grupo ko — puwede ko bang i-redirect? Mula sa loob ng gustong forum topic, ipadala:

/set_topic Reports

Ruruta ang mga susunod na report sa topic na iyon. I-reset gamit ang /set_topic clear.

T. Paano mag-uninstall?

• Ihinto muna ang mga report: /setup → ⏰ Schedule → ✕ Disable schedule.
• Alisin ang bot: Telegram → group → admins → kick ang @BWS_X_Bot.
• Mananatili ang mga setting sa database. Ang muling pagdagdag ng bot sa parehong chat ID ay nagpapatuloy sa lahat. Hilingin sa support ang hard delete.

Mga report at filtering

T. Bakit iba ang aking mga numero kumpara sa mga third-party tracker? Direktang kumukuha ang X Bot mula sa opisyal na X API. Karamihan sa mga third-party tracker ay nag-s-scrape o nag-e-extrapolate — nasukat namin ang pagkakaiba na 20–50%. Ang numero ng X API ang source of truth.

T. May mga user sa leaderboard na hindi ko inaasahang masubaybayan. Additive ang mga filter. Kung sinusubaybayan ng isang chat ang $YOUR_TOKEN na cashtag, sinuman na nag-tweet ng cashtag na iyon ay ma-ra-rank, hindi lang ang mga account na inilista mo. Para hingin ang parehong account at cashtag, gamitin ang from:@x cashtags:$YOUR_TOKEN na form sa pamamagitan ng /set_x_filtering (ang AND-of-everything na semantics ng named filters).

T. Sabi ng report "0 posts" — ano na ngayon? Tatlong posibilidad, ayon sa pagkakaposible:

1. Masyadong makitid ang filter — ipinapakita ng /setup → 🎯 Filters ang literal na X API query. Karaniwang typo: $BTC (may trailing space) kumpara sa $BTC.
2. Masyadong makitid ang period — kung nagtakda ka ng custom na period, hindi binibilang ang mga post sa labas ng window na iyon. Ibinabalik ng /setup → 📊 Reports → 🗑 Clear period sa rolling 24 h.
3. Talagang walang on-topic na na-post ang mga account na sinusubaybayan mo sa loob ng 24 h — palawakin gamit ang cashtags o keywords para sa fallback signal.

T. Puwede ko bang subaybayan ang isang private/protected na X account? Hindi — nagbabalik lang ang X API ng mga pampublikong post.

T. Puwede ko bang alisin ang partikular na user mula sa leaderboard ng isang chat (hal. spam bots)? Oo: /setup → 🎯 Filters → 🙈 Ignore → ➕ Add. Aalisin sa mga resulta ang mga nakalistang handle pagkatapos ng fetch.

T. Bakit maraming report fire ang chat ko sa isang araw? Alinman sa nagtakda ka ng multi-fire cron (cron(0 14,22 ? * * *)) o may maraming named filter kang tumatakbo sa parehong schedule. Bawat named filter ay gumagawa ng sarili nitong report.

T. Parang kakaiba ang napiling "Best Tweet". Pinipili ng AI selector ang post na may pinakamataas na engagement na hindi kamakailan napili. Kung patuloy na parang mali ang resulta, makipag-ugnayan sa support — naaayos ang prompt.

X Posts Auto-relay

T. Nagforward ang relay ng 6 na post na thread nang sabay-sabay. Gusto ko lang sana ng una. Iyon ay dahil ang exclude=replies ng X API ay nagfi-filter lang ng mga reply sa ibang user; naiiwasan ito ng self-replies (thread continuations). /setup → 📡 X Posts Auto-relay → @account → i-toggle na off ang ☐ Thread continuations. Pananatilihin na lang ng bot ang ulo ng bawat thread.

T. Tumigil ang relay sa pag-forward kalagitnaan ng araw. Tingnan ang per-relay screen — kung Today: 10/10 forwarded, naabot mo na ang daily cap. I-tap ang ✏️ Cap para itaas. Awtomatikong nagre-reset ang cap sa hatinggabi UTC.

T. Nagpapakita ng ⏸ Paused ang relay pero hindi ko ito ni-pause. Awtomatikong nag-a-pause ang bot sa mga error na Telegram chat-gone (na-kick / na-block / na-upgrade ang chat) at ihinto ang polling schedule. Ipinapakita ito ng /setup → 📡 X Posts Auto-relay sa row nito kung sakaling idagdag mo ulit ang bot.

Billing at credits

T. Ano ba talaga ang isang "credit"? Isang credit = isang post na ibinalik ng X API. Nakakakuha ang mga FREE na chat ng 100 libreng credits/buwan; ang mga PRO na chat ay sinisingil sa pamamagitan ng Stripe (subscription) o ETH (credit pack).

T. Saan ko makikita ang balance ng aking credits?/setup → 💳 Buy Credits. Ipinapakita ang ginamit / natitira / petsa ng reset.

T. Nagbayad na ako pero hindi na-update ang balance / plano ko.

• Landas ng Stripe (card subscription): karaniwang ina-activate ng webhook ang PRO sa loob ng segundo. Kung 5+ minuto pa rin at wala kang makita na PRO ✓ sa /setup → 💳 Buy Credits, makipag-ugnayan sa support kasama ang iyong Stripe receipt at chat ID.
• Landas ng ETH (credit pack): puwedeng tumagal ng 1–3 minuto ang on-chain confirmation. Kung pagkatapos ng 10 minuto ay hindi pa rin lumalabas ang credits, makipag-ugnayan sa support kasama ang transaction hash at chat ID.

T. Puwede ko bang magkaroon ng parehong Stripe subscription AT ETH credits sa parehong chat? Oo — umaandar sila nang magkasama. Ang isang PRO·credits na chat na mag-subscribe ay pinapanatili ang umiiral nitong ETH balance, at ang per-fetch billing ay nauubos muna ang ETH credits bago pumasok ang monthly grant ng subscription. Praktikal na epekto: kung mayroon kang 5 000 ETH credits at nag-subscribe ka, hindi hinahawakan ng unang 5 000 fetch ang Stripe; gumagamit ang mga susunod na fetch ng 1 000/buwan na grant ng sub; ang anumang lampas doon ay $0.02/post na metered overage. Hindi kailanman nag-e-expire ang ETH balance.

Ang isang limitasyon: ang isang chat na nasa PRO·sub na ay hindi puwedeng magdagdag ng bagong ETH pack mula sa parehong buy flow ngayon (hinaharangan ito ng buy command). Kanselahin muna ang subscription kung gusto mong bumalik sa credits-only.

T. Ano ang mangyayari kapag naubos ang balance ng aking PRO·credits? Awtomatikong bumababa ang license sa FREE. Patuloy na kukuha ang bot sa ilalim ng 100/buwan na FREE cap hanggang maubos din iyon. Iaalok na ngayon ng susunod na /setup → 💳 → 💰 Buy ang parehong landas.

T. Per-chat ba o per-user ang credits balance? Per-chat. May sariling credits at license ang bawat Telegram group.

Pampublikong dashboard

T. Hindi lumalabas ang proyekto ko sa xbot.ninja. Kailangang matugunan ang tatlong threshold sa kasalukuyang buwan:

• Top user score ≥ 300
• Tracked posts ≥ 5
• Active users ≥ 2

Karaniwang ang unang buwan ang bottleneck. Gumagana pa rin ang direktang URL na https://xbot.ninja/?chatId=<your-id>.

T. Paano ko mahahanap ang aking chat ID?/setup → ℹ️ About. Ang mahabang integer na may negative prefix.

T. Puwede ko bang i-customize ang pampublikong card sa xbot.ninja?/setup → 🎨 Customization. Itakda ang Name, Description, Logo, URLs. Nagre-refresh ang card sa susunod na report cycle.

Mga kakaibang bagay sa X API

T. Bakit binibilang ang ilang post na mas matanda kaysa inaasahan? Gumagamit ang bot ng tweets/search/all (full-archive endpoint). Kapag nagtakda ka ng period, puwedeng kumuha ang bot ng mga post mula sa anumang oras sa loob nito. Rolling 24 h ang default, pero puwedeng naka-backdate ang isang custom na period.

T. Minsan umaabot ng 5+ minuto bago lumitaw ang isang post sa relay. Nag-po-poll ang X Posts Auto-relay kada 5 minuto. Ang latency ay hanggang isang polling interval (~2.5 minuto average / ~5 minuto pinakamatagal). Kasama pa ang maikling latency ng X API + Telegram delivery.

T. Nagbalik ng error ang X API — ano ang nakikita ng operator? Tumataas ang internal error counters; nakakatanggap ang mga tinalagang admin ng private DM (/setup → 👥 Admins para i-configure kung sino). Karaniwang 4xx codes: 401/403 (credentials sa panig ng operator), 402 (naubos ang credits), 429 (rate-limited — nag-re-retry ang bot na may backoff).

Ano ang isasama sa isang support request

I-copy at i-paste ang template na ito:

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.

Inaasahang oras ng pagtugon

• Kritikal: offline ang buong platform ng bot, mga kabiguan sa billing → pagtugon sa loob ng 1 oras ng negosyo sa panahon ng EU+US business overlap
• Mataas: hindi nagde-deliver ang report para sa isang chat → sa parehong araw ng negosyo
• Normal: mga tanong sa feature, tulong sa configuration → 1–2 araw ng negosyo

Kapaki-pakinabang na mga link

• Telegram bot: @BWS_X_Bot
• Pampublikong dashboard: xbot.ninja
• Dokumentasyon: /docs/
• GitHub issues: blockchain-web-services/bws-api-telegram-xbot
• Direktang support: bws.ninja — dumederetso ang contact form sa BWS developer support

Bago makipag-ugnayan sa support, dumaan muna sa Troubleshooting na self-diagnosis flow — karamihan sa mga isyu ay naaayos na sa unang dalawang check.