Instalasi

Siapkan X Bot di grup Telegram Anda dalam tiga langkah. Kebanyakan tim menyelesaikan instalasi dalam waktu kurang dari tiga menit; wizard yang melakukan pekerjaan berat.

Jalur tercepat — @BWS_X_Bot → tambahkan ke grup → /setup → 🚀 Quick Start. Empat prompt berikutnya adalah semua yang Anda butuhkan.

Siapkan 5 Hal Ini Sebelum Memulai

Sebelum memulai, siapkan hal-hal berikut:

Untuk tur layar demi layar setiap opsi yang akan Anda konfigurasi di bawah, lihat Menu /setup.

Yang Anda butuhkan	Dari mana asalnya
Akun Telegram	telegram.org
Hak admin di grup Telegram	Buat satu jika belum punya: Telegram → New Group
Handle X, cashtag, atau kata kunci yang ingin dilacak	Mis. @your_username, $YOUR_TOKEN, "#YourCampaign"
(Opsional) Logo proyek + daftar URL	Untuk showcase publik xbot.ninja
(Opsional) Preferensi zona waktu	Jadwal dalam UTC; pilih jam UTC yang sesuai saat komunitas Anda paling aktif

Belum yakin paket mana yang Anda butuhkan? Cek Harga — kebanyakan tim mulai dari tingkat FREE (100 post/bulan) dan upgrade nanti.

Jika belum yakin skenario mana yang berlaku untuk Anda, lihat sekilas 4 kasus penggunaan di Ikhtisar — pilih yang paling mendekati dan gunakan rekomendasi filternya di langkah 2 di bawah.

Langkah 1 — Tambahkan bot ke grup Anda

1. Buka Telegram dan cari @BWS_X_Bot.
2. Tambahkan bot ke grup Anda.
3. Jadikan admin. Tidak ada izin khusus yang diperlukan di luar admin default (bot memerlukan status admin semata-mata agar Telegram mengizinkannya membaca pesan grup dan memposting laporan).

Grup, bukan DM

Fitur analitik bot hanya berjalan di grup, bukan di DM privat. Jika Anda memulai DM dengan @BWS_X_Bot, Anda akan melihat /help dan /buy berfungsi tetapi sebagian besar menu konfigurasi tidak akan berjalan.

Langkah 2 — Jalankan /setup

Di grup Anda, ketik:

/setup

Bot membalas dengan menu interaktif. Ketuk 🚀 Quick Start untuk membuka wizard empat langkah.

Wizard mengajukan empat pertanyaan berurutan:

Langkah	Prompt	Contoh
1	Nama proyek	MyToken, KOL Campaign Q2, @your_username Performance
2	Apa yang dilacak di X	📢 Accounts + handle, 💵 Cashtags + ticker, atau 🔍 Keywords + frasa
3	Kapan bot harus berjalan	Pilih preset harian (09:00 / 14:00 / 18:00 / 22:00 UTC) atau kirim waktu khusus
4	Selesai	Rekap apa yang telah disimpan

Skip dan Exit selalu tersedia — wizard yang belum selesai tidak pernah menghalangi Anda, pengaturan hanya tetap pada nilai default.

Kenapa /setup? Ia membungkus setiap perintah admin ke dalam antarmuka yang bisa diklik dan diedit langsung sehingga Anda tidak perlu menghafal perintah. Pengaturan tersimpan seketika. Power user tetap bisa mengetik perintah slash langsung — kedua antarmuka setara dan perilakunya identik. Tur lengkap: Menu /setup.

Langkah 3 — Verifikasi

Setelah wizard selesai, buka /setup → 📊 Reports → ⚡ Generate report now untuk mengirim laporan segera (laporan terjadwal berikutnya akan berjalan pada waktu yang Anda pilih di langkah 2).

Bot memposting gambar leaderboard ke grup dalam ~1–3 menit. Chat yang lebih kecil (sedikit akun, volume post rendah) selesai lebih cepat; chat komunitas dengan ratusan post yang harus diambil bisa memakan waktu 2–3 menit.

Tunggu run terjadwal pertama

Setelah Generate report now manual, run otomatis berikutnya terjadi pada waktu cron yang Anda konfigurasi. Anda akan mendapat satu laporan per pemicu — tidak ada posting ganda.

Biaya & kredit

X Bot menggunakan X API resmi untuk semua pengambilan data. Setiap chat mulai dari FREE; dari sana Anda bisa menambahkan salah satu atau kedua jalur berbayar:

