/setup Menüsü: X Bot'un Telegram Arayüzüne Tam Rehber

X Bot'u yapılandırmanın en hızlı yolu etkileşimli /setup menüsüdür. Her yönetici komutunu tıklanabilir, yerinde düzenlenebilir bir arayüzün arkasına sarar — ezberlenecek slash komutu yok.

En hızlı yol: botu grubunuza ekleyin, /setup yazın, 🚀 Quick Start'a dokunun ve dört istemi takip edin. İki dakikadan kısa sürede gerçek bir filtre üzerinde çalışan bir günlük rapor takviminiz olur.

/setup neye benziyor

╔══════════════════════════════════════════════╗
║ ⚙️  Bot Setup                                ║
║                                              ║
║ Pick a section. Settings save instantly.     ║
║                                              ║
║ Current state                                ║
║ ─ Project:  MyToken                          ║
║ ─ Filter:   3 keywords · 2 cashtags          ║
║ ─ Schedule: daily 18:00 UTC                  ║
║ ─ Plan:     FREE — 47/100 credits left       ║
╠══════════════════════════════════════════════╣
║ [ 🚀 Quick Start ]                           ║
║ [ 🎯 Filters     ] [ ⏰ Schedule       ]      ║
║ [ 📊 Reports     ] [ 🎨 Customization  ]      ║
║ [ 👥 Admins      ] [ 💳 Buy Credits   ]      ║
║ [ ℹ️  About       ]                          ║
║ [ ✕ Close ]                                  ║
╚══════════════════════════════════════════════╝

Her ekran, neyi değiştirmeden önce neyin yapılandırıldığını bilmeniz için üstte mevcut durumunuzu gösterir. Her değişiklik anında veritabanına kaydedilir — unutulacak bir "kaydet" düğmesi yoktur.

Quick Start sihirbazı

Taze bir sohbeti "hiçbir şey yapılandırılmamış" durumundan minimum sayıda istemle "ilk zamanlanmış rapor" durumuna getiren dört adımlı doğrusal bir akış için 🚀 Quick Start'a dokunun. Skip ve Exit her zaman kullanılabilir — kısmen tamamlanmış bir sihirbaz sizi asla engellemez, ayarlar yalnızca varsayılanlarında kalır.

Dört adım:

