Hỗ trợ X Bot: Khắc phục sự cố, hỏi đáp & hướng dẫn liên hệ

Hầu hết vấn đề tự khắc phục chỉ với một hành động /setup. Nửa đầu trang này hướng dẫn bạn qua luồng tự chẩn đoán; nửa sau là hỏi đáp. Nếu không cách nào giải quyết được, form liên hệ ở cuối trang định tuyến trực tiếp đến kênh hỗ trợ phát triển của BWS.

Đầu tiên — luồng tự chẩn đoán

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.

Nếu không có gì trong số đó giúp bạn đến cách khắc phục, cuộn qua hỏi đáp tới liên kết liên hệ.

Hỏi đáp

Cài đặt & thiết lập

Hỏi. Bot không phản hồi khi tôi thêm nó. Xác nhận nó đã được nâng lên admin, không chỉ "member". Telegram → cài đặt nhóm → Administrators. Việc nâng cấp là tức thì; bot không cần cài lại.

Hỏi. Tôi có thể chuyển bot sang nhóm khác không? Có — thêm nó vào nhóm mới, chạy /setup ở đó. Hai chat độc lập với nhau (chat ID khác nhau = cài đặt, lịch, điểm số khác nhau). Không có di chuyển dữ liệu giữa các chat.

Hỏi. Bot báo cáo ở luồng chính, nhưng nhóm của tôi có topic — tôi có thể chuyển hướng không? Từ bên trong topic forum mong muốn, gửi:

/set_topic Reports

Báo cáo tương lai sẽ vào topic đó. Đặt lại bằng /set_topic clear.

Hỏi. Làm sao để gỡ cài đặt?

• Dừng báo cáo trước: /setup → ⏰ Schedule → ✕ Disable schedule.
• Xóa bot: Telegram → nhóm → admin → kick @BWS_X_Bot.
• Cài đặt vẫn còn trong cơ sở dữ liệu. Thêm lại bot vào cùng chat ID sẽ khôi phục mọi thứ. Hỏi hỗ trợ để xóa cứng.

Báo cáo & lọc

Hỏi. Tại sao số liệu của tôi khác với các công cụ theo dõi bên thứ ba? X Bot lấy trực tiếp từ X API chính thức. Hầu hết công cụ theo dõi bên thứ ba scrape hoặc ước lượng — chúng tôi đã đo được chênh lệch 20–50%. Con số từ X API là nguồn chân lý.

Hỏi. Bảng xếp hạng hiển thị người dùng tôi không ngờ được theo dõi. Bộ lọc mang tính cộng dồn. Nếu một chat theo dõi cashtag $YOUR_TOKEN, bất kỳ ai tweet cashtag đó đều được xếp hạng, không chỉ các tài khoản bạn liệt kê. Để yêu cầu cả một tài khoản và một cashtag, dùng dạng from:@x cashtags:$YOUR_TOKEN qua /set_x_filtering (ngữ nghĩa AND-của-mọi-thứ của named filter).

Hỏi. Báo cáo hiện "0 posts" — giờ sao? Ba khả năng, theo thứ tự phổ biến:

1. Bộ lọc quá hẹp — /setup → 🎯 Filters hiển thị truy vấn X API thực tế. Lỗi thường gặp: $BTC (khoảng trắng cuối) so với $BTC.
2. Khoảng thời gian quá hẹp — nếu bạn đặt một khoảng thời gian tùy chỉnh, bài đăng ngoài khung đó không được tính. /setup → 📊 Reports → 🗑 Clear period trở về 24h cuộn.
3. Các tài khoản bạn theo dõi thực sự không đăng gì đúng chủ đề trong 24h — mở rộng bằng cashtag hoặc từ khóa dự phòng.

Hỏi. Tôi có thể theo dõi một tài khoản X riêng tư/được bảo vệ không? Không — X API chỉ trả về bài đăng công khai.

Hỏi. Tôi có thể loại bỏ những người dùng cụ thể khỏi bảng xếp hạng của một chat (ví dụ bot spam) không? Có: /setup → 🎯 Filters → 🙈 Ignore → ➕ Add. Các handle được liệt kê sẽ bị loại khỏi kết quả sau khi lấy dữ liệu.

