Dukungan X Bot: Pemecahan Masalah, FAQ & Panduan Kontak

Sebagian besar masalah selesai dengan satu aksi /setup. Separuh pertama halaman ini memandu Anda lewat alur diagnosis mandiri; separuh kedua adalah FAQ. Jika keduanya tidak menyelesaikan masalah, formulir kontak di bagian bawah mengarah langsung ke saluran dukungan developer BWS.

Pertama — alur diagnosis mandiri

Buka /setup → ℹ️ About di chat Anda.
└─ Salin teks itu. Itulah semua yang dibutuhkan dukungan untuk triase.

Lalu tanyakan pada diri sendiri, berurutan:

  1. Apakah bot membalas /setup sama sekali?
     ├─ Tidak → bot dikeluarkan atau diturunkan dari admin → jadikan admin lagi dan coba ulang
     └─ Ya → lanjutkan.

  2. Apakah /setup → 📊 Reports → ⚡ Generate report now menghasilkan sesuatu
     dalam 3 menit?
     ├─ Tanpa DM, tanpa post → periksa pertanyaan berikutnya.
     ├─ DM "no posts found"  → filter terlalu sempit atau tidak ada post on-topic;
                                /setup → 🎯 Filters untuk melihat
                                kueri X API literal.
     ├─ DM "credit exhausted" → /setup → 💳 Buy Credits → 💰 Buy.
     ├─ Post muncul tapi gambarnya salah → jalankan ulang; jika terus terjadi,
                                hubungi dukungan dengan chat ID.
     └─ Post muncul dengan benar → Anda baik-baik saja.

  3. Apakah laporan terjadwal muncul?
     ├─ Tidak → layar atas /setup menampilkan cron. Bandingkan dengan waktu UTC sesungguhnya.
              Run terjadwal pertama bot terjadi SETELAH tick cron berikutnya,
              bukan segera setelah pengaturan.
     └─ Ya → semua baik.

Jika tidak ada dari itu yang membawa Anda ke perbaikan, gulir lewati FAQ ke tautan kontak.

FAQ

Pengaturan & instalasi

T. Bot tidak membalas saat saya menambahkannya. Pastikan bot dijadikan admin, bukan hanya "member". Telegram → pengaturan grup → Administrators. Promosi ulang instan; bot tidak perlu diinstal ulang.

T. Bisakah saya memindahkan bot ke grup lain? Bisa — tambahkan ke grup baru, jalankan /setup di sana. Kedua chat independen (chat ID berbeda = pengaturan, jadwal, skor berbeda). Tidak ada migrasi data antar chat.

T. Bot melaporkan di thread utama, tapi grup saya punya topic — bisakah saya alihkan? Dari dalam topic forum yang diinginkan, kirim:

/set_topic Reports

Laporan berikutnya diarahkan ke topic itu. Reset dengan /set_topic clear.

T. Bagaimana cara uninstall?

• Hentikan laporan dulu: /setup → ⏰ Schedule → ✕ Disable schedule.
• Hapus bot: Telegram → grup → admins → keluarkan @BWS_X_Bot.
• Pengaturan tetap ada di database. Menambahkan kembali bot ke chat ID yang sama melanjutkan semuanya. Hubungi dukungan untuk penghapusan permanen.

Laporan & filter

T. Kenapa angka saya berbeda dari tracker pihak ketiga? X Bot mengambil langsung dari X API resmi. Kebanyakan tracker pihak ketiga melakukan scraping atau ekstrapolasi — kami mengukur selisih 20–50%. Angka dari X API adalah sumber kebenaran.

T. Leaderboard menampilkan pengguna yang tidak saya perkirakan akan dilacak. Filter bersifat aditif. Jika sebuah chat melacak cashtag $YOUR_TOKEN, siapa pun yang men-tweet cashtag itu akan diberi peringkat, bukan hanya akun yang Anda daftarkan. Untuk mensyaratkan akun dan cashtag sekaligus, gunakan bentuk from:@x cashtags:$YOUR_TOKEN lewat /set_x_filtering (semantik AND-antar-semua dari named filter).

