X Bot Destek: Sorun Giderme, SSS ve İletişim Rehberi
Çoğu sorun tek bir /setup işlemiyle kendiliğinden çözülür. Bu sayfanın ilk yarısı sizi kendi kendine tanılama akışında yönlendirir; ikinci yarısı bir SSS'dir. İkisi de çözmezse, en alttaki iletişim formu doğrudan BWS geliştirici destek kanalına yönlendirir.
İlk olarak — kendi kendine tanılama akışı
Open /setup → ℹ️ About in your chat.
└─ Copy that text. It's everything support needs to triage.
Then ask yourself, in order:
1. Does the bot reply to /setup at all?
├─ No → bot was kicked or demoted from admin → re-promote and retry
└─ Yes → continue.
2. Did /setup → 📊 Reports → ⚡ Generate report now produce something
within 3 minutes?
├─ No DM, no post → check next question.
├─ DM "no posts found" → filter too narrow or no on-topic posts;
/setup → 🎯 Filters to see
the literal X API query.
├─ DM "credit exhausted" → /setup → 💳 Buy Credits → 💰 Buy.
├─ Post landed but image looks wrong → re-fire; if persistent,
contact support with the chat ID.
└─ Post landed correctly → you're fine.
3. Are scheduled reports arriving?
├─ No → /setup top screen shows the cron. Compare to actual UTC time.
The bot's first scheduled fire happens AFTER the next cron tick,
not immediately after setup.
└─ Yes → all good.Bunlardan hiçbiri sizi bir çözüme götürmezse, SSS'yi geçip iletişim bağlantısına kaydırın.
SSS
Kurulum ve yükleme
S. Botu eklediğimde yanıt vermiyor. Yalnızca "üye" değil yönetici olarak terfi ettirildiğini doğrulayın. Telegram → grup ayarları → Yöneticiler. Yeniden terfi anındadır; botun yeniden kurulmasına gerek yoktur.
S. Botu farklı bir gruba taşıyabilir miyim? Evet — yeni gruba ekleyin, orada /setup çalıştırın. İki sohbet bağımsızdır (farklı sohbet kimlikleri = farklı ayarlar, takvimler, puanlar). Sohbetler arasında veri taşıma yoktur.
S. Bot ana akışta rapor veriyor ama grubumda konular var — yönlendirebilir miyim? İstediğiniz forum konusunun içinden şunu gönderin:
/set_topic ReportsGelecekteki raporlar o konuya yönlendirilir. /set_topic clear ile sıfırlayın.
S. Nasıl kaldırırım?
- Önce raporları durdurun:
/setup→ ⏰ Schedule → ✕ Disable schedule. - Botu kaldırın: Telegram → grup → yöneticiler →
@BWS_X_Bot'u atın. - Ayarlar veritabanında kalır. Botu aynı sohbet kimliğine yeniden eklemek her şeyi devam ettirir. Kalıcı silme için desteğe başvurun.
Raporlar ve filtreleme
S. Neden sayılarım üçüncü taraf izleme araçlarından farklı? X Bot doğrudan resmi X API'sinden çeker. Çoğu üçüncü taraf izleme aracı kazıma yapar veya tahmin eder — %20–50 arasında tutarsızlıklar ölçtük. X API sayısı doğruluk kaynağıdır.
S. Liderlik tablosu izlemeyi beklemediğim kullanıcıları gösteriyor. Filtreler toplamsaldır. Bir sohbet $TOKEN_ADINIZ cashtag'ini izliyorsa, listelediğiniz hesaplar değil, o cashtag'i tweetleyen herkes sıralanır. Hem bir hesabı hem de bir cashtag'i gerektirmek için /set_x_filtering üzerinden from:@x cashtags:$TOKEN_ADINIZ biçimini (adlandırılmış filtrelerin HER-ŞEYİN-VE'si semantiği) kullanın.
S. Rapor "0 gönderi" diyor — şimdi ne olacak? Olasılık sırasına göre üç olasılık:
- Filtre çok dar —
/setup→ 🎯 Filters gerçek X API sorgusunu gösterir. Yaygın yazım hatası:$BTC(sondaki boşluk) ile$BTC. - Dönem çok dar — özel bir dönem ayarladıysanız, bu pencerenin dışındaki gönderiler sayılmaz.
/setup→ 📊 Reports → 🗑 Clear period kayan 24 saate döner. - İzlediğiniz hesaplar 24 saatte gerçekten konuyla ilgili hiçbir şey paylaşmadı — yedek sinyal için cashtag veya anahtar kelimelerle genişletin.
S. Özel/korumalı bir X hesabını izleyebilir miyim? Hayır — X API yalnızca herkese açık gönderileri döndürür.
S. Bir sohbetin liderlik tablosundan belirli kullanıcıları hariç tutabilir miyim (örn. spam botlar)? Evet: /setup → 🎯 Filters → 🙈 Ignore → ➕ Add. Listelenen hesaplar çekimden sonra sonuçlardan düşürülür.
S. Sohbetimde neden günde birden fazla rapor tetiklemesi var? Ya bir çoklu tetiklemeli cron ayarladınız (cron(0 14,22 ? * * *)) ya da aynı takvimde çalışan birden fazla adlandırılmış filtreniz var. Her adlandırılmış filtre kendi raporunu üretir.
S. "Best Tweet" seçimi garip görünüyor. AI seçici, yakın zamanda seçilmemiş en yüksek etkileşimli gönderiyi seçer. Sonuçlar sürekli yanlış hissettiriyorsa desteğe başvurun — prompt ayarlanabilir.
X Posts Auto-relay
S. Röle bir kerede 6 gönderilik bir thread iletti. Yalnızca ilkini istiyordum. Bu, X API'nin exclude=replies'inin yalnızca diğer kullanıcılara verilen yanıtları filtrelemesinden kaynaklanır; kendi kendine yanıtlar (thread devamları) bunu atlar. /setup → 📡 X Posts Auto-relay → @account → ☐ Thread continuations'ı kapatın. Bot ardından yalnızca her thread'in başını tutar.
S. Röle gün ortasında iletmeyi durdurdu. Röle başına ekranı kontrol edin — Today: 10/10 forwarded ise günlük üst sınıra ulaştınız. Yükseltmek için ✏️ Cap'e dokunun. Üst sınır UTC gece yarısı otomatik sıfırlanır.
S. Röle ⏸ Paused gösteriyor ama ben hiç durdurmadım. Bot, Telegram sohbet-yok hatalarında (atıldı / engellendi / sohbet yükseltildi) otomatik olarak duraklatır ve yoklama zamanlamasını durdurur. Botu yeniden eklemeniz durumunda /setup → 📡 X Posts Auto-relay satırı gösterir.
Faturalandırma ve krediler
S. "Kredi" tam olarak nedir? Bir kredi = X API tarafından döndürülen bir gönderi. FREE sohbetler ayda 100 ücretsiz kredi alır; PRO sohbetler Stripe (abonelik) veya ETH (kredi paketi) ile faturalandırılır.
S. Kredi bakiyemi nerede görürüm?/setup → 💳 Buy Credits. Kullanılan / kalan / sıfırlama tarihini gösterir.
S. Az önce ödedim ama bakiyem / planım güncellenmedi.
- Stripe yolu (kart aboneliği): webhook genellikle saniyeler içinde PRO'yu etkinleştirir. 5+ dakika sonra
/setup→ 💳 Buy Credits içindePRO ✓görmüyorsanız, Stripe makbuzunuz ve sohbet kimliğinizle desteğe başvurun. - ETH yolu (kredi paketi): zincir üstü onay 1–3 dakika sürebilir. 10 dakika sonra krediler görünmüyorsa, işlem hash'i ve sohbet kimliğiyle desteğe başvurun.
S. Aynı sohbette hem Stripe aboneliği HEM DE ETH kredileri olabilir mi? Evet — katmanlanırlar. Abone olan bir PRO·credits sohbeti mevcut ETH bakiyesini korur ve çekim başına faturalama, aboneliğin aylık tahsisatı devreye girmeden önce ETH kredilerini boşaltır. Pratik etki: 5.000 ETH krediniz varsa ve abone olursanız, ilk 5.000 çekim Stripe'a hiç dokunmaz; sonraki çekimler aboneliğin ayda 1.000 tahsisatını kullanır; ötesindeki her şey gönderi başına 0,02 $ ölçümlü aşımdır. ETH bakiyesi asla süresi dolmaz.
Tek kısıtlama: zaten PRO·sub'da olan bir sohbet bugün aynı satın alma akışından taze bir ETH paketi ekleyemez (satın alma komutu engeller). Yalnızca krediye dayalı faturalandırmaya geri dönmek istiyorsanız önce aboneliği iptal edin.
S. PRO·credits bakiyem sıfıra ulaştığında ne olur? Lisans otomatik olarak FREE'ye düşürülür. Bot, o da tükenene kadar ayda 100 FREE üst sınırı altında çekmeye devam eder. Bir sonraki /setup → 💳 → 💰 Buy o zaman her iki yolu da yeniden sunar.
S. Kredi bakiyesi sohbet başına mı yoksa kullanıcı başına mı? Sohbet başına. Her Telegram grubunun kendi kredileri ve lisansı vardır.
Herkese açık gösterge paneli
S. Projem xbot.ninja'da görünmüyor.Mevcut ayda üç eşiğin tamamı karşılanmalıdır:
- En yüksek kullanıcı puanı ≥ 300
- İzlenen gönderiler ≥ 5
- Aktif kullanıcılar ≥ 2
İlk ay genellikle darboğazdır. Doğrudan URL https://xbot.ninja/?chatId=<sohbet-kimliginiz> her durumda çalışır.
S. Sohbet kimliğimi nasıl bulurum?/setup → ℹ️ About. Eksi işaretiyle başlayan uzun tam sayı.
S. Herkese açık xbot.ninja kartını özelleştirebilir miyim?/setup → 🎨 Customization. Ad, Açıklama, Logo, URL'ler ayarlayın. Kart bir sonraki rapor döngüsünde yenilenir.
X API tuhaflıkları
S. Neden bazı gönderiler beklenenden daha eski sayılıyor? Bot tweets/search/all (tam arşiv uç noktası) kullanır. Bir dönem ayarladığınızda, bot içindeki herhangi bir zamandan gönderi çekebilir. Varsayılan kayan 24 saattir, ancak özel bir dönem geriye tarihli olabilir.
S. Bazen bir gönderinin bir rölede görünmesi 5+ dakika sürüyor. X Posts Auto-relay her 5 dakikada bir yoklama yapar. Gecikme en fazla bir yoklama aralığı kadardır (~ortalama 2,5 dk / ~en kötü durumda 5 dk). Artı kısa X API + Telegram teslimat gecikmesi.
S. X API bir hata döndürdü — operatör ne görür? Dahili hata sayaçları artar, belirlenen yöneticiler özel bir DM alır (kimin yapılandırılacağı için /setup → 👥 Admins). Yaygın 4xx kodları: 401/403 (operatör tarafı kimlik bilgileri), 402 (krediler tükendi), 429 (hız sınırlı — bot geri çekilme ile yeniden dener).
Bir destek talebine ne dahil edilmeli
Bu şablonu kopyalayıp yapıştırın:
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.
Beklenen yanıt süreleri
- Kritik: bot platform genelinde çevrimdışı, faturalandırma hataları → AB+ABD mesai saati çakışmasında 1 iş saati içinde yanıt
- Yüksek: tek bir sohbet için rapor gelmiyor → aynı iş günü
- Normal: özellik soruları, yapılandırma yardımı → 1–2 iş günü
Yararlı bağlantılar
- Telegram botu: @BWS_X_Bot
- Herkese açık gösterge paneli: xbot.ninja
- Dokümantasyon: /docs/
- GitHub sorunları: blockchain-web-services/bws-api-telegram-xbot
- Doğrudan destek: bws.ninja — iletişim formu BWS geliştirici desteğine yönlendirir
Desteğe başvurmadan önce Sorun Giderme kendi kendine tanılama akışını çalıştırın — çoğu sorun ilk iki kontrolde çözülür.