Hỏi. Tại sao chat của tôi có nhiều lần kích hoạt báo cáo trong một ngày? Hoặc bạn đã đặt một cron nhiều lần (cron(0 14,22 ? * * *)) hoặc bạn có nhiều named filter chạy trên cùng lịch. Mỗi named filter tạo ra báo cáo riêng của nó.

Hỏi. Lựa chọn "Best Tweet" có vẻ kỳ lạ. Bộ chọn AI lấy bài đăng có tương tác cao nhất chưa được chọn gần đây. Nếu kết quả liên tục cảm thấy sai, liên hệ hỗ trợ — prompt có thể tinh chỉnh.

X Posts Auto-relay

Hỏi. Relay chuyển tiếp một thread 6 bài đăng cùng lúc. Tôi chỉ muốn bài đầu tiên. Đó là do exclude=replies của X API chỉ lọc reply tới người dùng khác; self-reply (thread continuation) bỏ qua nó. /setup → 📡 X Posts Auto-relay → @account → tắt ☐ Thread continuations. Bot khi đó chỉ giữ phần đầu của mỗi thread.

Hỏi. Relay dừng chuyển tiếp giữa ngày. Kiểm tra màn hình từng relay — nếu Today: 10/10 forwarded, bạn đã đạt giới hạn hằng ngày. Chạm ✏️ Cap để tăng. Giới hạn tự đặt lại vào nửa đêm UTC.

Hỏi. Relay hiển thị ⏸ Paused nhưng tôi chưa từng tạm dừng nó. Bot tự động tạm dừng khi phát hiện lỗi chat-gone của Telegram (bị kick / chặn / nhóm nâng cấp) và dừng lịch thăm dò. /setup → 📡 X Posts Auto-relay hiển thị dòng đó trong trường hợp bạn thêm lại bot.

Thanh toán & tín dụng

Hỏi. "Tín dụng" chính xác là gì? Một tín dụng = một bài đăng được X API trả về. Chat FREE có 100 tín dụng miễn phí/tháng; chat PRO được tính phí qua Stripe (thuê bao) hoặc ETH (gói tín dụng).

Hỏi. Tôi xem số dư tín dụng ở đâu?/setup → 💳 Buy Credits. Hiển thị đã dùng / còn lại / ngày đặt lại.

Hỏi. Tôi vừa thanh toán nhưng số dư / gói của tôi không cập nhật.

• Đường dẫn Stripe (thuê bao thẻ): webhook thường kích hoạt PRO trong vài giây. Nếu 5+ phút sau bạn vẫn không thấy PRO ✓ trong /setup → 💳 Buy Credits, liên hệ hỗ trợ kèm biên nhận Stripe và chat ID.
• Đường dẫn ETH (gói tín dụng): xác nhận on-chain có thể mất 1–3 phút. Nếu sau 10 phút tín dụng không hiển thị, liên hệ hỗ trợ kèm mã giao dịch và chat ID.

Hỏi. Tôi có thể có cả thuê bao Stripe VÀ tín dụng ETH trên cùng một chat không? Có — chúng kết hợp với nhau. Một chat PRO·credits đăng ký thuê bao vẫn giữ số dư ETH hiện có, và tính phí theo từng lần lấy dữ liệu trừ tín dụng ETH trước khi hạn mức hằng tháng của thuê bao kích hoạt. Hiệu ứng thực tế: nếu bạn có 5.000 tín dụng ETH và đăng ký thuê bao, 5.000 lần lấy dữ liệu đầu tiên không chạm vào Stripe; các lần tiếp theo dùng hạn mức 1.000/tháng của thuê bao; bất cứ điều gì vượt quá là $0.02/bài đăng tính phí theo mức sử dụng. Số dư ETH không bao giờ hết hạn.