Paket	Yang Anda bayar	Yang dicakup
FREE	$0	100 post/bulan dari batas keras. Bot menghentikan fetch di 100; direset tanggal 1 bulan berikutnya.
Langganan PRO (Stripe)	$19/bulan + $0.02/post di atas 1.000/bulan (diukur oleh Stripe)	Diperpanjang otomatis. 1.000 post pertama/bulan termasuk sebagai ambang batas gratis (bukan saldo kredit — tidak ada roll-over).
Kredit PRO (ETH)	$0.02/kredit, paket 1.000 / 2.000 / 3.000 / 4.000 / 5.000 / 10.000 / 50.000 / 100.000	Sekali beli. Kredit tidak pernah kedaluwarsa. Menambah saldo yang sudah ada.

Sebuah chat bisa memiliki PRO·langganan dan PRO·kredit secara bersamaan — penagihan per-fetch menguras kredit ETH lebih dulu, lalu jatah bulanan langganan, baru kelebihan pemakaian yang diukur. Lihat harga untuk matriks transisi paket lengkap dan alur pembelian.

Paket + saldo selalu terlihat di /setup → 💳 Buy Credits. Admin yang ditunjuk menerima DM Telegram saat kredit mencapai 80% dan lagi saat habis sepenuhnya.

Langkah selanjutnya yang direkomendasikan berdasarkan kasus penggunaan

Pilih baris yang sesuai skenario Anda, lalu ikuti bagian Ikhtisar yang ditautkan untuk resep lengkapnya:

Skenario	Yang ditambahkan setelah wizard	Detail
Agensi KOL melacak 5 KOL	Penyempurnaan cashtag + hashtag kampanye, jadwal 22:00 UTC	Kasus penggunaan 1
Proyek yang mengajak komunitas	Logo + URL di 🎨 Customization untuk kartu publik xbot.ninja	Kasus penggunaan 2
Portofolio KOL solo	Foto pribadi + URL LinkedIn di Customization, bagikan URL xbot.ninja ke calon klien	Kasus penggunaan 3
Agensi multi-klien	/setup → 🎯 Filters → ⤴ Named filters → ➕ Add named filter — satu per klien	Kasus penggunaan 4
Menerima post akun X secara real time	/setup → 📡 X Posts Auto-relay → ➕ Add Account	Menu /setup

Apa yang dikonfigurasi

Bagian di /setup	Yang Anda atur	Kenapa penting
🎯 Filters	Akun, cashtag, kata kunci, mention yang dilacak di X	Menentukan post mana yang diambil bot
⏰ Schedule	Waktu untuk laporan otomatis	Bot menjalankan fetch + render pada cron ini
📊 Reports & Period	Jendela tanggal opsional (mis. periode kompetisi)	Membatasi laporan ke rentang waktu tertentu
🎨 Customization	Nama proyek, deskripsi, logo, URL, bobot & warna leaderboard	Branding untuk gambar laporan dan showcase publik xbot.ninja
👥 Admins	Siapa yang menerima DM privat tentang masalah kredit / fetch	Visibilitas operasional
💳 Subscription	Paket, saldo kredit, titik masuk upgrade	Visibilitas biaya dan pembayaran
📡 Auto-relay	Akun X yang diteruskan ke chat secara real time (setiap 5 menit)	Pembaruan langsung di antara laporan terjadwal

Showcase publik (opsional)

Jika proyek Anda memenuhi ambang batas listing publik (≥ 300 skor teratas, ≥ 5 post, ≥ 2 pengguna aktif dalam bulan berjalan), proyek akan muncul di xbot.ninja. Tambahkan metadata proyek di /setup → 🎨 Customization (Name, Description, Logo, URLs).

Setup KOL solo (satu akun) tidak lolos aturan "≥ 2 pengguna aktif" dan tetap hanya dapat diakses lewat URL langsungnya — itu memang disengaja.

Memverifikasi instalasi

Sebagian besar diagnostik terlihat langsung di /setup (setiap layar menampilkan status chat saat ini di bagian atas). Daftar periksa cepat:

Periksa	Caranya
Bot berstatus admin	Telegram → pengaturan grup → Administrators
Pelacakan sudah dikonfigurasi	/setup → 🎯 Filters → lihat daftar akun/cashtag/kata kunci
Filter dirender dengan benar	/setup → 🎯 Filters
Jadwal sudah diatur	/setup (bagian atas menu menampilkan jadwal saat ini)
Kredit tersedia	/setup → 💳 Buy Credits
Laporan manual berfungsi	/setup → 📊 Reports → ⚡ Generate report now

