Das /setup-Menü: Vollständiger Leitfaden zur Telegram-Oberfläche von X Bot

Der schnellste Weg, X Bot zu konfigurieren, ist das interaktive /setup-Menü. Es verpackt jeden Admin-Befehl in eine anklickbare, inline bearbeitbare Oberfläche — keine Slash-Befehle zum Auswendiglernen.

Schnellster Weg: füge den Bot zu deiner Gruppe hinzu, tippe /setup, tippe auf 🚀 Quick Start und folge vier Eingabeaufforderungen. Du hast in weniger als zwei Minuten einen täglichen Report-Zeitplan mit einem echten Filter laufen.

So sieht /setup aus

╔══════════════════════════════════════════════╗
║ ⚙️  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 ]                                  ║
╚══════════════════════════════════════════════╝

Jeder Bildschirm zeigt oben deinen aktuellen Zustand an, damit du weißt, was konfiguriert ist, bevor du etwas änderst. Jede Änderung wird sofort in der Datenbank gespeichert — es gibt keinen „Speichern"-Button, den man vergessen könnte.

Quick-Start-Assistent

Tippe auf 🚀 Quick Start für einen vierstufigen linearen Ablauf, der einen frischen Chat von „nichts konfiguriert" zu „erster geplanter Report" mit der minimalen Anzahl an Eingabeaufforderungen bringt. Überspringen und Beenden sind immer verfügbar — ein teilweise abgeschlossener Assistent blockiert dich nie, Einstellungen bleiben einfach bei ihren Standardwerten.

Die vier Schritte:

Schritt	Fragt	Speichert in
1	Projektname	Einstellung ProjectName (verwendet in Reports, Leaderboard-Karten, Admin-DMs)
2	Was auf X verfolgt werden soll — Accounts, Cashtags oder Keywords	Das Array from, cashtags oder keywords des Standardfilters
3	Wann der tägliche Report gepostet werden soll — 4 Voreinstellungen oder benutzerdefiniertes HH:MM	Ein an deinen Chat gebundener geplanter Job
4	Fertig — Zusammenfassungsbildschirm mit /recreate-Hinweis zur Sofortvorschau	(keine)

Das vollständige Menü

Jeder Hauptbutton öffnet einen fokussierten Bildschirm. Blättere frei durch — jeder Bildschirm hat ← Zurück zur vorherigen Ebene und ✕ Schließen zum Verwerfen.

🎯 Filter

Welche X-Posts der Bot bei jedem geplanten Lauf abruft.

Tippe auf eine Kategorie, um tiefer zu gehen. Ausschlüsse ist checkbox-artig — ein Tippen schaltet „Retweets / Antworten / Zitat-Tweets ausschließen" um.

Benannte Filter (fortgeschritten) erlaubt es dir, mehrere Filter gleichzeitig im selben Chat laufen zu lassen — nützlich, wenn du mehrere Kunden in einer Gruppe verwaltest. Jeder benannte Filter hat seinen eigenen Lösch-Button pro Zeile mit einem Bestätigungs-Tap. Tippe auf ➕ Benannten Filter hinzufügen, um eine einzeilige Definition über das Menü zu senden (name from:@x keywords:y cashtags:$Z mention:@m exclude:retweet ignore:@spam). Mindestens eines von from / keywords / cashtags / mention wird benötigt.

Ein Kategorie-Bildschirm sieht so aus — kurze Beschreibung, was die Kategorie tut, der aktuelle Wert und Hinzufügen / Entfernen / Alle löschen-Aktionen:

Wenn du auf ➕ Hinzufügen tippst, wechselt das Menü in den Eingabemodus — tippe deine Antwort als normale Nachricht ein, und der Bildschirm aktualisiert sich automatisch mit einem Bestätigungsbanner („✓ 2 Cashtags hinzugefügt: $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]

⏰ Zeitplan

Wann der Bot läuft und den täglichen Report postet.

Vier tägliche Voreinstellungen decken die meisten Communities ab. Die aktuell aktive Voreinstellung erhält ein ✓-Präfix in ihrem Label. Benutzerdefinierte Zeit fragt nach HH:MM. Bestimmte Tage akzeptiert 14:30 Mon Wed Fri. Cron akzeptiert Standard-Cron-Ausdrücke (z. B. cron(0 12 ? * MON-FRI *)). Der Bot erzwingt eine Mindestfrequenz von 12 Stunden, um die Kosten vorhersehbar zu halten.

