Installation
I-set up ang X Bot sa iyong Telegram group sa tatlong hakbang. Natatapos ng karamihan sa mga team ang install sa loob ng tatlong minuto; ang wizard ang gumagawa ng mabigat na trabaho.
Pinakamabilis na paraan —
@BWS_X_Bot→ idagdag sa grupo →/setup→ 🚀 Quick Start. Ang apat na prompt na susunod ay lahat ng kailangan mo.
Tipunin Ang 5 Item na Ito Bago Ka Magsimula
Bago ka magsimula, ihanda ang mga sumusunod:
Para sa screen-by-screen tour ng bawat opsyon na iko-configure mo sa ibaba, tingnan ang The /setup menu.
| Kailangan mo | Saan galing |
|---|---|
| Isang Telegram account | telegram.org |
| Admin rights sa isang Telegram group | Gumawa ng bago kung wala ka pa: Telegram → New Group |
| Ang X handle(s), cashtag(s), o keyword(s) na gusto mong subaybayan | Hal. @your_username, $YOUR_TOKEN, "#YourCampaign" |
| (Opsyonal) Logo ng proyekto + listahan ng URL | Para sa pampublikong showcase sa xbot.ninja |
| (Opsyonal) Kagustuhan sa time zone | UTC ang schedule; pumili ng oras na UTC na tumatapat kapag pinaka-aktibo ang iyong komunidad |
Hindi sigurado kung anong plano ang kakailanganin mo? Tingnan ang Pricing — karamihan sa mga team ay nagsisimula sa FREE tier (100 posts/buwan) at nag-a-upgrade mamaya.
Kung hindi ka sigurado kung aling senaryo ang naaangkop sa iyo, i-skim ang 4 na use case sa Overview — piliin ang pinakamalapit at gamitin ang rekomendasyon nitong filter sa hakbang 2 sa ibaba.
Hakbang 1 — Idagdag ang bot sa iyong grupo
- Buksan ang Telegram at hanapin ang @BWS_X_Bot.
- Idagdag ang bot sa iyong grupo.
- I-promote ito sa admin. Walang espesyal na permission na kailangan bukod sa default admin (kailangan ng bot ng admin status para lamang payagan ito ng Telegram na basahin ang mga mensahe ng grupo at mag-post ng mga report).
Grupo, hindi DM
Ang mga analytics feature ng bot ay tumatakbo lang sa mga grupo, hindi sa private DMs. Kung magsisimula ka ng DM kasama ang @BWS_X_Bot, makikita mong gumagana ang /help at /buy pero hindi karamihan sa configuration menu.
Hakbang 2 — Patakbuhin ang /setup
Sa iyong grupo, i-type ang:
/setupSasagutin ka ng bot gamit ang isang interactive na menu. I-tap ang 🚀 Quick Start para buksan ang apat-na-hakbang na wizard.
Ang wizard ay nagtatanong ng apat na tanong ayon sa pagkakasunod-sunod:
| Hakbang | Prompt | Halimbawa |
|---|---|---|
| 1 | Pangalan ng proyekto | MyToken, KOL Campaign Q2, @your_username Performance |
| 2 | Ano ang susubaybayan sa X | 📢 Accounts + handles, 💵 Cashtags + tickers, o 🔍 Keywords + phrases |
| 3 | Kailan dapat tumakbo ang bot | Pumili ng daily preset (09:00 / 14:00 / 18:00 / 22:00 UTC) o magpadala ng custom na oras |
| 4 | Tapos na | Buod ng na-save |
Laging available ang Skip at Exit — hindi ka babarahin ng isang wizard na hindi natapos, mananatili lang ang mga setting sa kanilang default.
Bakit
/setup? Binabalot nito ang bawat admin command sa isang clickable, edit-in-place na interface para hindi mo na kailangang isaulo ang mga command. Instant na nase-save ang mga setting. Puwede pa ring mag-type ng direktang slash command ang mga power user — magkapareho ang dalawang surface at magkatulad ang behavior. Buong tour: The /setup menu.
Hakbang 3 — I-verify
Kapag natapos na ang wizard, buksan ang /setup → 📊 Reports → ⚡ Generate report now para magpadala ng agarang report (ang susunod na naka-schedule na report ay tatakbo sa oras na pinili mo sa hakbang 2).
Ipo-post ng bot ang leaderboard image sa grupo sa loob ng ~1–3 minuto. Mas mabilis matapos ang mas maliliit na chat (kaunting account, mababang post volume); ang mga community chat na may daan-daang post na kukunin ay maaaring umabot ng 2–3 minuto.
Hintayin ang unang naka-schedule na takbo
Pagkatapos ng manual na Generate report now, ang susunod na automated na takbo ay mangyayari sa iyong naka-configure na cron time. Isang report ka lang matatanggap kada fire — walang double-posting.
Gastos at credits
Gumagamit ang X Bot ng opisyal na X API para sa lahat ng pagkuha ng data. Nagsisimula ang bawat chat sa FREE; mula doon puwede kang mag-layer ng isa o pareho sa mga paid path:
| Plano | Ano ang babayaran mo | Ano ang sakop nito |
|---|---|---|
| FREE | $0 | 100 posts/buwan mula sa hard cap. Ihihinto ng bot ang fetch sa 100; nag-re-reset sa ika-1 ng susunod na buwan. |
| PRO subscription (Stripe) | $19/buwan + $0.02/post lampas sa 1 000/buwan (Stripe-metered) | Auto-renew. Kasama ang unang 1 000 posts/buwan bilang libreng threshold (hindi credit balance — walang roll-over). |
| PRO credits (ETH) | $0.02/credit, mga pack na 1 000 / 2 000 / 3 000 / 4 000 / 5 000 / 10 000 / 50 000 / 100 000 | Isang beses lang. Hindi nag-e-expire ang credits. Dinadagdag sa umiiral na balance. |
Puwedeng magkaroon ang isang chat ng parehong PRO·sub at PRO·credits sa parehong oras — ang per-fetch billing ay nauubos muna ang ETH credits, tapos ang monthly grant ng subscription, tapos ang metered overage. Tingnan ang pricing para sa buong plan-transition matrix at ang buying workflow.
Palaging makikita ang plano + balance sa /setup → 💳 Buy Credits. Nakakatanggap ang mga designated admin ng Telegram DM kapag umabot sa 80% ang credits at muli kapag naubos na nang tuluyan.
Inirerekomendang susunod na hakbang ayon sa use case
Piliin ang row na tumatapat sa iyong senaryo, pagkatapos sundan ang naka-link na seksyon sa Overview para sa buong recipe:
| Senaryo | Ano ang idadagdag pagkatapos ng wizard | Detalye |
|---|---|---|
| KOL agency na sumusubaybay sa 5 KOL | Cashtag + pagpino ng campaign hashtag, 22:00 UTC na schedule | Use case 1 |
| Proyektong nag-e-engage sa komunidad | Logo + URLs sa 🎨 Customization para sa pampublikong xbot.ninja card | Use case 2 |
| Solo KOL portfolio | Personal na headshot + LinkedIn URL sa Customization, i-share ang xbot.ninja URL sa mga prospect | Use case 3 |
| Multi-client agency | /setup → 🎯 Filters → ⤴ Named filters → ➕ Add named filter — isa kada client | Use case 4 |
| Pagtanggap ng X account posts nang real-time | /setup → 📡 X Posts Auto-relay → ➕ Add Account | The /setup menu |
Ano ang naiko-configure
| Seksyon sa /setup | Ano ang itinatakda mo | Bakit mahalaga |
|---|---|---|
| 🎯 Filters | Mga account, cashtag, keyword, mention na susubaybayan sa X | Tinutukoy kung aling mga post ang kukunin ng bot |
| ⏰ Schedule | Oras ng araw para sa automated na report | Ditto tumatakbo ang fetch + render ng bot base sa cron |
| 📊 Reports & Period | Opsyonal na date window (hal. panahon ng kompetisyon) | Nililimitahan ang report sa isang partikular na saklaw |
| 🎨 Customization | Pangalan ng proyekto, deskripsyon, logo, URLs, leaderboard weights at kulay | Branding para sa report image at ang pampublikong showcase sa xbot.ninja |
| 👥 Admins | Sino ang tumatanggap ng private DM tungkol sa isyu sa credit / fetch | Operational visibility |
| 💳 Subscription | Plano, balance ng credits, entry point ng upgrade | Cost visibility at pagbabayad |
| 📡 Auto-relay | Mga X account na ipapasa sa chat nang real-time (kada 5 minuto) | Live update sa pagitan ng mga naka-schedule na report |
Pampublikong showcase (opsyonal)
Kung natutugunan ng proyekto mo ang mga threshold sa public listing (≥ 300 top score, ≥ 5 posts, ≥ 2 aktibong user sa kasalukuyang buwan), lalabas ito sa xbot.ninja. Idagdag ang metadata ng proyekto sa ilalim ng /setup → 🎨 Customization (Name, Description, Logo, URLs).
Ang mga solo-KOL na setup (iisang account) ay hindi pumapasa sa panuntunang "≥ 2 aktibong user" at nananatiling accessible lang sa kanilang direktang URL — sinadya ito.
Pag-verify ng install
Karamihan sa mga diagnostic ay makikita direkta sa /setup (ipinapakita ng bawat screen ang kasalukuyang estado ng chat sa itaas). Mabilisang sanity checklist:
| Check | Paano |
|---|---|
| Admin ang bot | Telegram → group settings → Administrators |
| Naka-configure ang tracking | /setup → 🎯 Filters → tingnan ang nakalistang accounts/cashtags/keywords |
| Tama ang pag-render ng filter | /setup → 🎯 Filters |
| Naka-set ang schedule | /setup (ipinapakita sa itaas ng menu ang kasalukuyang schedule) |
| May available na credits | /setup → 💳 Buy Credits |
| Gumagana ang manual na report | /setup → 📊 Reports → ⚡ Generate report now |
Hindi lumabas ang unang report — troubleshooting
Kung ang Generate report now ay hindi naglalabas ng post sa loob ng 3 minuto:
| Sintomas | Malamang na dahilan | Ayos |
|---|---|---|
| Sabi ng DM ng bot "no posts found" | Masyadong makitid ang filter O walang kamakailang post na tumutugma | /setup → 🎯 Filters — tingnan ang literal na X API query para sa typo. Subukang palawakin (alisin ang date period kung naka-set). |
| Sabi ng DM ng bot "credit exhausted" | Naabot ng FREE chat ang 100/buwan na cap | Hintayin ang susunod na buwan, o /setup → 💳 Buy Credits → 💰 Buy para mag-subscribe / bumili ng credit pack |
| Walang nangyayari, walang DM | Hindi admin ang bot, O tumigil ang webhook | I-promote ulit ang bot bilang admin. Kung wala pa ring nangyayari, makipag-ugnayan sa support. |
| Nag-render ang image pero walang text | Nag-timeout ang AI commentary | Patakbuhin ulit; pansamantala lang ito. Kung patuloy, makipag-ugnayan sa support — kung minsan ay may paikot na outage ang AI provider |
| Error na "Unauthorized" / "Forbidden" | Isyu sa X API token (sa panig ng operator) | Makipag-ugnayan sa support; wala nang maaayos ang user |
Self-service diagnostics
Ipinapakita ng /setup → ℹ️ About ang chat ID, plano, at schedule mo sa isang screen. I-copy ang text na iyon papunta sa anumang support request — nagpapaikli ito ng triage nang halos 80%.
FAQ — mga karaniwang tanong sa install
T. Puwede ko bang i-install ang bot sa isang Telegram channel (hindi grupo)? Hindi, mga grupo at supergroup lang. Hindi pumapayag ang mga channel ng message-reply context, na ginagamit ng report flow.
T. Puwede ko bang patakbuhin ang bot sa isang forum-style na grupo na may topics? Oo. Gamitin ang /set_topic mula sa loob ng topic kung saan mo gustong i-post ang mga report. Mula roon, doon na mag-post ang bot; kung hindi naka-set, sa main thread ito mag-po-post.
T. Kailangan ba ng bot ng read access sa mga mensahe ng aking grupo? Kailangan lang ng bot na tumanggap ng mga command message (hal. /setup). Hindi nito binabasa ang normal na chat. Ang data sa panig ng X ay galing sa opisyal na X API, hindi mula sa iyong mga mensahe sa Telegram.
T. Puwede ko bang subaybayan ang isang private/protected na X account? Hindi — nagbabalik lang ang X API ng mga pampublikong post. Ang pagsubaybay sa isang protected account ay tahimik na walang ibabalik na resulta.
T. Kapag inalis ko ang bot sa grupo, mabubura ba ang aking data? Hindi. Nananatili sa database ng bot ang mga setting, history, score, at report. Kung idagdag mo ulit ang bot sa parehong chat ID, magpapatuloy ang lahat. Kung gusto mo ng malinis na teardown, tanungin ang support.
T. Puwede ko bang palitan ang pangalan ng proyekto mamaya? Oo — /setup → 🎨 Customization → 🏷 Name. Ina-update nito ang susunod na report at ang public xbot.ninja URL slug.
T. Bakit iba ang nakikita kong bilang ng post kumpara sa [tool X]? 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. Nakahanap kami ng pagkakaiba na 20–50% sa totoong buhay. Ang numero ng X API ang source of truth.
T. Paano ako mag-cancel?
- FREE na chat: alisin lang ang bot sa grupo.
- PRO subscription:
/setup→ 💳 Buy Credits → 🛠 Manage subscription ay magbubukas ng Stripe Customer Portal kung saan puwede kang mag-cancel. Magkakabisa ang cancellation sa katapusan ng kasalukuyang bayad na panahon. - PRO credits (ETH): hindi auto-renew ang credits — ang chat ay awtomatikong bumababa sa FREE kapag naubos na ang balance. Alisin ang bot anumang oras.
Kailangan ng tulong?
Tingnan ang Support, o buksan ang /setup → ℹ️ About sa iyong chat para sa diagnostic info na maishe-share sa team.
Basahin ang X Bot overview para sa buong breakdown kung ano ang nakukuha ng bawat audience — crypto projects, KOL agencies, solo KOLs, investors — mula sa bot bago ka magsimula sa setup.