Laporan pertama tidak muncul — pemecahan masalah

Jika Generate report now tidak menghasilkan post dalam 3 menit:

Gejala	Kemungkinan penyebab	Perbaikan
DM bot berkata "no posts found"	Filter terlalu sempit ATAU tidak ada post terbaru yang cocok	/setup → 🎯 Filters — periksa kueri X API literal untuk kesalahan ketik. Coba perluas (hapus periode tanggal jika sudah diatur).
DM bot berkata "credit exhausted"	Chat FREE mencapai batas 100/bulan	Tunggu reset bulan berikutnya, atau /setup → 💳 Buy Credits → 💰 Buy untuk berlangganan / membeli paket kredit
Tidak ada apa-apa, tidak ada DM	Bot bukan admin, ATAU webhook berhenti	Jadikan bot admin kembali. Jika masih tidak ada apa-apa, hubungi dukungan.
Gambar dirender tetapi teks kosong	Komentar AI timeout	Jalankan ulang; bersifat sementara. Jika berlanjut, hubungi dukungan — penyedia AI kadang mengalami gangguan bergilir
Error "Unauthorized" / "Forbidden"	Masalah token X API (di sisi operator)	Hubungi dukungan; tidak ada yang bisa diperbaiki pengguna

Diagnostik mandiri

/setup → ℹ️ About menampilkan chat ID, paket, dan jadwal Anda dalam satu layar. Salin teks itu ke permintaan dukungan mana pun — mempercepat triase hingga ~80%.

FAQ — pertanyaan umum seputar instalasi

T. Bisakah saya memasang bot di channel Telegram (bukan grup)? Tidak, hanya grup dan supergrup. Channel tidak mengizinkan konteks reply pesan, yang digunakan alur laporan.

T. Bisakah saya menjalankan bot di grup bergaya forum dengan topic? Bisa. Gunakan /set_topic dari dalam topic yang Anda inginkan untuk menerima laporan. Bot akan memposting ke topic itu selanjutnya; jika belum diatur, bot memposting ke thread utama.

T. Apakah bot memerlukan akses baca ke pesan grup saya? Bot hanya perlu menerima pesan perintah (mis. /setup). Bot tidak membaca obrolan biasa. Data sisi X berasal dari X API resmi, bukan dari pesan Telegram Anda.

T. Bisakah saya melacak akun X privat/terproteksi? Tidak — X API hanya mengembalikan post publik. Melacak akun terproteksi diam-diam tidak menghasilkan apa pun.

T. Apakah menghapus bot dari grup akan menghapus data saya? Tidak. Pengaturan, riwayat, skor, dan laporan tetap ada di database bot. Jika Anda menambahkan kembali bot ke chat ID yang sama, semuanya berlanjut. Jika Anda ingin penghapusan bersih, hubungi dukungan.

T. Bisakah saya mengubah nama proyek nanti? Bisa — /setup → 🎨 Customization → 🏷 Name. Memperbarui laporan berikutnya dan slug URL xbot.ninja publik.

T. Kenapa jumlah post saya berbeda dari [tool X]? X Bot mengambil langsung dari X API resmi. Kebanyakan tracker pihak ketiga melakukan scraping atau ekstrapolasi. Kami menemukan selisih 20–50% di lapangan. Angka dari X API adalah sumber kebenaran.

T. Bagaimana cara membatalkan?

• Chat FREE: cukup hapus bot dari grup.
• Langganan PRO: /setup → 💳 Buy Credits → 🛠 Manage subscription membuka Stripe Customer Portal tempat Anda bisa membatalkan. Pembatalan berlaku di akhir periode berbayar saat ini.
• Kredit PRO (ETH): kredit tidak diperpanjang otomatis — chat turun ke FREE dengan sendirinya saat saldo mencapai nol. Hapus bot kapan saja.

Butuh bantuan?

Lihat Dukungan, atau buka /setup → ℹ️ About di chat Anda untuk info diagnostik yang bisa dibagikan ke tim.

Baca ikhtisar X Bot untuk rincian lengkap apa yang didapat setiap audiens — proyek kripto, agensi KOL, KOL solo, investor — dari bot sebelum Anda memulai pengaturan.