X Bot Support: Fehlerbehebung, FAQ & Kontaktleitfaden

Die meisten Probleme lösen sich mit einer einzigen /setup-Aktion von selbst. Die erste Hälfte dieser Seite führt dich durch den Selbstdiagnose-Ablauf; die zweite Hälfte ist eine FAQ. Falls keines von beidem hilft, führt das Kontaktformular am Ende direkt zum BWS-Entwickler-Support-Kanal.

Zuerst — Selbstdiagnose-Ablauf

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.

Wenn dich nichts davon zu einer Lösung führt, scrolle über die FAQ hinaus zum Kontaktlink.

FAQ

Einrichtung & Installation

F. Der Bot antwortet nicht, wenn ich ihn hinzufüge. Bestätige, dass er zum Admin befördert ist, nicht nur „Mitglied". Telegram → Gruppeneinstellungen → Administratoren. Die erneute Beförderung ist sofort wirksam; der Bot muss nicht neu installiert werden.

F. Kann ich den Bot in eine andere Gruppe verschieben? Ja — füge ihn der neuen Gruppe hinzu, führe dort /setup aus. Die beiden Chats sind unabhängig (unterschiedliche Chat-IDs = unterschiedliche Einstellungen, Zeitpläne, Punktzahlen). Es gibt keine Datenmigration zwischen Chats.

F. Der Bot postet Reports im Hauptthread, aber meine Gruppe hat Themen — kann ich das umleiten? Sende aus dem gewünschten Forum-Thema heraus:

/set_topic Reports

Zukünftige Reports werden in dieses Thema geleitet. Mit /set_topic clear zurücksetzen.

F. Wie deinstalliere ich?

• Reports zuerst stoppen: /setup → ⏰ Zeitplan → ✕ Zeitplan deaktivieren.
• Bot entfernen: Telegram → Gruppe → Admins → @BWS_X_Bot entfernen.
• Einstellungen bleiben in der Datenbank. Das erneute Hinzufügen des Bots zur selben Chat-ID setzt alles fort. Für eine endgültige Löschung den Support fragen.

Reports & Filterung

F. Warum unterscheiden sich meine Zahlen von Drittanbieter-Trackern? X Bot bezieht Daten direkt von der offiziellen X API. Die meisten Drittanbieter-Tracker scrapen oder extrapolieren — wir haben Abweichungen von 20–50 % gemessen. Die X-API-Zahl ist die Quelle der Wahrheit.

F. Das Leaderboard zeigt Nutzer, die ich nicht erwartet hatte. Filter sind additiv. Wenn ein Chat das Cashtag $YOUR_TOKEN verfolgt, wird jeder, der dieses Cashtag twittert, eingestuft, nicht nur die von dir aufgelisteten Accounts. Um sowohl einen Account als auch ein Cashtag zu verlangen, nutze die Form from:@x cashtags:$YOUR_TOKEN über /set_x_filtering (die UND-von-allem-Semantik benannter Filter).

F. Der Report sagt „0 Posts" — was jetzt? Drei Möglichkeiten, nach Wahrscheinlichkeit geordnet:

1. Filter zu eng — /setup → 🎯 Filter zeigt die wörtliche X-API-Abfrage. Häufiger Tippfehler: $BTC (nachgestelltes Leerzeichen) statt $BTC.
2. Zeitraum zu eng — falls du einen benutzerdefinierten Zeitraum gesetzt hast, zählen Posts außerhalb dieses Fensters nicht. /setup → 📊 Reports → 🗑 Zeitraum löschen kehrt zum rollierenden 24h-Fenster zurück.
3. Die verfolgten Accounts haben wirklich nichts Themenbezogenes in 24h gepostet — mit Cashtags oder Keywords als Fallback-Signal erweitern.

F. Kann ich einen privaten/geschützten X-Account verfolgen? Nein — die X API gibt nur öffentliche Posts zurück.

