X Bot サポート：トラブルシューティング、FAQ、お問い合わせガイド
ほとんどの問題は /setup の操作1つで解決します。このページの前半ではセルフ診断フローを、後半では FAQ を紹介します。どちらでも解決しない場合は、ページ下部のお問い合わせフォームが BWS の開発者サポートチャンネルに直接つながります。
まず — セルフ診断フロー
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.If none of those land you on a fix, scroll past the FAQ to the contact link.
FAQ
セットアップとインストール
Q. ボットを追加しても応答がありません。 「メンバー」ではなく 管理者 に昇格されているか確認してください。Telegram → グループ設定 → 管理者。再昇格は即座に反映され、ボットの再インストールは不要です。
Q. ボットを別のグループに移動できますか？ はい — 新しいグループに追加し、そこで /setup を実行してください。2つのチャットは独立しています（チャット ID が異なる = 設定、スケジュール、スコアも異なります）。チャット間でのデータ移行はありません。
Q. ボットはメインスレッドにレポートしますが、私のグループにはトピックがあります — リダイレクトできますか？ 希望のフォーラムトピック内から次を送信してください：
/set_topic Reports以降のレポートはそのトピックに送られます。/set_topic clear でリセットできます。
Q. アンインストールするにはどうすればいいですか？
- まずレポートを停止：
/setup→ ⏰ スケジュール → ✕ スケジュールを無効化。 - ボットを削除：Telegram → グループ → 管理者 →
@BWS_X_Botをキック。 - 設定はデータベースに残ります。同じチャット ID にボットを再追加すればすべて再開します。完全な削除を希望する場合はサポートにお問い合わせください。
レポートとフィルタリング
Q. なぜサードパーティ製トラッカーと数値が異なるのですか？ X Bot は公式 X API から直接データを取得します。ほとんどのサードパーティ製トラッカーはスクレイピングや推定に頼っています — 20〜50%の誤差を計測しています。X API の数値が正しい基準です。
Q. リーダーボードに追跡するつもりのなかったユーザーが表示されます。 フィルターは 加算的 です。チャットが $YOUR_TOKEN キャッシュタグを追跡している場合、あなたがリストしたアカウントだけでなく、そのキャッシュタグをツイートした人は誰でもランク付けされます。アカウント と キャッシュタグの両方を必須にするには、/set_x_filtering を使って from:@x cashtags:$YOUR_TOKEN の形式を使用してください（名前付きフィルターの「すべて AND」の意味論）。
Q. レポートに「0投稿」と表示されます — どうすればいいですか？ 可能性が高い順に3つあります：
- フィルターが狭すぎる —
/setup→ 🎯 フィルター で実際の X API クエリを確認できます。よくあるタイプミス：$BTC（末尾にスペース）vs$BTC。 - 期間が狭すぎる — カスタム期間を設定している場合、その期間外の投稿はカウントされません。
/setup→ 📊 レポート → 🗑 期間をクリア でローリング24時間に戻ります。 - 追跡しているアカウントが実際に24時間以内に話題に関連する投稿をしていない — フォールバックのシグナルとしてキャッシュタグやキーワードを追加してください。
Q. 非公開／保護された X アカウントを追跡できますか？ いいえ — X API は公開投稿のみを返します。
Q. 特定のユーザー（スパムボットなど）をチャットのリーダーボードから除外できますか？ はい：/setup → 🎯 フィルター → 🙈 無視リスト → ➕ 追加。リストされたハンドルは取得後の結果から除外されます。
Q. なぜ私のチャットは1日に複数回レポートが発火するのですか？ 複数回発火する cron（cron(0 14,22 ? * * *)）を設定しているか、同じスケジュールで複数の名前付きフィルターが稼働しています。各名前付きフィルターはそれぞれ独自のレポートを生成します。
Q. 「ベストツイート」の選出が奇妙に感じます。 AI セレクターは、最近選ばれていない中で最もエンゲージメントの高い投稿を選びます。結果が継続的に不自然に感じる場合は、サポートに連絡してください — プロンプトは調整可能です。
X 投稿自動リレー
Q. リレーが6件の投稿からなるスレッドを一度に転送しました。最初の1件だけが欲しかったのですが。 これは X API の exclude=replies が 他のユーザーへの リプライのみをフィルタリングするためです。セルフリプライ（スレッド継続）はこれをすり抜けます。/setup → 📡 X 投稿自動リレー → @account → ☐ スレッド継続 をオフに切り替えてください。ボットは各スレッドの先頭だけを保持するようになります。
Q. リレーが日中に転送を停止しました。 リレーごとの画面を確認してください — Today: 10/10 forwarded であれば、1日の上限に達しています。✏️ 上限 をタップして引き上げてください。上限は UTC の深夜0時に自動的にリセットされます。
Q. リレーが ⏸ 一時停止 と表示されますが、自分で一時停止したことはありません。 ボットは Telegram のチャット消失エラー（キック／ブロック／チャットのアップグレード）で自動的に一時停止し、ポーリングスケジュールを停止します。ボットを再追加する場合に備えて、/setup → 📡 X 投稿自動リレー にその行が表示されます。
請求とクレジット
Q. 「クレジット」とは正確には何ですか？ 1クレジット = X API から返される投稿1件。FREE チャットは月100の無料クレジットを取得し、PRO チャットは Stripe（サブスクリプション）または ETH（クレジットパック）で課金されます。
Q. クレジット残高はどこで確認できますか？/setup → 💳 クレジット購入。使用量／残量／リセット日が表示されます。
Q. 支払いを済ませたのに残高／プランが更新されません。
- Stripe パス（カードサブスクリプション）：webhook は通常数秒以内に PRO を有効化します。5分以上経っても
/setup→ 💳 クレジット購入 にPRO ✓が表示されない場合は、Stripe の領収書とチャット ID を添えてサポートに連絡してください。 - ETH パス（クレジットパック）：オンチェーンの確認には1〜3分かかることがあります。10分経ってもクレジットが表示されない場合は、トランザクションハッシュとチャット ID を添えてサポートに連絡してください。
Q. 同じチャットで Stripe サブスクリプションと ETH クレジットの両方を持てますか？ はい — 併用できます。サブスクリプションに登録した PRO・クレジットのチャットは既存の ETH 残高を維持し、取得ごとの課金はサブスクリプションの月間付与分が適用される前に、まず ETH クレジットを消費します。実際の効果として：5,000の ETH クレジットを持った状態でサブスクリプションに登録した場合、最初の5,000回の取得は Stripe にまったく触れません。それ以降の取得はサブスクリプションの月1,000件の付与分を使用し、それを超えた分は1投稿あたり0.02ドルの従量課金となります。ETH 残高は無期限です。
唯一の制約：すでに PRO・サブスクリプションのチャットは、現時点では同じ購入フローから新しい ETH パックを追加できません（購入コマンドがブロックします）。クレジットのみに戻したい場合は、まずサブスクリプションを解約してください。
Q. PRO・クレジットの残高がゼロになるとどうなりますか？ ライセンスは自動的に FREE にダウングレードします。ボットは、それも尽きるまで月100件の FREE 上限の下で取得を続けます。次に /setup → 💳 → 💰 購入 を実行すると、再び両方のパスが提示されます。
Q. クレジット残高はチャットごとですか、ユーザーごとですか？ チャットごとです。各 Telegram グループは独自のクレジットとライセンスを持ちます。
公開ダッシュボード
Q. プロジェクトが xbot.ninja に表示されません。当月中に 3つのしきい値すべてを満たす必要があります：
- 最高ユーザースコア ≥ 300
- 追跡対象投稿数 ≥ 5
- アクティブユーザー数 ≥ 2
最初の月がボトルネックになることが多いです。直接 URL https://xbot.ninja/?chatId=<your-id> はいずれにせよ機能します。
Q. チャット ID はどこで確認できますか？/setup → ℹ️ 情報。マイナス記号で始まる長い整数です。
Q. 公開の xbot.ninja カードをカスタマイズできますか？/setup → 🎨 カスタマイズ。名前、説明、ロゴ、URL を設定してください。カードは次回のレポートサイクルで更新されます。
X API の癖
Q. なぜ想定より古い投稿がカウントされることがあるのですか？ ボットは tweets/search/all（全文アーカイブエンドポイント）を使用します。期間を設定すると、ボットはその期間内であればいつの投稿でも取得できます。デフォルトはローリング24時間ですが、カスタム期間は過去にさかのぼって設定できます。
Q. 投稿がリレーに反映されるまで5分以上かかることがあります。 X 投稿自動リレーは5分ごとにポーリングします。遅延は最大でポーリング間隔1回分です（平均約2.5分／最悪ケースで約5分）。それに加えて、わずかな X API と Telegram の配信遅延があります。
Q. X API がエラーを返しました — 運営者には何が見えますか？ 内部のエラーカウンターが増加し、指定された管理者にプライベート DM が送られます（誰に送るかは /setup → 👥 管理者 で設定）。よくある 4xx コード：401/403（運営側の認証情報）、402（クレジット枯渇）、429（レート制限 — ボットはバックオフしながら再試行）。
サポートリクエストに含めるべき内容
以下のテンプレートをコピー＆ペーストしてください：
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>チャット ID だけでも、サポートのトリアージ情報の80%を提供できます — 必ず含めてください。
想定される応答時間
- クリティカル：ボットが全体的にオフライン、請求の失敗 → EU + 米国の営業時間の重複帯で1営業時間以内に応答
- 高：特定のチャットのレポートが届かない → 当日中
- 通常：機能に関する質問、設定サポート → 1〜2営業日
役立つリンク
- Telegram ボット： @BWS_X_Bot
- 公開ダッシュボード： xbot.ninja
- ドキュメント： /docs/
- GitHub issues： blockchain-web-services/bws-api-telegram-xbot
- 直接サポート： bws.ninja — お問い合わせフォームが BWS の開発者サポートにつながります
サポートに連絡する前に、トラブルシューティング のセルフ診断フローを試してください — ほとんどの問題は最初の2つのチェックで解決します。