Wenn du eine Zeitplan-Voreinstellung in einem Chat ohne Filter antippst, lehnt das Menü mit einem freundlichen Fehler ab, der auf 🎯 Filter zurückverweist — der Bot plant keinen Chat, der nichts zum Abrufen hat.

📊 Reports & Zeitraum

📊 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]

Zeitraum festlegen grenzt Reports auf ein bestimmtes Fenster ein (z. B. einen einwöchigen Wettbewerb). Format DD/MM/YYYY Ntage oder Nwochen. Zeitraum löschen kehrt zum Standard des rollierenden 24h-Fensters zurück. Report jetzt generieren löst dieselbe Step Function aus, die der Cron verwendet — nützlich für sofortige Vorschauen. Letzten Report anzeigen verweist auf /report (das das zuletzt zwischengespeicherte Bild kostenlos erneut postet).

🎨 Anpassung

Projekt-Metadaten, die in Reports und im öffentlichen Leaderboard erscheinen.

🎨 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]

Der Leaderboard-Unterbaum bietet:

Einstellung	Format
🏆 Punkte	Fünf Zahlen, durch Leerzeichen getrennt: likes retweets replies quotes views (z. B. 5 1 20 10 0.01)
🎨 Farben	Fünf Hex-Farben, gleiche Reihenfolge
🔢 Top-Anzahl	Ganze Zahl 1..10 — wie viele Nutzer im Leaderboard erscheinen
📛 Top-Titel	Freitext. Optionales |#hex-Suffix legt eine benutzerdefinierte Farbe fest (z. B. Top contributors|#FF8800)
🥇 Best-Tweet-Titel	Gleich
📊 Engagement-Titel	Gleich

Logo-Uploads verwenden den bestehenden Foto-Handler des Bots — tippe auf 🖼 Logo, dann sende das Bild als Telegram-Foto (nicht als Datei). Der Bot skaliert es und lädt es auf das Website-CDN hoch.

Thema weist dich an, /set_topic aus dem gewünschten Forum-Thema heraus zu senden. Das Menü kann message_thread_id nicht aus einem Callback-Button erfassen, daher bleibt dies eine Slash-Befehl-Oberfläche.

👥 Admins & Benachrichtigungen

Listet die Nutzer auf, die die Chats für private DMs über Credit-Erschöpfung, Abruffehler und Chat-nicht-gefunden-Warnungen bestimmt haben. Admins hinzuzufügen erfordert weiterhin /add_admin @user1 @user2 aus dem Chat — Telegrams @-Erwähnungs-Parser feuert nur bei echten Nachrichten, nicht bei Callbacks.

👥 Admins & Notifications

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

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

[🗑 Clear notification list]

💳 Credits & Plan kaufen

Plan- und Guthabenanzeige sowie die Buttons, die den Kauf- und Verwaltungsablauf steuern. Der Bildschirm wird je nach aktuellem Plan des Chats unterschiedlich gerendert:

FREE-Chat:

💳 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-Abo-Chat:

💳 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-Credits-Chat (ETH-gekauft):

💳 Buy Credits & Plan

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

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

Der Button 💰 Credits kaufen / upgraden postet eine Zahlungsoptionen-Karte unterhalb des Menüs. Die vom Bot angebotenen Optionen hängen vom aktuellen Plan ab:

• FREE → sowohl 💳 Mit Kreditkarte bezahlen (Stripe-Abo) als auch 🪙 Mit ETH bezahlen (Credit-Paket).
• PRO-Credits → beide Optionen werden angezeigt. ETH füllt das bestehende Guthaben auf; Stripe legt ein Abo obendrauf (bestehende ETH-Credits bleiben und werden pro Abruf zuerst verbraucht).
• PRO-Abo → keine Kaufoptionen. Der Bot antwortet mit einer „Abo existiert bereits"-Nachricht und verweist auf 🛠 Verwalten zum Stripe-Portal.