T. Laporan menampilkan "0 posts" — sekarang apa? Tiga kemungkinan, dari yang paling mungkin:

1. Filter terlalu sempit — /setup → 🎯 Filters menampilkan kueri X API literal. Kesalahan umum: $BTC (spasi di akhir) vs $BTC.
2. Periode terlalu sempit — jika Anda mengatur periode khusus, post di luar jendela itu tidak dihitung. /setup → 📊 Reports → 🗑 Clear period kembali ke rolling 24 jam.
3. Akun yang dilacak memang tidak memposting apa pun on-topic dalam 24 jam — perluas dengan cashtag atau kata kunci sebagai sinyal cadangan.

T. Bisakah saya melacak akun X privat/terproteksi? Tidak — X API hanya mengembalikan post publik.

T. Bisakah saya mengecualikan pengguna tertentu dari leaderboard chat (mis. bot spam)? Bisa: /setup → 🎯 Filters → 🙈 Ignore → ➕ Add. Handle yang terdaftar dikeluarkan dari hasil setelah fetch.

T. Kenapa chat saya punya beberapa pemicu laporan per hari? Entah Anda mengatur cron multi-fire (cron(0 14,22 ? * * *)) atau Anda punya beberapa named filter berjalan pada jadwal yang sama. Setiap named filter menghasilkan laporannya sendiri.

T. Pilihan "Best Tweet" terasa aneh. Selektor AI memilih post dengan engagement tertinggi yang belum baru-baru ini dipilih. Jika hasilnya terus-menerus terasa tidak tepat, hubungi dukungan — prompt-nya bisa disetel.

X Posts Auto-relay

T. Relay meneruskan thread 6 post sekaligus. Saya hanya ingin yang pertama. Itu karena exclude=replies X API hanya menyaring balasan ke pengguna lain; self-reply (kelanjutan thread) melewatinya. /setup → 📡 X Posts Auto-relay → @akun → matikan toggle ☐ Thread continuations. Bot lalu hanya menyimpan bagian awal setiap thread.

T. Relay berhenti meneruskan di tengah hari. Periksa layar per-relay — jika Today: 10/10 forwarded, Anda mencapai batas harian. Ketuk ✏️ Cap untuk menaikkan. Batas reset otomatis tengah malam UTC.

T. Relay menampilkan ⏸ Paused tapi saya tidak pernah mem-pause-nya. Bot otomatis mem-pause saat terjadi error Telegram chat-gone (dikeluarkan / diblokir / chat di-upgrade) dan menghentikan jadwal polling. /setup → 📡 X Posts Auto-relay menampilkan barisnya kalau-kalau Anda menambahkan kembali bot.

Penagihan & kredit

T. Apa sebenarnya "kredit" itu? Satu kredit = satu post yang dikembalikan X API. Chat FREE mendapat 100 kredit gratis/bulan; chat PRO ditagih lewat Stripe (langganan) atau ETH (paket kredit).

T. Di mana saya melihat saldo kredit saya?/setup → 💳 Buy Credits. Menampilkan terpakai / sisa / tanggal reset.

T. Saya baru saja membayar tapi saldo / paket saya tidak berubah.

• Jalur Stripe (langganan kartu): webhook biasanya mengaktifkan PRO dalam hitungan detik. Jika 5+ menit kemudian Anda belum melihat PRO ✓ di /setup → 💳 Buy Credits, hubungi dukungan dengan resi Stripe dan chat ID.
• Jalur ETH (paket kredit): konfirmasi on-chain bisa memakan waktu 1–3 menit. Jika setelah 10 menit kredit belum muncul, hubungi dukungan dengan hash transaksi dan chat ID.

T. Bisakah saya punya langganan Stripe DAN kredit ETH pada chat yang sama? Bisa — keduanya digabung. Chat PRO·credits yang berlangganan tetap mempertahankan saldo ETH yang ada, dan penagihan per-fetch menguras kredit ETH lebih dulu sebelum jatah bulanan langganan berlaku. Efek praktisnya: jika Anda punya 5.000 kredit ETH dan berlangganan, 5.000 fetch pertama tidak menyentuh Stripe sama sekali; fetch berikutnya memakai jatah 1.000/bulan langganan; apa pun di luar itu adalah kelebihan pemakaian terukur $0.02/post. Saldo ETH tidak pernah kedaluwarsa.