F. Kann ich bestimmte Nutzer vom Leaderboard eines Chats ausschließen (z. B. Spam-Bots)? Ja: /setup → 🎯 Filter → 🙈 Ignorieren → ➕ Hinzufügen. Aufgelistete Handles werden nach dem Abruf aus den Ergebnissen entfernt.

F. Warum hat mein Chat mehrere Report-Auslösungen pro Tag? Entweder hast du einen Mehrfach-Feuer-Cron gesetzt (cron(0 14,22 ? * * *)) oder du hast mehrere benannte Filter, die nach demselben Zeitplan laufen. Jeder benannte Filter erzeugt seinen eigenen Report.

F. Die „Best Tweet"-Auswahl wirkt seltsam. Der KI-Selektor wählt den Post mit dem höchsten Engagement, der nicht kürzlich ausgewählt wurde. Falls die Ergebnisse durchgehend daneben wirken, den Support kontaktieren — der Prompt ist anpassbar.

X-Posts-Auto-Relay

F. Das Relay hat einen Thread von 6 Posts auf einmal weitergeleitet. Ich wollte nur den ersten. Das liegt daran, dass das exclude=replies der X API nur Antworten an andere Nutzer filtert; Selbstantworten (Thread-Fortsetzungen) umgehen es. /setup → 📡 X-Posts-Auto-Relay → @account → ☐ Thread-Fortsetzungen ausschalten. Der Bot behält dann nur den Anfang jedes Threads.

F. Das Relay hat mitten am Tag aufgehört weiterzuleiten. Prüfe den Pro-Relay-Bildschirm — falls Today: 10/10 forwarded, hast du die tägliche Obergrenze erreicht. Tippe auf ✏️ Obergrenze zum Erhöhen. Setzt sich um Mitternacht UTC automatisch zurück.

F. Das Relay zeigt ⏸ Pausiert, aber ich habe es nie pausiert. Der Bot pausiert automatisch bei Telegram-Chat-verschwunden-Fehlern (entfernt / blockiert / Chat upgegradet) und stoppt den Abrufplan. /setup → 📡 X-Posts-Auto-Relay zeigt die Zeile, falls du den Bot erneut hinzufügst.

Abrechnung & Credits

F. Was genau ist ein „Credit"? Ein Credit = ein von der X API zurückgegebener Post. FREE-Chats erhalten 100 kostenlose Credits/Monat; PRO-Chats werden über Stripe (Abo) oder ETH (Credit-Paket) abgerechnet.

F. Wo sehe ich mein Credit-Guthaben?/setup → 💳 Credits kaufen. Zeigt verwendet / verbleibend / Reset-Datum.

F. Ich habe gerade bezahlt, aber mein Guthaben / Plan wurde nicht aktualisiert.

• Stripe-Weg (Kartenabo): Der Webhook aktiviert PRO normalerweise innerhalb von Sekunden. Wenn du 5+ Minuten später kein PRO ✓ in /setup → 💳 Credits kaufen siehst, den Support mit deinem Stripe-Beleg und der Chat-ID kontaktieren.
• ETH-Weg (Credit-Paket): Die On-Chain-Bestätigung kann 1–3 Minuten dauern. Wenn nach 10 Minuten Credits nicht erscheinen, den Support mit dem Transaktions-Hash und der Chat-ID kontaktieren.

F. Kann ich sowohl ein Stripe-Abo ALS AUCH ETH-Credits im selben Chat haben? Ja — sie schichten sich übereinander. Ein PRO·Credits-Chat, der abonniert, behält sein bestehendes ETH-Guthaben, und die Abrechnung pro Abruf verbraucht zuerst ETH-Credits, bevor das monatliche Kontingent des Abos greift. Praktischer Effekt: wenn du 5.000 ETH-Credits hast und abonnierst, berühren die ersten 5.000 Abrufe Stripe überhaupt nicht; nachfolgende Abrufe nutzen das 1.000/Monat-Kontingent des Abos; alles darüber hinaus wird mit 0,02 $/Post abgerechnet. Das ETH-Guthaben läuft nie ab.