Der Button 🛠 Abo verwalten öffnet das Stripe-Kundenportal in deinem Browser — dort aktualisierst du deine Karte, kündigst oder lädst Rechnungen herunter. Nur sinnvoll, wenn du ein aktives Stripe-Abo hast.

Der Unterbildschirm 📊 Nutzung diesen Monat schlüsselt fetched_posts und fetch_attempts für den aktuellen Monat und heute auf — nützlich, um stille Fehler zu erkennen (viele Versuche, null Posts → wahrscheinlich 402er oder leere Abfragen) und um deine nächste Stripe-Rechnung vorherzusehen, wenn du dich der 1.000-Post-Schwelle näherst.

Kaufen + Verwalten sind auch über die veralteten Slash-Befehle /buy und /subscription erreichbar. Das Verhalten ist identisch; die Menü-Buttons ersparen dir nur das Tippen.

📡 X-Posts-Auto-Relay

Leitet Posts von ausgewählten X-Accounts an den Chat weiter, sobald sie veröffentlicht werden — getrennt vom geplanten Report. Nützlich, wenn ein Projekt möchte, dass Community-Admins offizielle Account-Tweets in Echtzeit sehen, ohne X zu prüfen.

📡 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 ]

Jedes Relay fragt alle 5 Minuten über die X API ab. Neue Posts (seit der letzten erfolgreichen Weiterleitung) werden als reine URLs in den Chat gepusht — Telegram rendert die X-Vorschaukarte automatisch, sodass der Post-Inhalt sichtbar ist.

Bildschirm zur Verwaltung pro Relay erlaubt dem Betreiber, das Verhalten anzupassen:

📡 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 ]

Einstellung	Was sie tut
Obergrenze (1–100/Tag)	Maximale Weiterleitungen pro Chat pro UTC-Tag — bei Erreichen stoppt das Relay die Weiterleitung stillschweigend bis Mitternacht UTC. Standard 10.
Pause / Fortsetzen	Deaktiviert den Abrufplan für dieses Relay; das Wiederherstellen erstellt ihn sofort neu.
Retweets	Wenn ✅, werden Retweets des weitergeleiteten Accounts weitergeleitet. Standard aus.
Antworten	Wenn ✅, werden Antworten an andere Nutzer weitergeleitet. Standard aus.
Zitat-Tweets	Wenn ✅, werden Zitat-Tweets weitergeleitet. Standard an.
Thread-Fortsetzungen	Wenn ✅, werden Selbstantworten (ein Nutzer antwortet auf seine eigenen Tweets) weitergeleitet — deckt Twitter-Threads ab. Standard an. Schalte dies aus, wenn du nur den Anfang jedes Threads willst.
Thema	Optionale Telegram-Forum-Themen-ID. Wenn gesetzt, postet das Relay nur in dieses Thema statt in den Hauptthread.

Automatische Bereinigung: Wenn Telegram einen „Chat verschwunden"-Fehler zurückgibt (Bot wurde entfernt / blockiert), entfernt das Relay automatisch seinen Abrufplan und die gespeicherte Konfiguration. Kein Leck.

Harte Grenze: 10 Relays pro Chat. Passe die zugrunde liegende Konstante an, falls du mehr brauchst.

ℹ️ Über

ℹ️ About this chat

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

Ein Diagnose-Panel für Support-Anfragen.

Wie sich /setup zu Slash-Befehlen verhält

/setup ist additiv — jeder bestehende Slash-Befehl funktioniert weiterhin genau wie zuvor. Das Menü verpackt dieselben Primitiven (buildQueryFromComponents, saveXBotSetting, createScheduleRule usw.), sodass das Verhalten zwischen den beiden Oberflächen identisch ist. Power-User können weiterhin /add_keywords DeFi airdrop für Muskelgedächtnis-Geschwindigkeit eingeben; Neulinge erhalten eine freundliche anklickbare Oberfläche.

Drei Befehle können grundsätzlich nicht in Menü-Buttons verschoben werden, weil sie Klartext + Telegram-Nachrichten-Entitäts-Kontext benötigen, den Callbacks nicht mitbringen:

Befehl	Warum er bleibt
/set_topic [name]	Erfasst die message_thread_id des Themas, in dem die Nachricht gesendet wurde — ein Button hat keinen Thread-Kontext
/add_admin @user	Verlässt sich auf Telegrams verifizierte Erwähnungs-Entitäten zur Chat-Admin-Verifizierung
/set_x_filtering	Veralteter Slash-Befehl zum Hinzufügen eines benannten Filters; das ⤴ Benannte Filter → ➕ Benannten Filter hinzufügen des Menüs tut dasselbe

Konfigurationsrezepte

Häufige Ziele → exakte Menüpfade. Jedes Rezept dauert ein bis zwei Minuten Klicken.

„Nur Original-Posts verfolgen (keine Retweets, keine Antworten)"

Die meisten Communities wollen, dass das Leaderboard originale Inhalte belohnt, nicht Re-Shares.

/setup → 🎯 Filter → 🚫 Ausschlüsse → tippe auf Retweets und Antworten, sodass beide ✅ zeigen. Fertig. Zukünftige Abrufe senden -is:retweet -is:reply an die X API, und Zitat-Tweets bleiben enthalten.

„Antworten stärker belohnen als Likes (Community-Aufbau)"

Standardpunkte: Likes 1×, Retweets 2×, Antworten 1,5×, Zitate 3×, Views 0,001. Um das Gespräch zu bevorzugen:

/setup → 🎨 Anpassung → 📈 Leaderboard-Anpassung → 🏆 Punkte → sende:

1 1 5 3 0.001

Antworten wiegen jetzt 5× — substanzielle Diskussion überholt beiläufige Likes.

„Reports zweimal am Tag ausführen"

Der Zeitplan feuert standardmäßig höchstens einmal pro Tag. Um einen End-of-EU- und End-of-US-Report zu erhalten:

/setup → ⏰ Zeitplan → 🔧 Cron-Ausdruck → sende:

cron(0 14,22 ? * * *)

Zwei Auslösungen/Tag um 14:00 + 22:00 UTC. Die Mindestfrequenzprüfung von 12 Stunden erzwingt automatisch ≥ 12h Abstand — engere Fenster werden mit einer klaren Fehlermeldung abgelehnt.

„Mehrere Kampagnen gleichzeitig in einer Gruppe verfolgen"

Drei gleichzeitige Kundenkampagnen, eine Telegram-Gruppe, ein Report pro Kampagne pro Auslösung.

/setup → 🎯 Filter → ⤴ Benannte Filter → ➕ Benannten Filter hinzufügen, dann sende bei jedem Durchgang eines davon:

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

Jede feuert nach demselben Zeitplan und postet einen separaten, mit dem Filternamen gekennzeichneten Report.

„Die Tweets eines Accounts in Echtzeit weiterleiten, zwischen Reports"

Große Neuigkeiten von @MyTokenOfficial sollten nicht auf den 22:00-UTC-Report warten müssen.

/setup → 📡 X-Posts-Auto-Relay → ➕ Account hinzufügen → sende:

@MyTokenOfficial 5

(Optionale 5 ist die tägliche Obergrenze; Standard 10.) Der Bot fragt alle 5 Minuten ab, leitet die URL bei einem frischen Post weiter, Telegram rendert die Vorschaukarte.

„Reports auf ein Kampagnenfenster beschränken (z. B. 7-tägiger Push)"

Willst nicht, dass Vor-Kampagnen-Rauschen das Leaderboard verunreinigt.

/setup → 📊 Reports → 📆 Zeitraum festlegen → sende:

01/05/2026 7days

Reports rufen jetzt Posts strikt innerhalb dieses Fensters ab. 🗑 Zeitraum löschen kehrt zum rollierenden 24h-Fenster zurück.

„Reports in ein Forum-Thema posten lassen, nicht in den Hauptthread"

Die Gruppe nutzt Themen; Reports sollen in einem eigenen Reports-Thema landen.

Öffne das Reports-Thema, sende dann aus diesem heraus:

/set_topic Reports

Zukünftige Reports werden in dieses Thema geleitet. Zum Zurücksetzen: /set_topic clear von überall in der Gruppe.

„Zwei bestimmte Admins benachrichtigen, wenn Credits ausgehen"

Der Bot schickt designierten Admins DMs bei Credit-/Abruf-/Chat-verschwunden-Fehlern. Standardmäßig fällt er auf alle Chat-Admins zurück — grenze auf eine kuratierte Liste ein.