Adım	Sorar	Kaydedilir
1	Proje adı	ProjectName ayarı (raporlarda, liderlik tablosu kartlarında, yönetici DM'lerinde kullanılır)
2	X'te ne izleneceği — hesaplar, cashtag'ler veya anahtar kelimeler	Varsayılan filtrenin from, cashtags veya keywords dizisi
3	Günlük raporun ne zaman gönderileceği — 4 önayar saat veya özel HH:MM	Sohbetinize bağlı zamanlanmış bir iş
4	Bitti — şimdi önizlemek için /recreate ipucu içeren özet ekranı	(yok)

Tam menü

Her üst düzey düğme odaklanmış bir ekran açar. İstediğiniz kadar derinlemesine gidin — her ekranda önceki seviyeye dönmek için ← Back ve kapatmak için ✕ Close bulunur.

🎯 Filters

Botun her zamanlanmış çalışmada hangi X gönderilerini çektiği.

Derinlemesine gitmek için herhangi bir kategoriye dokunun. Excludes onay kutusu tarzındadır — bir dokunuş "retweet / yanıt / alıntı tweet hariç tut"u değiştirir.

Named filters (gelişmiş), aynı sohbette birden fazla filtreyi çalışır durumda tutmanızı sağlar — tek bir grupta birden fazla müşteriyi yönettiğinizde kullanışlıdır. Her adlandırılmış filtrenin onay dokunuşlu kendi satır bazlı sil düğmesi vardır. Menü üzerinden tek satırlık bir tanım göndermek için ➕ Add named filter'a dokunun (name from:@x keywords:y cashtags:$Z mention:@m exclude:retweet ignore:@spam). En az bir from / keywords / cashtags / mention gerekir.

Bir kategori ekranı şöyle görünür — kategorinin ne yaptığının kısa açıklaması, mevcut değer ve Add / Remove / Clear all eylemleri:

➕ Add'e dokunduğunuzda, menü giriş moduna geçer — yanıtınızı normal bir mesaj olarak yazın, ekran bir onay banner'ıyla otomatik olarak yeniden çizilir ("✓ Added 2 cashtags: $BTC, $ETH").

➕ Add cashtags

Send the cashtags to track, space-separated.
The $ is optional.

Example:  $BTC $ETH SOL

Type your reply as a normal message,
or tap Cancel to go back.

[✕ Cancel]

⏰ Schedule

Botun ne zaman çalıştığı ve günlük raporu gönderdiği.

Dört günlük önayar çoğu topluluğu kapsar. O anda aktif olan önayar, etiketinde bir ✓ öneki alır. Custom time, HH:MM sorar. Specific days, 14:30 Mon Wed Fri kabul eder. Cron, standart cron ifadelerini kabul eder (örn. cron(0 12 ? * MON-FRI *)). Bot, maliyetleri öngörülebilir tutmak için 12 saatlik minimum bir sıklık uygular.

Filtresi olmayan bir sohbette bir takvim önayarına dokunursanız, menü 🎯 Filters'a geri işaret eden dost bir hatayla reddeder — bot, çekecek hiçbir şeyi olmayan bir sohbeti zamanlamaz.

📊 Reports & Period

📊 Reports & Period

Period: 01/05/2026 7days
Start:  2026-05-01
End:    2026-05-07

The bot fetches X posts inside this window on
every scheduled run. Without a period
configured, the bot uses a rolling 24-hour
window.

[📆 Set period]   [🗑 Clear period]
[⚡ Generate report now]
[📰 Show last report]

Set period, raporları belirli bir pencereyle sınırlar (örn. bir hafta süren bir yarışma). Biçim DD/MM/YYYY Ndays veya Nweeks. Clear period, varsayılan kayan 24 saate döner. Generate report now, cron'un kullandığı aynı Step Function'ı tetikler — anlık önizlemeler için kullanışlıdır. Show last report, en son önbelleğe alınmış görseli sıfır kredi maliyetiyle yeniden gönderen /report'a işaret eder.

🎨 Customization

Raporlarda ve herkese açık liderlik tablosunda görünen proje meta verileri.

🎨 Customization

🏷 Name:        MyToken
✏️ Description: A community-driven DeFi project
📝 Long desc.:  (multi-paragraph project pitch…)
🖼 Logo:        ✓ uploaded
🔗 URLs:        2 URLs
💬 Topic:       Forum topic "Reports"

[🏷 Name]      [✏️ Description]
[📝 Long desc.][🖼 Logo]
[🔗 URLs]      [💬 Topic]
[📈 Leaderboard customization]

Leaderboard alt ağacı şunları sunar:

Ayar	Biçim
🏆 Points	Boşlukla ayrılmış beş sayı: likes retweets replies quotes views (örn. 5 1 20 10 0.01)
🎨 Colors	Aynı sırayla beş hex renk
🔢 Top count	Tam sayı 1..10 — liderlik tablosunda kaç kullanıcı olacağı
📛 Top title	Serbest metin. İsteğe bağlı |#hex soneki özel bir renk ayarlar (örn. Top contributors|#FF8800)
🥇 Best-tweet title	Aynı
📊 Engagement title	Aynı

Logo yüklemeleri botun mevcut fotoğraf işleyicisini kullanır — 🖼 Logo'ya dokunun, ardından görseli bir Telegram fotoğrafı olarak gönderin (dosya olarak değil). Bot yeniden boyutlandırır ve web sitesi CDN'ine yükler.

Topic, istediğiniz forum konusunun içinden /set_topic göndermenizi ister. Menü bir callback düğmesinden message_thread_id'yi yakalayamaz, bu yüzden bu bir slash komutu yüzeyi olarak kalır.

👥 Admins & Notifications

Kredi tükenmesi, çekim hataları ve sohbet-bulunamadı uyarıları hakkında özel DM almak üzere belirlenmiş kullanıcıları listeler. Yönetici eklemek yine de sohbetten /add_admin @user1 @user2 gerektirir — Telegram'ın @-bahsetme ayrıştırıcısı yalnızca gerçek mesajlarda tetiklenir, callback'lerde değil.

👥 Admins & Notifications

Currently:
  • Alice (@alice_admin)
  • Bob (@bob_dev)

To add admins, send /add_admin @user1 @user2
in this chat.

[🗑 Clear notification list]

💳 Buy Credits & Plan

Plan + bakiye görüntüsü, artı satın alma ve yönetme akışlarını süren düğmeler. Ekran, sohbetin mevcut planına bağlı olarak farklı render edilir:

FREE sohbet:

💳 Buy Credits & Plan

Plan: FREE
Used this month: 47 / 100
Remaining:        53
Resets: 2026-06-01

[💰 Buy credits / upgrade]   [🛠 Manage subscription]
[📊 Usage this month]

PRO abonelik sohbeti:

💳 Buy Credits & Plan

Plan: PRO (subscription) ✓
Unlimited fetching with Stripe metering above 1 000 / month free.

[💰 Buy credits / upgrade]   [🛠 Manage subscription]
[📊 Usage this month]

PRO kredi sohbeti (ETH ile satın alınmış):

💳 Buy Credits & Plan

Plan: PRO (credits)
Credits remaining: 4 152
Total purchased:   5 000

[💰 Buy credits / upgrade]   [🛠 Manage subscription]
[📊 Usage this month]

💰 Buy credits / upgrade düğmesi, menünün altında bir ödeme seçenekleri kartı gönderir. Botun sunduğu seçenekler mevcut plana bağlıdır:

• FREE → hem 💳 Pay with Credit Card (Stripe aboneliği) hem de 🪙 Pay with ETH (kredi paketi).
• PRO credits → her iki seçenek de gösterilir. ETH mevcut bakiyeyi tamamlar; Stripe üstüne bir abonelik katmanlar (mevcut ETH kredileri kalır ve çekim başına önce onlar harcanır).
• PRO subscription → satın alma seçeneği yok. Bot bir "abonelik zaten var" mesajıyla yanıt verir ve Stripe portalına gitmek için 🛠 Manage'e işaret eder.

🛠 Manage subscription düğmesi, tarayıcınızda Stripe Müşteri Portalı'nı açar — kartınızı güncellediğiniz, iptal ettiğiniz veya faturaları indirdiğiniz yer burasıdır. Yalnızca aktif bir Stripe aboneliğiniz varsa anlamlıdır.

📊 Usage this month alt ekranı, mevcut ay ve bugün için fetched_posts ve fetch_attempts'i ayırır — sessiz hataları tespit etmek (yüksek deneme, sıfır gönderi → muhtemelen 402 veya boş sorgular) ve 1.000 gönderi eşiğine yaklaşırken bir sonraki Stripe faturanızı önizlemek için kullanışlıdır.

Satın alma + yönetme, eski slash komutları /buy ve /subscription olarak da erişilebilir. Davranış aynıdır; menü düğmeleri sadece yazmaktan kurtarır.

📡 X Posts Auto-relay

Seçilen X hesaplarından gelen gönderileri yayınlandıkları anda sohbete iletir — zamanlanmış rapordan ayrı. Bir projenin, topluluk yöneticilerinin resmi hesap tweetlerini X'i kontrol etmeden gerçek zamanlı görmesini istediği durumlarda kullanışlıdır.

📡 X Posts Auto-relay

Forward posts from X accounts to this chat as soon
as they're published. Posts can take up to 5
minutes to appear here after the original was
posted on X.

3 active relays:
▶️ @MyTokenOfficial    (4/10 today)
▶️ @MyTokenCEO         (1/10 today)
⏸ @MyTokenSupport     (0/10 today)

[ ▶️ @MyTokenOfficial ]
[ ▶️ @MyTokenCEO ]
[ ⏸ @MyTokenSupport ]
[ ➕ Add Account ]

Her röle, X API üzerinden her 5 dakikada bir yoklama yapar. Yeni gönderiler (son başarılı iletimden bu yana) düz URL'ler olarak sohbete gönderilir — Telegram, X önizleme kartını otomatik olarak render eder, böylece gönderi metni görünür olur.

Röle başına yönetim ekranı, operatörün davranışı ayarlamasına izin verir:

📡 X Posts Auto-relay › @MyTokenOfficial

State: ▶️ Active
Today: 4/10 forwarded
Polls every: 5 min

Post types to forward
☐ Retweets
☐ Replies (to other users)
✅ Quote tweets
✅ Thread continuations (self-replies)

Topic: (default — top of chat)

[ ⏸ Pause ] [ ✏️ Cap: 10/day ]
[ ☐ Retweets ] [ ☐ Replies ]
[ ✅ Quote tweets ] [ ✅ Thread ]
[ 💬 Set topic ] [ 🧹 Clear topic ]
[ 🗑 Delete relay ]

Ayar	Ne yapar
Cap (1–100/gün)	Sohbet başına UTC gün başına maksimum iletim — ulaşıldığında, röle UTC gece yarısına kadar sessizce iletmeyi durdurur. Varsayılan 10.
Pause / Resume	Bu röle için yoklama zamanlamasını devre dışı bırakır; geri yükleme anında yeniden oluşturur.
Retweets	✅ olduğunda, iletilen hesabın retweetleri iletilir. Varsayılan kapalı.
Replies	✅ olduğunda, diğer kullanıcılara verilen yanıtlar iletilir. Varsayılan kapalı.
Quote tweets	✅ olduğunda, alıntı tweetler iletilir. Varsayılan açık.
Thread continuations	✅ olduğunda, kendi kendine yanıtlar (bir kullanıcının kendi tweetlerine yanıt vermesi) iletilir — Twitter thread'lerini kapsar. Varsayılan açık. Yalnızca her thread'in başını istiyorsanız bunu kapatın.
Topic	İsteğe bağlı Telegram forum-konu kimliği. Ayarlandığında, röle yalnızca ana akış yerine o konuya gönderim yapar.

Otomatik temizlik: Telegram bir "sohbet-yok" hatası döndürürse (bot atıldıysa / engellendiyse), röle yoklama zamanlamasını ve saklanan yapılandırmasını otomatik olarak kaldırır. Sızıntı yok.

Sabit sınır: sohbet başına 10 röle. Daha fazlasına ihtiyacınız varsa altta yatan sabiti ayarlayın.

ℹ️ About

ℹ️ About this chat

Chat ID: -1002593612414
Plan: PRO ✓
Schedule: daily 18:00 UTC
Project: MyToken

Destek talepleri için bir tanılama paneli.

/setup slash komutlarıyla nasıl ilişkilidir

/setup eklemelidir — mevcut her slash komutu tam olarak eskisi gibi çalışmaya devam eder. Menü aynı ilkelleri sarar (buildQueryFromComponents, saveXBotSetting, createScheduleRule vb.), bu yüzden iki arayüz arasında davranış aynıdır. Deneyimli kullanıcılar kas hafızası hızı için /add_keywords DeFi airdrop yazmaya devam edebilir; yeni gelenler dost canlısı, tıklanabilir bir arayüz elde eder.

Üç komut, callback'lerin taşımadığı düz metin + Telegram mesaj varlığı bağlamına ihtiyaç duyduklarından menü düğmelerine taşınamaz:

Komut	Neden kalıyor
/set_topic [name]	Mesajın gönderildiği konunun message_thread_id'sini yakalar — bir düğmenin thread bağlamı yoktur
/add_admin @user	Sohbet-yönetici doğrulaması için Telegram'ın doğrulanmış bahsetme varlıklarına dayanır
/set_x_filtering	Adlandırılmış bir filtre eklemek için eski slash komutu; menünün ⤴ Named filters → ➕ Add named filter aynısını yapar

Yapılandırma tarifleri

Yaygın hedefler → tam menü yolları. Her tarif bir veya iki dakikalık tıklamadır.

"Yalnızca özgün gönderileri izle (retweet yok, yanıt yok)"

Çoğu topluluk liderlik tablosunun yeniden paylaşımları değil özgün içeriği ödüllendirmesini ister.

/setup → 🎯 Filters → 🚫 Excludes → her ikisi de ✅ gösterecek şekilde Retweets ve Replies'e dokunun. Bu kadar. Gelecekteki çekimler X API'sine -is:retweet -is:reply gönderir ve alıntı tweetler kalır.

"Yanıtları beğenilerden daha çok ödüllendir (topluluk oluşturma)"

Varsayılan puanlar: beğeniler 1×, retweetler 2×, yanıtlar 1,5×, alıntılar 3×, görüntülemeler 0,001×. Sohbeti kayırmak için:

/setup → 🎨 Customization → 📈 Leaderboard customization → 🏆 Points → gönderin:

1 1 5 3 0.001

Yanıtlar artık 5× ağırlıklandırılır — içerikli tartışma anlık beğenileri geride bırakır.

"Raporları günde iki kez çalıştır"

Takvim varsayılan olarak günde en fazla bir kez tetiklenir. AB günü sonu ve ABD günü sonu raporu almak için:

/setup → ⏰ Schedule → 🔧 Cron expression → gönderin:

cron(0 14,22 ? * * *)

Günde 14:00 + 22:00 UTC'de iki tetikleme. 12 saatlik minimum sıklık kontrolü ≥ 12 saatlik aralığı otomatik olarak zorunlu kılar — daha dar pencereler net bir hatayla reddedilir.

"Tek bir grupta birden fazla kampanyayı eş zamanlı izle"

Üç eşzamanlı müşteri kampanyası, bir Telegram grubu, tetikleme başına kampanya başına bir rapor.

/setup → 🎯 Filters → ⤴ Named filters → ➕ Add named filter, ardından her geçişte bunlardan birini gönderin:

campaign_a from:@kol1,@kol2 keywords:"#CampaignALaunch"
campaign_b from:@kol3,@kol4,@kol5 cashtags:$CBT
campaign_c from:@kol6 mention:@CampaignC_Official

Her biri aynı takvimde tetiklenir ve filtre adıyla etiketlenmiş ayrı bir rapor gönderir.

"Raporlar arasında bir hesabın tweetlerini gerçek zamanlı ilet"

@MyTokenOfficial'den gelen büyük haberler 22:00 UTC raporunu beklememeli.

/setup → 📡 X Posts Auto-relay → ➕ Add Account → gönderin:

@MyTokenOfficial 5

(İsteğe bağlı 5 günlük üst sınırdır; varsayılan 10.) Bot her 5 dakikada bir yoklama yapar, taze bir gönderide URL'yi iletir, Telegram önizleme kartını render eder.

"Raporları bir kampanya penceresiyle sınırla (örn. 7 günlük bir push)"

Kampanya öncesi gürültünün liderlik tablosunu kirletmesini istemiyorsunuz.

/setup → 📊 Reports → 📆 Set period → gönderin:

01/05/2026 7days

Raporlar artık kesinlikle bu pencerenin içindeki gönderileri çeker. 🗑 Clear period kayan 24 saate döner.

"Raporların ana akış yerine bir forum konusuna gönderilmesini sağla"

Grup konu başlıkları kullanıyor; raporlar özel bir Reports konusuna inmelidir.

Reports konusunu açın, ardından içinden şunu gönderin:

/set_topic Reports

Gelecekteki raporlar o konuya yönlendirilir. Geri almak için: gruptaki herhangi bir yerden /set_topic clear.

"Krediler bittiğinde iki belirli yöneticiye bildirim gönder"

Bot, kredi / çekim / sohbet-yok hatalarında belirlenmiş yöneticilere DM gönderir. Varsayılan olarak tüm sohbet yöneticilerine geri döner — küratörlü bir listeye daraltın.

/add_admin @alice @bob

DM'ler artık yalnızca @alice ve @bob'a gider. Temizlemek için: /setup → 👥 Admins → 🗑 Clear notification list.

"Sohbeti herkese açık xbot.ninja vitrininden gizle"

Bağımsız KOL portföyleri otomatik olarak gizlenir (tek kullanıcı ≥ 2 aktif kullanıcı eşiğini geçemez). Özel kalması gereken topluluk projeleri için:

Açık bir gizleme anahtarı yoktur — herkese açık listeleme metrik eşikleriyle kapılıdır. Özel kalmanın iki yolu:

• Eşikleri karşılamayan küçük / sessiz bir sohbet çalıştırın (en yüksek kullanıcı puanı < 300, gönderiler < ayda 5 veya aktif kullanıcılar < 2).
• Sohbeti muaf olarak ayarlamak için desteğe başvurun — herkese açık gösterge paneli metriklerden bağımsız olarak atlar.

Sohbetin doğrudan URL'si (https://xbot.ninja/?chatId=…) her durumda erişilebilir kalır. Yalnızca verileri görmesi gereken kişilerle paylaşın.

Yaygın tuzaklar

Belirti	Neden	Çözüm
Takvim FREQUENCY_ERROR ile "reddedildi"	Cron her 12 saatten daha sık tetiklenmeye çalışıyor	Aralık kontrolü — en az 12 saatlik boşluklar seçin. Hata mesajı sorunlu saat çiftini adlandırır.
/setup otomatik tamamlamada görünmüyor	BotFather komut listesi güncel değil	Bot, otomatik tamamlamadan bağımsız olarak /setup'ı kabul eder. Keşfedilebilirlik önemliyse BotFather → /setcommands'ı güncelleyin.
Filtre önizlemesi boş parantez / garip sorgu gösteriyor	Bazı bileşenler boş	/setup → 🎯 Filters gerçek sorguyu gösterir. Hesap / cashtag / anahtar kelime / bahsetmelerden en az birini ekleyin.
X Posts Auto-relay bir thread'in tamamını bir kerede 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 thread başını tutar.
Günlük üst sınıra ulaşıldı ama daha fazlasını istiyorum	Röle için MAX_POSTS_PER_DAY'e ulaşıldı	✏️ Cap'e dokunun ve yükseltin. İletilen her gönderi bir kredi sayılır.
Özel başlık / renk gecede geri döndü	Ayar güncellemesi çalıştı ama UPDATED_AT artışı render önbelleğini geçersiz kıldı; bir sonraki çekim yeni değeri gösterir	Bir rapor döngüsü bekleyin. Render önbelleği bir sonraki çekimde yeniden oluşturulur.
Rapor her yerde "0 gönderi" gösteriyor	Yapılandırılan dönemde filtreye uyan gönderi yok	Dönemi bırakın (kayan 24 saat daha esnektir) veya filtreleri genişletin. Genellikle bir cashtag'de yazım hatasıdır.
Bot "çevrimiçi" ama raporlar gelmeyi durdurdu	Bot yöneticilikten indirildi / sessizce atıldı	Telegram → grup yöneticilerini kontrol edin. Eksikse yeniden yönetici yapın. Bot sohbet-yok hatalarında kendini devre dışı bırakır.

Bitti

Sihirbazın son ekranı kaydedilen her şeyi özetler ve anında bir önizleme için /setup → 📊 Reports → ⚡ Generate report now'a işaret eder:

İşte tam tur bu kadar. Grubunuzda başlamak için /setup yazın.

Bir menü öğesini yapılandırırken bir sorunla mı karşılaştınız? Filtreleri, takvimleri ve faturalandırmayı kapsayan belirti-çözüm matrisleri için Sorun Giderme sayfasına bakın.