Ràng buộc duy nhất: một chat đã ở PRO·sub không thể thêm gói ETH mới từ cùng luồng mua hôm nay (lệnh mua chặn điều này). Hủy thuê bao trước nếu bạn muốn chuyển lại về chỉ dùng tín dụng.

Hỏi. Điều gì xảy ra khi số dư PRO·credits của tôi về 0? Giấy phép tự động hạ xuống FREE. Bot tiếp tục lấy dữ liệu dưới giới hạn 100/tháng của FREE cho đến khi cạn kiệt. /setup → 💳 → 💰 Buy tiếp theo sẽ đưa ra cả hai đường dẫn một lần nữa.

Hỏi. Số dư tín dụng tính theo chat hay theo người dùng? Theo chat. Mỗi nhóm Telegram có tín dụng và giấy phép riêng.

Bảng điều khiển công khai

Hỏi. Dự án của tôi không hiển thị trên xbot.ninja. Ba ngưỡng phải đều được đáp ứng trong tháng hiện tại:

• Điểm người dùng cao nhất ≥ 300
• Bài đăng được theo dõi ≥ 5
• Người dùng tích cực ≥ 2

Tháng đầu tiên thường là điểm nghẽn. URL trực tiếp https://xbot.ninja/?chatId=<your-id> vẫn hoạt động bất kể.

Hỏi. Làm sao để tìm chat ID của tôi?/setup → ℹ️ About. Số nguyên dài có tiền tố âm.

Hỏi. Tôi có thể tùy chỉnh thẻ xbot.ninja công khai không?/setup → 🎨 Customization. Đặt Name, Description, Logo, URLs. Thẻ làm mới ở chu kỳ báo cáo tiếp theo.

Đặc thù của X API

Hỏi. Tại sao một số bài đăng cũ hơn dự kiến lại được tính? Bot dùng endpoint lưu trữ đầy đủ tweets/search/all. Khi bạn đặt một khoảng thời gian, bot có thể lấy bài đăng từ bất kỳ thời điểm nào trong đó. Mặc định là 24h cuộn, nhưng một khoảng thời gian tùy chỉnh có thể lùi về trước.

Hỏi. Đôi khi một bài đăng mất hơn 5 phút để xuất hiện trong relay. X Posts Auto-relay thăm dò mỗi 5 phút. Độ trễ lên tới một khoảng thăm dò (~2.5 phút trung bình / ~5 phút tệ nhất). Cộng thêm độ trễ ngắn của X API + gửi Telegram.

Hỏi. X API trả về lỗi — người vận hành thấy gì? Bộ đếm lỗi nội bộ tăng lên, admin được chỉ định nhận DM riêng tư (/setup → 👥 Admins để cấu hình ai). Mã lỗi 4xx thường gặp: 401/403 (thông tin xác thực phía vận hành), 402 (hết tín dụng), 429 (giới hạn tần suất — bot tự thử lại với backoff).

Nội dung cần đưa vào một yêu cầu hỗ trợ

Sao chép và dán mẫu này:

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>

Chỉ riêng chat ID đã cung cấp cho hỗ trợ 80% thông tin xử lý — vui lòng luôn kèm theo nó.

Thời gian phản hồi dự kiến

• Critical: bot ngừng hoạt động toàn nền tảng, lỗi thanh toán → phản hồi trong vòng 1 giờ làm việc trong khung trùng giờ làm việc EU+Mỹ
• High: báo cáo không được gửi cho một chat → trong cùng ngày làm việc
• Normal: câu hỏi về tính năng, trợ giúp cấu hình → 1–2 ngày làm việc

Liên kết hữu ích

• Bot Telegram: @BWS_X_Bot
• Bảng điều khiển công khai: xbot.ninja
• Tài liệu: /docs/
• GitHub issues: blockchain-web-services/bws-api-telegram-xbot
• Hỗ trợ trực tiếp: bws.ninja — form liên hệ định tuyến tới hỗ trợ phát triển của BWS

Trước khi liên hệ hỗ trợ, hãy chạy qua luồng tự chẩn đoán trong Khắc phục sự cố — hầu hết vấn đề được giải quyết ở hai kiểm tra đầu tiên.