/add_admin @alice @bob

DMs gehen jetzt nur an @alice und @bob. Zum Löschen: /setup → 👥 Admins → 🗑 Benachrichtigungsliste löschen.

„Den Chat vom öffentlichen xbot.ninja-Showcase verbergen"

Solo-KOL-Portfolios werden automatisch verborgen (einzelner Nutzer erfüllt die Regel ≥ 2 aktive Nutzer nicht). Für Community-Projekte, die privat bleiben sollen:

Es gibt keinen expliziten Verbergen-Umschalter — das öffentliche Listing wird durch Kennzahlen-Schwellenwerte gesteuert. Zwei Wege, um privat zu bleiben:

• Betreibe einen kleinen / ruhigen Chat, der die Schwellenwerte nicht erreicht (Top-Nutzer-Punktzahl < 300, Posts < 5/Monat, oder aktive Nutzer < 2).
• Kontaktiere den Support, um den Chat als ausgenommen zu markieren — das öffentliche Dashboard überspringt ihn unabhängig von den Kennzahlen.

Die direkte URL des Chats (https://xbot.ninja/?chatId=…) bleibt unabhängig davon zugänglich. Teile sie nur mit Personen, die die Daten sehen sollen.

Häufige Stolperfallen

Symptom	Grund	Lösung
Zeitplan „abgelehnt" mit FREQUENCY_ERROR	Cron versucht, öfter als alle 12h zu feuern	Abstandsprüfung — wähle mindestens 12-Stunden-Lücken. Die Fehlermeldung nennt das betroffene Stundenpaar.
/setup erscheint nicht in der Autovervollständigung	BotFather-Befehlsliste veraltet	Der Bot akzeptiert /setup unabhängig von der Autovervollständigung. Aktualisiere BotFather → /setcommands, falls Auffindbarkeit wichtig ist.
Filter-Vorschau zeigt leere Klammern / seltsame Abfrage	Eine Komponente ist leer	/setup → 🎯 Filter zeigt die wörtliche Abfrage. Füge mindestens eines von Accounts / Cashtags / Keywords / Erwähnungen hinzu.
X-Posts-Auto-Relay leitet einen ganzen Thread auf einmal weiter	Selbstantworten umgehen das exclude=replies der X API	/setup → 📡 X-Posts-Auto-Relay → @account → ☐ Thread-Fortsetzungen ausschalten. Der Bot behält dann nur den Thread-Anfang.
Tägliche Obergrenze erreicht, aber ich will mehr	MAX_POSTS_PER_DAY für Relay erreicht	Tippe auf ✏️ Obergrenze und erhöhe sie. Jeder weitergeleitete Post zählt als ein Credit.
Benutzerdefinierter Titel / Farbe über Nacht zurückgesetzt	Einstellungsaktualisierung hat funktioniert, aber UPDATED_AT-Bump hat den Render-Cache invalidiert; der nächste Abruf zeigt den neuen Wert	Warte einen Report-Zyklus. Der Render-Cache baut sich beim nächsten Abruf neu auf.
Report zeigt überall „0 Posts"	Keine Posts entsprachen dem Filter im konfigurierten Zeitraum	Entferne den Zeitraum (rollierende 24h sind nachsichtiger), oder erweitere die Filter. Oft ist es ein Tippfehler in einem Cashtag.
Bot „online", aber Reports kommen nicht mehr an	Bot wurde stillschweigend vom Admin herabgestuft / entfernt	Prüfe Telegram → Gruppen-Admins. Befördere ihn erneut, falls er fehlt. Der Bot deaktiviert sich selbst bei Chat-verschwunden-Fehlern.

Fertig

Der letzte Bildschirm des Assistenten fasst alles Gespeicherte zusammen und verweist auf /setup → 📊 Reports → ⚡ Report jetzt generieren für eine sofortige Vorschau:

Das war die ganze Tour. Tippe /setup in deiner Gruppe, um zu beginnen.

Probleme bei der Konfiguration eines Menüpunkts? Siehe Fehlerbehebung für Symptom-zu-Lösung-Matrizen zu Filtern, Zeitplänen und Abrechnung.