X Bot Sorun Giderme: Raporlar, Filtreler, Takvimler, Faturalandırma
Her "bir şeyler yanlış görünüyor, şimdi ne olacak" yolunun birleştirilmiş bir dizini. Kurulum / setup-menü / destek sayfalarındaki matrisler de burada yaşar, böylece üç sayfa yerine tek bir sayfada arama yapabilirsiniz.
Buradan başlayın: grubunuzda
/setup→ ℹ️ About açın. O ekrandaki dört satır (sohbet kimliği, plan, takvim, proje adı) desteğin triyaj için ihtiyaç duyduğu şeydir. Başka bir şey yapmadan önce onları kopyalayın.
Kendi kendine tanılama akışı
Bu soruları sırayla yanıtlayın. Çoğu sorun ilk iki kontrolde çözülür.
1. Does the bot reply to /setup at all?
├─ No → bot was kicked or demoted from admin → re-promote and retry
└─ Yes → continue.
2. Does /setup → 📊 Reports → ⚡ Generate report now produce a post
within 3 minutes?
├─ No DM, no post → check matrix in §"Reports not arriving"
├─ DM "no posts found" → see §"Filter / no posts"
├─ DM "credit exhausted" → see §"Billing & credits"
├─ Post landed but renders wrong → see §"Render quality"
└─ Post landed correctly → you're fine.
3. Are scheduled reports arriving on time?
├─ No → see §"Schedule not firing"
└─ Yes → all good.
4. X Posts Auto-relay issues?
└─ See §"X Posts Auto-relay"Aşağıdaki matrislerin hiçbiri sizi bir çözüme götürmüyorsa, Yükseltme bölümüne kaydırın.
Raporlar gelmiyor
| Belirti | Olası neden | Çözüm |
|---|---|---|
| Bot daha önce aktifti, aniden sessiz | Bot yöneticilikten indirildi / sessizce atıldı | Telegram → grup yöneticileri → yeniden yönetici yapın. Hâlâ sessizse desteğe başvurun — sohbet-yok üzerine otomatik devre dışı bırakma tetiklenmiş olabilir. |
| Manuel generate-now hiçbir şey üretmiyor | Bot yönetici ama sıfır kredisi var | /setup → 💳 Buy Credits. FREE "100/100 kullanıldı" ise — aylık sıfırlamayı bekleyin (ayın 1'i UTC). PRO·credits REMAINING=0 ise — sohbet zaten FREE'ye otomatik düştü; doldurmak için /setup → 💳 → 💰 Buy. |
| Manuel generate-now: "gönderi bulunamadı" yönetici DM'i | Filtre çok dar VEYA pencerede gönderi yok | /setup → 🎯 Filters. Yazım hataları için gerçek X API sorgusunu kontrol edin. Genişletmeyi veya dönemi bırakmayı deneyin. |
| Görsel render edildi ama metin boş | AI yorumu zaman aşımına uğradı | Yeniden çalıştırın; geçici. Kalıcıysa desteğe başvurun. |
| Görsel hiç render edilmiyor | Geçici render aksaklığı | Yeniden çalıştırın. Bir sohbet için tekrar tekrar başarısız oluyorsa, sohbet kimliğiyle desteğe başvurun. |
| Yönetici DM'inde "Unauthorized" / "Forbidden" hatası | X API token sorunu (operatör tarafı) | Desteğe başvurun; kullanıcının düzeltebileceği bir şey değil. |
Filtre / gönderi yok
| Belirti | Olası neden | Çözüm |
|---|---|---|
| Rapor her yerde "0 gönderi" gösteriyor | Filtre, yapılandırılan dönemde hiçbir şeyle eşleşmiyor | Adım 1: /setup → 🎯 Filters — sorguyu doğrulayın. Adım 2: /setup → 📊 Reports → 🗑 Clear period (kayan 24 saat daha esnektir). Adım 3: filtreleri genişletin (bir cashtag yedeği ekleyin, katı anahtar kelime gruplarını bırakın). |
| Liderlik tablosu filtreye eklemediğim kullanıcıları gösteriyor | Filtreler toplamsaldır — izlenen bir cashtag/anahtar kelime tweetleyen herkes sayılır | Hem bir hesabı hem de bir cashtag'i gerektirmek için /set_x_filtering name from:@x cashtags:$Y (adlandırılmış filtre, kategorilerin VE'si) kullanın. |
| Aynı kullanıcı liderlik tablosunu spamledi | Bot her gönderiyi meşru olarak puanladı | /setup → 🎯 Filters → 🙈 Ignore → ➕ Add @spammer — çekimden sonra sonuçlardan düşürülürler. |
| Garip karakterli cashtag eşleşmiyor | X API büyük/küçük harfi normalleştirir; filtre girişinde baştaki/sondaki boşluklar önemlidir | /setup → 🎯 Filters → 💵 Cashtags → ➕ Add üzerinden yeniden ekleyin — $ gerekmez, boşluk yok. |
Sayıyla başlayan cashtag (örn. $1INCH) izlenmiyor | Baştaki sayılarla X API arama davranışı tutarsız olabilir | Cashtag yerine anahtar kelime olarak kullanın: 🔍 Keywords'te tırnak içinde "$1INCH". |
| "Best Tweet" seçimi garip görünüyor | AI tekilleştirmesi yakın zamanda benzer bir tweeti seçti | Bir döngü bekleyin. Kalıcı yanlışlık = rapor edin; prompt ayarlanabilir. |
Takvim tetiklenmiyor
| Belirti | Olası neden | Çözüm |
|---|---|---|
Takvim FREQUENCY_ERROR ile "reddedildi" | Cron her 12 saatten daha sık tetiklenmeye çalışıyor | Aralık kontrolü ≥ 12 saatlik boşlukları zorunlu kılar. Hata mesajı sorunlu saat çiftini adlandırır. Daha geniş bir boşluk seçin. |
| Takvim ayarlandı ama rapor zamanında gelmedi | Zamanlanmış cron, tikin ~1–2 dakika içinde tetiklenir | Bir kaçırma varsaymadan önce yapılandırılan saatten sonra 5 dakika bekleyin. Nadir üst akış gecikmeleri olur ama kendiliğinden çözülür. |
| Çoklu tetiklemeli cron yalnızca bir kez tetikleniyor | Saat listesi sırasız veya yinelenmiş | cron(0 14,22 ? * * *) — artan saatler. cron(0 22,14 ? * * *) reddedilir. |
| Staging'de takvim her 5 dakikada bir tetikleniyor, prod'da değil | Farklı RULE_NAME ad alanı | Doğru ortamı kontrol ettiğinizi doğrulayın. /setup → ℹ️ About ortamı gösterir. |
| Saat dilimi yanlış görünüyor | Takvim tasarım gereği UTC'dir | Yerel saatinizi UTC'ye çevirin. Takvim ayarlama girişi bazı kenar durumlarda adlandırılmış saat dilimlerini de kabul eder — girişin belge dizesini kontrol edin. |
| X Posts Auto-relay tetikleniyor ama raporlar tetiklenmiyor | Farklı cron takvimleri | X Posts Auto-relay röle başına 5 dakikalık bir yoklama kullanır; raporlar sohbetin ana takvim cron'unu kullanır (genellikle günlük). Bağımsızdırlar. |
Render kalitesi
| Belirti | Olası neden | Çözüm |
|---|---|---|
| Özel başlık / renk gecede geri döndü | Önbellek geçersiz kılındı, bir sonraki çekim yeni değeri gösterir | Bir rapor döngüsü bekleyin (~1 gün). Render önbelleği bir sonraki çekimde yeniden oluşturulur. |
| Logo bulanık / kırpılmış | Kaynak görsel çok küçük veya kare değil | ≥ 512×512 PNG, kare oranda yeniden yükleyin. /setup → 🎨 Customization → 🖼 Logo. |
| Liderlik tablosu görselinde kullanıcı adı taşıyor | Uzun görünen ad | Bot üç noktayla kırpar; kalıcı değilse bir düzeltme gerekmez. |
En iyi tweet metni ham <a href> HTML'i gösteriyor | Telegram ayrıştırma modu uyuşmazlığı | Hata — lütfen tweet URL'siyle rapor edin. |
| Rapor görseli Telegram önizlemesinden farklı | Telegram ilk görsel baytlarını URL'ye göre önbelleğe alır; ön imzalı URL'ler bir zaman damgası içerir, bu yüzden her çekim benzersizdir | Olmamalı; olursa /recreate ile döndürün. |
X Posts Auto-relay
| Belirti | Olası neden | Çözüm |
|---|---|---|
| Röle bir kerede 6 tweetlik bir thread iletiyor | Kendi kendine yanıtlar X API'sinin exclude=replies'ini atlar | /setup → 📡 X Posts Auto-relay → @account → ☐ Thread continuations'ı kapatın. Bot ardından yalnızca başı tutar. |
| Röle gün ortasında durdu | Günlük üst sınıra ulaşıldı | Röle başına ekran Today: N/N forwarded gösterir. ✏️ Cap'e dokunun ve yükseltin. UTC gece yarısı sıfırlanır. |
| Röle ⏸ Paused gösteriyor ama ben hiç durdurmadım | Telegram sohbet-yok üzerine otomatik duraklatıldı (atıldı / engellendi / sohbet yükseltildi) | Bot ayrıca yoklama zamanlamasını da durdurdu. Geri yüklemek için: /setup → 📡 X Posts Auto-relay → @account → ▶️ Resume. Hâlâ başarısız oluyorsa, sohbetin kendisi kimlik değiştirmiş olabilir (süper grup yükseltmesi) — botu yeni sohbette yeniden ekleyin. |
| Rölenin ilk yoklaması 50 gönderi iletti | Bootstrap bunu yapmamalı — yalnızca iletmeden LAST_POST_ID'yi tohumlamalı | Bunu görürseniz lütfen rapor edin. 2026-04'te eklenen düzeltme bunu önlemelidir. |
| Anahtar kapalı olsa da alıntı tweetler görünmeye devam ediyor | X API'de sunucu tarafı exclude=quotes yok — bot istemci tarafında filtreler | Anahtar çalışıyor ama API tarafından döndürülen alıntı tweetler için yine de ödeme yaparsınız. Yalnızca kozmetik tasarruf. |
| Sohbet silinmiş olmasına rağmen röle sonsuza kadar yoklamaya devam ediyor | Eski sürüm röle — otomatik temizlik 2026-05'te eklendi | Rölenin zorla durdurulması için desteğe başvurun. Yeni dağıtımlar kendini temizler. |
Faturalandırma ve krediler
| Belirti | Olası neden | Çözüm |
|---|---|---|
| Kredi satın alındı, bakiye değişmedi | Stripe webhook gecikti | 5 dakika bekleyin. Hâlâ yanlışsa Stripe makbuzu + sohbet kimliğiyle desteğe başvurun. |
| Kredi sayısı beklediğimden yüksek | İzlenen hesap aktifken bir röle bir dönem boyunca birden fazla yoklama yaptı | X Posts Auto-relay gönderi başına ücretlendirir. Röleye dokunun → Today sayacını kontrol edin. |
| Az paylaşım yapmama rağmen PRO·sub'da aşım ücreti | Sohbette başka kullanım (röleler, raporlar, çekim yeniden denemeleri) | /setup → 💳 Buy Credits → Usage this month. Ölçümlü ücretle karşılaştırın. |
| FREE sohbet ücretlendirildi | Olmamalı — FREE'nin Stripe müşterisi yoktur | Hemen rapor edin; bu bir faturalandırma hatası. |
| Abonelik "canceled" gösteriyor ama ben iptal etmedim | Stripe iptali başarısız kart otomatik yenilemesiyle tetiklenebilir | Stripe makbuzları için e-postayı kontrol edin, /setup → 💳 → 🛠 Manage subscription (Stripe Müşteri Portalı) üzerinden kartı güncelleyin. |
| Aboneliği iptal ettim, hâlâ PRO | Dönem sonunda iptal: ödemeli dönemin sonuna kadar PRO | Beklenen. Bir sonraki fatura döngüsünün sonunda FREE'ye döner. |
Herkese açık gösterge paneli
| Belirti | Olası neden | Çözüm |
|---|---|---|
| Proje xbot.ninja'da yok | Eşikleri karşılamıyor (≥ 300 en yüksek puan, ≥ 5 gönderi, bu ay ≥ 2 aktif kullanıcı) | Doğrudan URL hâlâ çalışır. Metriğin eşiğe ulaşmasını bekleyin. Bağımsız KOL kurulumları kasıtlı olarak vitrinden gizlenir. |
| Proje xbot.ninja'da ama logo eksik | Logo hiç yüklenmedi veya yükleme başarısız oldu | /setup → 🎨 Customization → 🖼 Logo. Kare bir PNG gönderin. |
| Herkese açık URL eski proje adını gösteriyor | Bir sonraki rapor döngüsünde yenilenir | /setup → 🎨 Customization → 🏷 Name üzerinden yeniden adlandırın. URL yolu + kart bir sonraki rapor tetiklendiğinde yenilenir. |
| URL 404 veriyor | Sohbet kalıcı olarak silindi VEYA eşikler henüz karşılanmadı, bu yüzden vitrin gizliyor | /setup → ℹ️ About üzerinden sohbet kimliğini doğrulayın. Doğrudan URL'yi test edin: https://xbot.ninja/?chatId=<id>. |
Yükseltme
Yukarıdaki matrisler çözüme ulaştırmadığında, aşağıdaki şablonla desteğe başvurun.
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>Sohbet kimliği tek başına desteğe triyaj bilgisinin %80'ini verir — lütfen her zaman dahil edin.
Nereye gönderilir:
- Genel destek: bws.ninja iletişim formu
- GitHub sorunları (açık kaynak farkındalığı olan): bws-api-telegram-xbot/issues
- Doğrudan Telegram: @BlockchainWebServices
Önem derecesine göre yanıt süreleri:
- Kritik (bot platform genelinde çevrimdışı, faturalandırma hataları): AB+ABD mesai saati çakışmasında 1 iş saati
- Yüksek (bir sohbetin raporu gelmiyor): aynı iş günü
- Normal (özellik soruları, yapılandırma yardımı): 1–2 iş günü
Yararlı tanılama komutları
| Komut | Ne gösterir |
|---|---|
/setup → ℹ️ About | Sohbet kimliği, plan, takvim, proje — bunu olduğu gibi desteğe kopyalayın |
/setup → 🎯 Filters | Gerçek X API sorgu dizesi |
/setup → 💳 Buy Credits → 📊 Usage this month | Günlük + aylık fetched_posts sayaçları — sessiz hataları tespit eder (yüksek deneme, sıfır gönderi → muhtemelen 402'ler) |
/setup → 📡 X Posts Auto-relay → @account | Röle başına durum (aktif / duraklatılmış, bugünkü iletimler, günlük üst sınır) |
/get_chatid | Yalnızca sohbet kimliği (About fazla geliyorsa tek satırlık) |
Sırada ne var
- Kurulum — her şey başarısız olursa temiz bir yeniden kurulum
- /setup menüsü — tam menü referansı
- Fiyatlandırma — faturalandırma tarafı sorun giderme
- Destek — SSS + iletişim yükseltme