Die eine Einschränkung: ein Chat, der bereits auf PRO·Abo ist, kann heute kein frisches ETH-Paket über denselben Kaufablauf hinzufügen (der Kaufbefehl blockiert es). Kündige zuerst das Abo, wenn du zurück zu reiner Credit-Abrechnung wechseln willst.

F. Was passiert, wenn mein PRO·Credits-Guthaben auf null fällt? Die Lizenz wird automatisch auf FREE herabgestuft. Der Bot ruft weiterhin unter der 100/Monat-FREE-Obergrenze ab, bis auch diese aufgebraucht ist. Das nächste /setup → 💳 → 💰 Kaufen bietet dann wieder beide Wege an.

F. Ist das Credit-Guthaben pro Chat oder pro Nutzer? Pro Chat. Jede Telegram-Gruppe hat ihre eigenen Credits und ihre eigene Lizenz.

Öffentliches Dashboard

F. Mein Projekt erscheint nicht auf xbot.ninja. Drei Schwellenwerte müssen im aktuellen Monat alle erfüllt sein:

• Top-Nutzer-Punktzahl ≥ 300
• Verfolgte Posts ≥ 5
• Aktive Nutzer ≥ 2

Der erste Monat ist normalerweise der Engpass. Die direkte URL https://xbot.ninja/?chatId=<deine-id> funktioniert unabhängig davon.

F. Wie finde ich meine Chat-ID?/setup → ℹ️ Über. Die negativ-präfixierte lange Ganzzahl.

F. Kann ich die öffentliche xbot.ninja-Karte anpassen?/setup → 🎨 Anpassung. Name, Beschreibung, Logo, URLs festlegen. Die Karte aktualisiert sich beim nächsten Report-Zyklus.

X-API-Eigenheiten

F. Warum werden manche Posts älter gezählt als erwartet? Der Bot nutzt tweets/search/all (Vollarchiv-Endpunkt). Wenn du einen Zeitraum festlegst, kann der Bot Posts aus jedem Zeitpunkt innerhalb dieses Zeitraums abrufen. Der Standard ist rollierende 24h, aber ein benutzerdefinierter Zeitraum kann rückdatiert sein.

F. Manchmal braucht ein Post 5+ Minuten, um in einem Relay zu erscheinen. X-Posts-Auto-Relay fragt alle 5 Minuten ab. Die Latenz beträgt bis zu einem Abfrageintervall (~2,5 Min. durchschnittlich / ~5 Min. im schlechtesten Fall). Plus kurze X-API- und Telegram-Zustellungslatenz.

F. Die X API hat einen Fehler zurückgegeben — was sieht der Betreiber? Interne Fehlerzähler steigen, designierte Admins erhalten eine private DM (/setup → 👥 Admins zur Konfiguration, wer). Häufige 4xx-Codes: 401/403 (betreiberseitige Zugangsdaten), 402 (Credits aufgebraucht), 429 (Rate-Limit — Bot wiederholt mit Backoff).

Was in eine Support-Anfrage gehört

Kopiere und füge diese Vorlage ein:

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>

Die Chat-ID allein gibt dem Support 80 % der Triage-Informationen — bitte immer angeben.

Erwartete Antwortzeiten

• Kritisch: Bot plattformweit offline, Abrechnungsfehler → Antwort innerhalb 1 Geschäftsstunde während der EU+US-Geschäftszeit-Überlappung
• Hoch: Report wird für einen einzelnen Chat nicht zugestellt → am selben Geschäftstag
• Normal: Funktionsfragen, Konfigurationshilfe → 1–2 Geschäftstage

Nützliche Links

• Telegram-Bot: @BWS_X_Bot
• Öffentliches Dashboard: xbot.ninja
• Dokumentation: /docs/
• GitHub-Issues: blockchain-web-services/bws-api-telegram-xbot
• Direkter Support: bws.ninja — Kontaktformular leitet zum BWS-Entwickler-Support weiter

Bevor du den Support kontaktierst, gehe den Fehlerbehebung-Selbstdiagnose-Ablauf durch — die meisten Probleme lösen sich bei den ersten zwei Prüfungen.