Satu batasan: chat yang sudah berlangganan PRO·sub tidak bisa menambah paket ETH baru dari alur beli yang sama hari ini (perintah beli memblokirnya). Batalkan langganan terlebih dahulu jika Anda ingin beralih kembali ke kredit-saja.

T. Apa yang terjadi saat saldo PRO·credits saya mencapai nol? Lisensi otomatis diturunkan ke FREE. Bot terus mengambil data di bawah batas FREE 100/bulan sampai itu juga habis. /setup → 💳 → 💰 Buy berikutnya menawarkan kedua jalur lagi.

T. Apakah saldo kredit per-chat atau per-pengguna? Per-chat. Setiap grup Telegram punya kredit dan lisensinya sendiri.

Dashboard publik

T. Proyek saya tidak muncul di xbot.ninja. Tiga ambang batas harus semuanya terpenuhi dalam bulan berjalan:

• Skor pengguna teratas ≥ 300
• Post yang dilacak ≥ 5
• Pengguna aktif ≥ 2

Bulan pertama biasanya jadi hambatan. URL langsung https://xbot.ninja/?chatId=<chat-id-anda> tetap berfungsi terlepas dari itu.

T. Bagaimana saya menemukan chat ID saya?/setup → ℹ️ About. Bilangan bulat panjang berawalan minus.

T. Bisakah saya menyesuaikan kartu publik xbot.ninja?/setup → 🎨 Customization. Atur Name, Description, Logo, URLs. Kartu diperbarui pada siklus laporan berikutnya.

Keanehan X API

T. Kenapa beberapa post yang lebih lama dari perkiraan ikut terhitung? Bot menggunakan endpoint tweets/search/all (arsip lengkap). Saat Anda mengatur periode, bot bisa mengambil post dari kapan pun di dalam periode itu. Default-nya rolling 24 jam, tapi periode khusus bisa mundur ke masa lalu.

T. Kadang sebuah post butuh 5+ menit untuk muncul di relay. X Posts Auto-relay melakukan polling setiap 5 menit. Latensinya hingga satu interval polling (~2.5 menit rata-rata / ~5 menit terburuk). Ditambah latensi singkat X API + pengiriman Telegram.

T. X API mengembalikan error — apa yang dilihat operator? Penghitung error internal naik, admin yang ditunjuk menerima DM privat (/setup → 👥 Admins untuk mengatur siapa). Kode 4xx umum: 401/403 (kredensial di sisi operator), 402 (kredit habis), 429 (rate-limited — bot mencoba ulang dengan backoff).

Yang harus disertakan dalam permintaan dukungan

Salin dan tempel template ini:

Project: <nama proyek Anda>
Chat ID: <dari /setup → ℹ️ About>
Plan: FREE / PRO·credits / PRO·sub
What's wrong: <1–2 kalimat>
What you tried: </setup → … → … langkah yang sudah dijalankan>
When it broke: <perkiraan waktu UTC>
Recent change: <filter / jadwal / pembayaran baru dalam 24 jam terakhir>

Chat ID saja memberi dukungan 80% informasi triase — mohon selalu sertakan.

Perkiraan waktu respons

• Critical: bot offline di seluruh platform, kegagalan penagihan → respons dalam 1 jam kerja selama overlap jam kerja EU+US
• High: laporan tidak terkirim untuk satu chat → hari kerja yang sama
• Normal: pertanyaan fitur, bantuan konfigurasi → 1–2 hari kerja

Tautan berguna

• Bot Telegram: @BWS_X_Bot
• Dashboard publik: xbot.ninja
• Dokumentasi: /docs/
• GitHub issues: blockchain-web-services/bws-api-telegram-xbot
• Dukungan langsung: bws.ninja — formulir kontak yang mengarah ke dukungan developer BWS

Sebelum menghubungi dukungan, jalankan alur diagnosis mandiri Pemecahan Masalah — sebagian besar masalah selesai di dua pemeriksaan pertama.