Pemecahan Masalah X Bot: Laporan, Filter, Jadwal, Penagihan
Indeks konsolidasi untuk setiap jalur "ada yang tampak salah, sekarang apa". Matriks di installation / setup-menu / support juga ada di sini sehingga Anda bisa mencari di satu halaman, bukan tiga.
Mulai di sini: buka
/setup→ ℹ️ About di grup Anda. Empat baris di layar itu (chat ID, paket, jadwal, nama proyek) adalah yang dibutuhkan dukungan untuk triase. Salin sebelum melakukan apa pun.
Alur diagnosis mandiri
Jalankan pertanyaan-pertanyaan ini berurutan. Sebagian besar masalah selesai di salah satu dari dua pemeriksaan pertama.
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 post
dalam 3 menit?
├─ Tanpa DM, tanpa post → cek matriks di §"Laporan tidak muncul"
├─ DM "no posts found" → lihat §"Filter / tanpa post"
├─ DM "credit exhausted" → lihat §"Penagihan & kredit"
├─ Post muncul tapi render salah → lihat §"Kualitas render"
└─ Post muncul dengan benar → Anda baik-baik saja.
3. Apakah laporan terjadwal muncul tepat waktu?
├─ Tidak → lihat §"Jadwal tidak terpicu"
└─ Ya → semua baik.
4. Ada masalah X Posts Auto-relay?
└─ Lihat §"X Posts Auto-relay"Jika tidak ada matriks di bawah yang membawa Anda ke perbaikan, gulir ke Eskalasi.
Laporan tidak muncul
| Gejala | Kemungkinan penyebab | Perbaikan |
|---|---|---|
| Bot aktif sebelumnya, tiba-tiba diam | Bot diturunkan dari admin / dikeluarkan diam-diam | Telegram → admin grup → jadikan admin lagi. Jika masih diam, hubungi dukungan — auto-disable saat chat-gone mungkin terpicu. |
| Generate-now manual tidak menghasilkan apa pun | Bot admin tapi kreditnya nol | /setup → 💳 Buy Credits. Jika FREE "100/100 used" — tunggu reset bulanan (tanggal 1 UTC). Jika PRO·credits dengan REMAINING=0 — chat sudah otomatis turun ke FREE; /setup → 💳 → 💰 Buy untuk top up. |
| Generate-now manual: DM admin "no posts found" | Filter terlalu sempit ATAU tidak ada post dalam jendela | /setup → 🎯 Filters. Periksa kueri X API literal untuk kesalahan ketik. Coba perluas atau hapus periode. |
| Gambar dirender tapi teks kosong | Komentar AI timeout | Jalankan ulang; bersifat sementara. Jika terus terjadi, hubungi dukungan. |
| Gambar gagal dirender sepenuhnya | Gangguan render sementara | Jalankan ulang. Jika terus gagal untuk satu chat, hubungi dukungan dengan chat ID. |
| Error "Unauthorized" / "Forbidden" di DM admin | Masalah token X API (di sisi operator) | Hubungi dukungan; tidak ada yang bisa diperbaiki pengguna. |
Filter / tanpa post
| Gejala | Kemungkinan penyebab | Perbaikan |
|---|---|---|
| Laporan menampilkan "0 posts" di mana-mana | Filter tidak cocok dengan apa pun dalam periode yang dikonfigurasi | Langkah 1: /setup → 🎯 Filters — konfirmasi kueri. Langkah 2: /setup → 📊 Reports → 🗑 Clear period (rolling 24h lebih longgar). Langkah 3: perluas filter (tambah cashtag cadangan, hapus grup kata kunci yang ketat). |
| Leaderboard menampilkan pengguna yang tidak saya tambahkan ke filter | Filter bersifat aditif — siapa pun yang men-tweet cashtag/kata kunci yang dilacak akan dihitung | Untuk mensyaratkan akun dan cashtag sekaligus, gunakan /set_x_filtering name from:@x cashtags:$Y (named filter, AND-antar-kategori). |
| Satu pengguna yang sama mendominasi leaderboard | Bot secara sah menilai setiap post-nya | /setup → 🎯 Filters → 🙈 Ignore → ➕ Add @spammer — mereka dikeluarkan dari hasil setelah fetch. |
| Cashtag dengan karakter aneh tidak cocok | X API menormalkan huruf besar/kecil; spasi awal/akhir berpengaruh pada input filter | Tambahkan ulang lewat /setup → 🎯 Filters → 💵 Cashtags → ➕ Add → tanpa $, tanpa spasi. |
Cashtag berawalan angka (mis. $1INCH) tidak terlacak | Perilaku pencarian X API dengan angka di depan bisa tidak konsisten | Gunakan sebagai kata kunci, bukan cashtag: "$1INCH" di 🔍 Keywords dengan tanda kutip. |
| Pilihan "Best Tweet" terasa tidak tepat | Deduplikasi AI baru-baru ini memilih tweet yang mirip | Tunggu satu siklus. Jika terus terasa tidak tepat, laporkan; prompt-nya bisa disetel. |
Jadwal tidak terpicu
| Gejala | Kemungkinan penyebab | Perbaikan |
|---|---|---|
Jadwal "ditolak" dengan FREQUENCY_ERROR | Cron mencoba terpicu lebih sering dari setiap 12 jam | Pemeriksaan jarak menegakkan jarak ≥ 12 jam. Pesan error menyebutkan pasangan jam yang bermasalah. Pilih jarak yang lebih lebar. |
| Jadwal sudah diatur, tapi laporan tidak muncul tepat waktu | Cron terjadwal terpicu dalam ~1–2 menit dari waktunya | Tunggu 5 menit setelah waktu yang dikonfigurasi sebelum menganggapnya terlewat. Keterlambatan upstream jarang terjadi tapi selesai dengan sendirinya. |
| Cron multi-fire hanya terpicu sekali | Daftar jam tidak berurutan atau duplikat | cron(0 14,22 ? * * *) — jam menaik. cron(0 22,14 ? * * *) ditolak. |
| Jadwal di staging terpicu setiap 5 menit, produksi tidak | Namespace RULE_NAME berbeda | Konfirmasi Anda memeriksa environment yang benar. /setup → ℹ️ About menampilkan env. |
| Zona waktu terasa salah | Jadwal memang UTC by design | Konversi waktu lokal Anda ke UTC. Input pengaturan jadwal juga menerima zona waktu bernama dalam beberapa kasus khusus — periksa docstring entry-nya. |
| X Posts Auto-relay terpicu tapi laporan tidak | Jadwal cron berbeda | X Posts Auto-relay memakai polling 5 menit per relay; laporan memakai cron jadwal utama chat (biasanya harian). Keduanya independen. |
Kualitas render
| Gejala | Kemungkinan penyebab | Perbaikan |
|---|---|---|
| Judul / warna kustom kembali seperti semula semalaman | Cache dibatalkan, fetch berikutnya menampilkan nilai baru | Tunggu satu siklus laporan (~1 hari). Cache render dibangun ulang pada fetch berikutnya. |
| Logo buram / terpotong | Gambar sumber terlalu kecil atau tidak persegi | Unggah ulang minimal 512×512 PNG, rasio persegi. /setup → 🎨 Customization → 🖼 Logo. |
| Username meluber di gambar leaderboard | Nama tampilan panjang | Bot memotong dengan elipsis; tidak perlu diperbaiki kecuali terus terjadi. |
Teks best-tweet menampilkan HTML <a href> mentah | Ketidakcocokan mode parse Telegram | Bug — mohon laporkan dengan URL tweet-nya. |
| Gambar laporan berbeda dari pratinjau Telegram | Telegram menyimpan cache byte gambar pertama berdasarkan URL; URL presigned menyertakan timestamp sehingga setiap fetch unik | Seharusnya tidak terjadi; jika terjadi, rotasi lewat /recreate. |
X Posts Auto-relay
| Gejala | Kemungkinan penyebab | Perbaikan |
|---|---|---|
| Relay meneruskan thread 6 tweet sekaligus | Self-reply melewati exclude=replies X API | /setup → 📡 X Posts Auto-relay → @akun → matikan toggle ☐ Thread continuations. Bot lalu hanya menyimpan bagian awal. |
| Relay berhenti di tengah hari | Batas harian tercapai | Layar per-relay menampilkan Today: N/N forwarded. Ketuk ✏️ Cap dan naikkan. Reset tengah malam UTC. |
| Relay menampilkan ⏸ Paused tapi saya tidak pernah mem-pause-nya | Auto-pause saat Telegram chat-gone (dikeluarkan / diblokir / chat di-upgrade) | Bot juga menghentikan jadwal polling. Untuk memulihkan: /setup → 📡 X Posts Auto-relay → @akun → ▶️ Resume. Jika masih gagal, chat itu sendiri mungkin berganti ID (upgrade super-grup) — tambahkan ulang bot di chat baru. |
| Polling pertama relay meneruskan 50 post | Bootstrap seharusnya tidak melakukan ini — hanya menyemai LAST_POST_ID tanpa meneruskan | Jika Anda melihat ini, mohon laporkan. Perbaikan yang ditambahkan pada 2026-04 seharusnya mencegah ini. |
| Quote tweet terus muncul meski toggle sudah dimatikan | X API tidak punya exclude=quotes di sisi server — bot menyaring di sisi klien | Toggle tetap berfungsi, tapi Anda tetap membayar untuk quote tweet yang dikembalikan API. Penghematan kosmetik saja. |
| Relay terus polling meski chat sudah dihapus | Versi lama relay — auto-cleanup ditambahkan 2026-05 | Minta dukungan untuk menghentikan paksa relay. Deployment baru membersihkan dirinya sendiri. |
Penagihan & kredit
| Gejala | Kemungkinan penyebab | Perbaikan |
|---|---|---|
| Sudah beli kredit, saldo tidak berubah | Webhook Stripe tertunda | Tunggu 5 menit. Jika masih salah, hubungi dukungan dengan resi Stripe + chat ID. |
| Jumlah kredit lebih tinggi dari perkiraan | Sebuah relay melakukan polling berkali-kali saat akun yang dilacak sedang aktif | X Posts Auto-relay menagih per post. Ketuk relay → periksa penghitung Today. |
| Biaya kelebihan pemakaian pada PRO·sub padahal saya posting sedikit | Pemakaian lain pada chat (relay, laporan, fetch retry) | /setup → 💳 Buy Credits → Usage this month. Bandingkan dengan biaya terukur. |
| Chat FREE dikenakan biaya | Seharusnya tidak terjadi — FREE tidak punya customer Stripe | Laporkan segera; ini bug penagihan. |
| Langganan menampilkan "canceled" tapi saya tidak membatalkannya | Pembatalan Stripe bisa terpicu oleh kegagalan perpanjangan otomatis kartu | Periksa email untuk resi Stripe, perbarui kartu lewat /setup → 💳 → 🛠 Manage subscription (Stripe Customer Portal). |
| Membatalkan langganan, masih PRO | Cancel-at-period-end: PRO hingga akhir periode berbayar | Sesuai harapan. Kembali ke FREE di akhir siklus penagihan berikutnya. |
Dashboard publik
| Gejala | Kemungkinan penyebab | Perbaikan |
|---|---|---|
| Proyek tidak muncul di xbot.ninja | Tidak memenuhi ambang batas (≥ 300 skor teratas, ≥ 5 post, ≥ 2 pengguna aktif bulan ini) | URL langsung tetap berfungsi. Tunggu metrik mencapai ambang batas. Setup KOL solo memang sengaja disembunyikan dari showcase. |
| Proyek ada di xbot.ninja tapi logo hilang | Logo belum pernah diunggah, atau unggahan gagal | /setup → 🎨 Customization → 🖼 Logo. Kirim PNG persegi. |
| URL publik menampilkan nama proyek lama | Refresh pada siklus laporan berikutnya | Ganti nama lewat /setup → 🎨 Customization → 🏷 Name. Slug URL + kartu diperbarui setelah laporan berikutnya terpicu. |
| URL memberikan 404 | Chat sudah dihapus permanen, ATAU ambang batas belum terpenuhi sehingga showcase menyembunyikannya | Konfirmasi chat ID lewat /setup → ℹ️ About. Uji URL langsung https://xbot.ninja/?chatId=<id>. |
Eskalasi
Saat matriks di atas tidak menyelesaikan masalah, hubungi dukungan dengan template di bawah.
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.
Ke mana mengirim:
- Dukungan umum: form kontak bws.ninja
- GitHub issues (open-source aware): bws-api-telegram-xbot/issues
- Telegram langsung: @BlockchainWebServices
Waktu respons berdasarkan tingkat keparahan:
- Critical (bot offline di seluruh platform, kegagalan penagihan): 1 jam kerja selama overlap jam kerja EU+US
- High (laporan satu chat tidak terkirim): hari kerja yang sama
- Normal (pertanyaan fitur, bantuan konfigurasi): 1–2 hari kerja
Perintah diagnostik yang berguna
| Perintah | Yang ditampilkan |
|---|---|
/setup → ℹ️ About | Chat ID, paket, jadwal, proyek — salin ini apa adanya ke dukungan |
/setup → 🎯 Filters | String kueri X API literal |
/setup → 💳 Buy Credits → 📊 Usage this month | Penghitung fetched_posts harian + bulanan — menemukan kegagalan diam-diam (attempts tinggi, post nol → kemungkinan 402) |
/setup → 📡 X Posts Auto-relay → @akun | Status per-relay (aktif / dijeda, forward hari ini, batas harian) |
/get_chatid | Hanya chat ID (satu baris jika About berlebihan) |
Langkah selanjutnya
- Instalasi — instal ulang bersih jika semua yang lain gagal
- Menu /setup — referensi menu lengkap
- Harga — pemecahan masalah sisi penagihan
- Dukungan — FAQ + eskalasi kontak