Khắc phục sự cố X Bot: Báo cáo, bộ lọc, lịch, thanh toán
Một chỉ mục tổng hợp mọi hướng "có gì đó không ổn, giờ sao" . Các ma trận trong installation / setup-menu / support cũng nằm ở đây để bạn có thể tìm trên một trang thay vì ba.
Bắt đầu tại đây: mở
/setup→ ℹ️ About trong nhóm của bạn. Bốn dòng trên màn hình đó (chat ID, gói, lịch, tên dự án) là những gì hỗ trợ cần để xử lý. Sao chép chúng trước khi bạn làm bất cứ điều gì khác.
Luồng tự chẩn đoán
Chạy qua các câu hỏi này theo thứ tự. Hầu hết vấn đề được giải quyết ở một trong hai kiểm tra đầu tiên.
1. Does the bot reply to /setup at all?
├─ No → bot was kicked or demoted from admin → re-promote and retry
└─ Yes → continue.
2. Does /setup → 📊 Reports → ⚡ Generate report now produce a post
within 3 minutes?
├─ No DM, no post → check matrix in §"Reports not arriving"
├─ DM "no posts found" → see §"Filter / no posts"
├─ DM "credit exhausted" → see §"Billing & credits"
├─ Post landed but renders wrong → see §"Render quality"
└─ Post landed correctly → you're fine.
3. Are scheduled reports arriving on time?
├─ No → see §"Schedule not firing"
└─ Yes → all good.
4. X Posts Auto-relay issues?
└─ See §"X Posts Auto-relay"Nếu không có ma trận nào bên dưới giúp bạn đến được cách khắc phục, cuộn xuống Escalation.
Báo cáo không đến
| Triệu chứng | Nguyên nhân có thể | Cách khắc phục |
|---|---|---|
| Bot hoạt động trước đó, bỗng nhiên im lặng | Bot bị hạ khỏi admin / bị kick âm thầm | Telegram → admin nhóm → nâng lại. Nếu vẫn im lặng, liên hệ hỗ trợ — có thể tự vô hiệu hóa khi phát hiện chat-gone đã kích hoạt. |
| Generate-now thủ công không tạo ra gì | Bot là admin nhưng hết tín dụng | /setup → 💳 Buy Credits. Nếu FREE "100/100 used" — chờ đặt lại hằng tháng (ngày 1 mỗi tháng theo UTC). Nếu PRO·credits với REMAINING=0 — chat đã tự hạ xuống FREE; /setup → 💳 → 💰 Buy để nạp thêm. |
| Generate-now thủ công: DM admin báo "no posts found" | Bộ lọc quá hẹp HOẶC không có bài đăng trong khung thời gian | /setup → 🎯 Filters. Kiểm tra chuỗi truy vấn X API xem có lỗi chính tả. Thử nới rộng hoặc bỏ khoảng thời gian. |
| Hình ảnh render nhưng nội dung trống | AI commentary hết thời gian chờ | Chạy lại; tạm thời. Nếu vẫn tiếp diễn = liên hệ hỗ trợ. |
| Hình ảnh không render được hoàn toàn | Trục trặc render tạm thời | Chạy lại. Nếu liên tục lỗi cho một chat, liên hệ hỗ trợ kèm chat ID. |
| Lỗi "Unauthorized" / "Forbidden" trong DM admin | Sự cố token X API (phía vận hành) | Liên hệ hỗ trợ; không có gì người dùng có thể tự khắc phục. |
Bộ lọc / không có bài đăng
| Triệu chứng | Nguyên nhân có thể | Cách khắc phục |
|---|---|---|
| Báo cáo hiển thị "0 posts" ở mọi nơi | Bộ lọc không khớp gì trong khoảng thời gian đã cấu hình | Bước 1: /setup → 🎯 Filters — xác nhận truy vấn. Bước 2: /setup → 📊 Reports → 🗑 Clear period (24h cuộn khoan dung hơn). Bước 3: nới rộng bộ lọc (thêm một cashtag dự phòng, bỏ nhóm từ khóa nghiêm ngặt). |
| Bảng xếp hạng hiển thị người dùng tôi không thêm vào bộ lọc | Bộ lọc mang tính cộng dồn — bất kỳ ai tweet một cashtag/từ khóa được theo dõi đều được tính | Để yêu cầu cả một tài khoản và một cashtag, dùng /set_x_filtering name from:@x cashtags:$Y (named filter, AND-của-các-danh-mục). |
| Cùng một người dùng spam bảng xếp hạng | Bot chấm điểm hợp lệ cho mọi bài đăng | /setup → 🎯 Filters → 🙈 Ignore → ➕ Add @spammer — họ bị loại khỏi kết quả sau khi lấy dữ liệu. |
| Cashtag với ký tự lạ không khớp | X API chuẩn hóa chữ hoa/thường; khoảng trắng đầu/cuối quan trọng trong dữ liệu nhập bộ lọc | Thêm lại qua /setup → 🎯 Filters → 💵 Cashtags → ➕ Add → không cần $, không khoảng trắng. |
Cashtag bắt đầu bằng số (ví dụ $1INCH) không được theo dõi | Hành vi tìm kiếm của X API với số ở đầu có thể không nhất quán | Dùng như một từ khóa thay vì cashtag: "$1INCH" trong 🔍 Keywords kèm dấu ngoặc kép. |
| Lựa chọn "Best Tweet" có vẻ không đúng | Việc khử trùng lặp bằng AI gần đây đã chọn một tweet tương tự | Chờ một chu kỳ. Nếu vẫn cảm thấy sai kéo dài = báo cáo lại; prompt có thể tinh chỉnh. |
Lịch không kích hoạt
| Triệu chứng | Nguyên nhân có thể | Cách khắc phục |
|---|---|---|
Lịch "bị từ chối" với FREQUENCY_ERROR | Cron cố kích hoạt thường xuyên hơn mỗi 12h | Kiểm tra khoảng cách áp dụng khoảng cách ≥ 12h. Thông báo lỗi nêu tên cặp giờ vi phạm. Chọn khoảng cách rộng hơn. |
| Lịch đã đặt, nhưng báo cáo không đến đúng giờ | Cron theo lịch kích hoạt trong khoảng ~1–2 phút của mốc giờ | Chờ 5 phút sau giờ đã cấu hình trước khi cho rằng đã bỏ lỡ. Độ trễ thượng nguồn hiếm gặp xảy ra nhưng tự giải quyết. |
| Cron nhiều lần chỉ kích hoạt một lần | Danh sách giờ không theo thứ tự hoặc trùng lặp | cron(0 14,22 ? * * *) — giờ tăng dần. cron(0 22,14 ? * * *) bị từ chối. |
| Lịch trên staging kích hoạt mỗi 5 phút, prod thì không | Namespace RULE_NAME khác nhau | Xác nhận bạn đang kiểm tra đúng môi trường. /setup → ℹ️ About hiển thị env. |
| Múi giờ có vẻ sai | Lịch tính theo UTC theo thiết kế | Chuyển giờ địa phương của bạn sang UTC. Dữ liệu nhập đặt-lịch cũng chấp nhận múi giờ có tên trong một số trường hợp đặc biệt — kiểm tra docstring của mục nhập. |
| X Posts Auto-relay kích hoạt nhưng báo cáo thì không | Lịch cron khác nhau | X Posts Auto-relay dùng thăm dò 5 phút mỗi relay; báo cáo dùng lịch cron chính của chat (thường là hằng ngày). Chúng độc lập với nhau. |
Chất lượng render
| Triệu chứng | Nguyên nhân có thể | Cách khắc phục |
|---|---|---|
| Tiêu đề / màu tùy chỉnh trở lại như cũ qua đêm | Cache mất hiệu lực, lần lấy dữ liệu tiếp theo hiển thị giá trị mới | Chờ một chu kỳ báo cáo (~1 ngày). Cache render sẽ xây lại ở lần lấy dữ liệu tiếp theo. |
| Logo mờ / bị cắt | Ảnh nguồn quá nhỏ hoặc không vuông | Tải lại ở ≥ 512×512 PNG, tỷ lệ vuông. /setup → 🎨 Customization → 🖼 Logo. |
| Tên hiển thị bị tràn trong hình ảnh bảng xếp hạng | Tên hiển thị dài | Bot tự cắt ngắn với dấu chấm lửng; không cần khắc phục trừ khi lặp lại. |
Văn bản best-tweet hiển thị HTML thô <a href> | Chế độ phân tích Telegram không khớp | Lỗi — vui lòng báo cáo kèm URL tweet. |
| Hình ảnh báo cáo khác với bản xem trước Telegram | Telegram lưu cache byte ảnh đầu tiên theo URL; URL presigned có timestamp nên mỗi lần lấy là duy nhất | Không nên xảy ra; nếu có, xoay vòng qua /recreate. |
X Posts Auto-relay
| Triệu chứng | Nguyên nhân có thể | Cách khắc phục |
|---|---|---|
| Relay chuyển tiếp cả một thread 6 tweet cùng lúc | Self-reply bỏ qua exclude=replies của X API | /setup → 📡 X Posts Auto-relay → @account → tắt ☐ Thread continuations. Bot khi đó chỉ giữ phần đầu. |
| Relay dừng giữa ngày | Đạt giới hạn hằng ngày | Màn hình từng relay hiển thị Today: N/N forwarded. Chạm ✏️ Cap và tăng. Đặt lại vào nửa đêm UTC. |
| Relay hiển thị ⏸ Paused nhưng tôi chưa từng tạm dừng nó | Tự động tạm dừng khi phát hiện chat-gone của Telegram (bị kick / chặn / nhóm nâng cấp) | Bot cũng đã dừng lịch thăm dò. Để khôi phục: /setup → 📡 X Posts Auto-relay → @account → ▶️ Resume. Nếu vẫn lỗi, có thể chat đã đổi ID (nâng cấp super-group) — thêm lại bot vào chat mới. |
| Lần thăm dò đầu tiên của relay chuyển tiếp 50 bài đăng | Bootstrap không nên làm vậy — chỉ nên gieo LAST_POST_ID mà không chuyển tiếp | Nếu bạn thấy điều này, vui lòng báo cáo. Bản sửa lỗi thêm vào tháng 4/2026 lẽ ra đã ngăn chặn điều này. |
| Quote tweet vẫn xuất hiện dù đã bật công tắc | X API không có exclude=quotes phía server — bot lọc phía client sau khi lấy dữ liệu | Công tắc vẫn hoạt động, nhưng bạn vẫn trả phí cho quote tweet được API trả về. Chỉ tiết kiệm về mặt hiển thị. |
| Relay tiếp tục thăm dò mãi dù chat đã bị xóa | Phiên bản relay cũ — tự dọn dẹp được thêm vào tháng 5/2026 | Nhờ hỗ trợ buộc dừng relay. Các bản triển khai mới tự dọn dẹp. |
Thanh toán & tín dụng
| Triệu chứng | Nguyên nhân có thể | Cách khắc phục |
|---|---|---|
| Đã mua tín dụng, số dư không đổi | Webhook Stripe bị trễ | Chờ 5 phút. Nếu vẫn sai, liên hệ hỗ trợ kèm biên nhận Stripe + chat ID. |
| Số tín dụng cao hơn tôi mong đợi | Một relay thăm dò nhiều lần trong khoảng thời gian tài khoản được theo dõi hoạt động | X Posts Auto-relay tính phí theo bài đăng. Chạm vào relay → kiểm tra bộ đếm Today. |
| Tính phí vượt mức trên PRO·sub dù tôi đăng ít | Mức sử dụng khác trên chat (relay, báo cáo, thử lại lấy dữ liệu) | /setup → 💳 Buy Credits → Usage this month. So sánh với khoản phí theo mức sử dụng. |
| Chat FREE bị tính phí | Không nên xảy ra — FREE không có khách hàng Stripe | Báo cáo ngay lập tức; đây là lỗi thanh toán. |
| Thuê bao hiển thị "canceled" nhưng tôi không hủy | Việc hủy Stripe có thể được kích hoạt bởi tự động gia hạn thẻ thất bại | Kiểm tra email biên nhận Stripe, cập nhật thẻ qua /setup → 💳 → 🛠 Manage subscription (Stripe Customer Portal). |
| Đã hủy thuê bao, vẫn là PRO | Hủy-vào-cuối-kỳ: PRO đến hết kỳ đã thanh toán | Đúng như dự kiến. Trở về FREE vào cuối chu kỳ thanh toán tiếp theo. |
Bảng điều khiển công khai
| Triệu chứng | Nguyên nhân có thể | Cách khắc phục |
|---|---|---|
| Dự án không xuất hiện trên xbot.ninja | Không đạt ngưỡng (≥ 300 điểm cao nhất, ≥ 5 bài đăng, ≥ 2 người dùng tích cực tháng này) | URL trực tiếp vẫn hoạt động. Chờ chỉ số đạt ngưỡng. Thiết lập KOL cá nhân bị ẩn khỏi khu trưng bày theo chủ ý. |
| Dự án trên xbot.ninja nhưng thiếu logo | Logo chưa từng được tải lên, hoặc tải lên thất bại | /setup → 🎨 Customization → 🖼 Logo. Gửi một ảnh PNG vuông. |
| URL công khai hiển thị tên dự án cũ | Làm mới ở chu kỳ báo cáo tiếp theo | Đổi tên qua /setup → 🎨 Customization → 🏷 Name. Slug URL + thẻ sẽ làm mới khi báo cáo tiếp theo kích hoạt. |
| URL báo lỗi 404 | Chat đã bị xóa cứng, HOẶC chưa đạt ngưỡng nên khu trưng bày ẩn nó | Xác nhận chat ID qua /setup → ℹ️ About. Kiểm tra URL trực tiếp https://xbot.ninja/?chatId=<id>. |
Escalation
Khi các ma trận trên không giải quyết được, liên hệ hỗ trợ với mẫu bên dưới.
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ó.
Gửi đến đâu:
- Hỗ trợ chung: form liên hệ bws.ninja
- GitHub issues (dành cho người quen mã nguồn mở): bws-api-telegram-xbot/issues
- Telegram trực tiếp: @BlockchainWebServices
Thời gian phản hồi theo mức độ nghiêm trọng:
- Critical (bot ngừng hoạt động toàn nền tảng, lỗi thanh toán): 1 giờ làm việc trong khung trùng giờ làm việc EU+Mỹ
- High (báo cáo của một chat không được gửi): 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
Các lệnh chẩn đoán hữu ích
| Lệnh | Hiển thị gì |
|---|---|
/setup → ℹ️ About | Chat ID, gói, lịch, dự án — sao chép nguyên văn vào yêu cầu hỗ trợ |
/setup → 🎯 Filters | Chuỗi truy vấn X API thực tế |
/setup → 💳 Buy Credits → 📊 Usage this month | Bộ đếm fetched_posts hằng ngày + hằng tháng — phát hiện lỗi âm thầm (nhiều lần thử, không có bài đăng nào → có thể là lỗi 402) |
/setup → 📡 X Posts Auto-relay → @account | Trạng thái từng relay (hoạt động / tạm dừng, số lần chuyển tiếp hôm nay, giới hạn hằng ngày) |
/get_chatid | Chỉ chat ID (dòng lệnh nhanh nếu About là quá nhiều) |
Bước tiếp theo
- Cài đặt — cài đặt lại sạch nếu mọi cách khác thất bại
- Menu /setup — tham chiếu menu đầy đủ
- Bảng giá — khắc phục sự cố phía thanh toán
- Hỗ trợ — hỏi đáp + liên hệ leo thang