Cài đặt

Thiết lập X Bot trong nhóm Telegram của bạn trong ba bước. Hầu hết các đội nhóm hoàn tất việc cài đặt trong chưa đầy ba phút; trình hướng dẫn sẽ lo phần việc nặng.

Cách nhanh nhất — @BWS_X_Bot → thêm vào nhóm → /setup → 🚀 Quick Start. Bốn bước nhắc tiếp theo là tất cả những gì bạn cần.

Chuẩn bị 5 mục này trước khi bắt đầu

Trước khi bắt đầu, hãy chuẩn bị sẵn:

Để xem hướng dẫn từng màn hình cho mọi tùy chọn bạn sẽ cấu hình bên dưới, xem Menu /setup.

Bạn cần	Lấy từ đâu
Một tài khoản Telegram	telegram.org
Quyền admin trên một nhóm Telegram	Tạo một nhóm nếu bạn chưa có: Telegram → New Group
Handle X, cashtag, hoặc từ khóa bạn muốn theo dõi	Ví dụ @your_username, $YOUR_TOKEN, "#YourCampaign"
(Tùy chọn) Logo dự án + danh sách URL	Cho khu trưng bày công khai xbot.ninja
(Tùy chọn) Múi giờ ưa thích	Lịch tính theo UTC; chọn một giờ UTC rơi vào lúc cộng đồng của bạn hoạt động nhiều nhất

Chưa chắc bạn cần gói nào? Xem Bảng giá — hầu hết các đội nhóm bắt đầu ở gói FREE (100 bài đăng/tháng) và nâng cấp sau.

Nếu bạn chưa chắc kịch bản nào phù hợp với mình, xem lướt qua 4 trường hợp sử dụng trên trang Tổng quan — chọn cái gần nhất và dùng gợi ý bộ lọc của nó ở bước 2 bên dưới.

Bước 1 — Thêm bot vào nhóm của bạn

1. Mở Telegram và tìm @BWS_X_Bot.
2. Thêm bot vào nhóm của bạn.
3. Nâng bot lên admin. Không cần quyền đặc biệt nào ngoài quyền admin mặc định (bot cần trạng thái admin chỉ để Telegram cho phép nó đọc tin nhắn nhóm và đăng báo cáo).

Nhóm, không phải DM

Các tính năng phân tích của bot chỉ chạy trong nhóm, không phải trong DM riêng tư. Nếu bạn bắt đầu DM với @BWS_X_Bot, bạn sẽ thấy /help và /buy hoạt động nhưng hầu hết menu cấu hình thì không.

Bước 2 — Chạy /setup

Trong nhóm của bạn, gõ:

/setup

Bot trả lời bằng một menu tương tác. Chạm 🚀 Quick Start để mở trình hướng dẫn bốn bước.

Trình hướng dẫn hỏi bốn câu theo thứ tự:

Bước	Câu hỏi	Ví dụ
1	Tên dự án	MyToken, KOL Campaign Q2, @your_username Performance
2	Theo dõi gì trên X	📢 Accounts + handle, 💵 Cashtags + mã ticker, hoặc 🔍 Keywords + cụm từ
3	Khi nào bot nên chạy	Chọn khung giờ mặc định hằng ngày (09:00 / 14:00 / 18:00 / 22:00 UTC) hoặc gửi giờ tùy chỉnh
4	Xong	Tóm tắt những gì đã lưu

Skip và Exit luôn khả dụng — một trình hướng dẫn hoàn thành một phần không bao giờ chặn bạn, cài đặt chỉ giữ nguyên giá trị mặc định.

Tại sao lại /setup? Nó gói mọi lệnh admin vào một giao diện có thể chạm, chỉnh sửa tại chỗ để bạn không phải nhớ lệnh. Cài đặt lưu ngay lập tức. Người dùng thành thạo vẫn có thể gõ lệnh gạch chéo trực tiếp — hai bề mặt tương đương và hành vi giống hệt nhau. Hướng dẫn đầy đủ: Menu /setup.

Bước 3 — Kiểm tra

Khi trình hướng dẫn hoàn tất, mở /setup → 📊 Reports → ⚡ Generate report now để gửi ngay một báo cáo (báo cáo theo lịch tiếp theo sẽ chạy vào thời điểm bạn đã chọn ở bước 2).

Bot đăng hình ảnh bảng xếp hạng vào nhóm trong khoảng ~1–3 phút. Các chat nhỏ hơn (vài tài khoản, khối lượng bài đăng thấp) hoàn tất nhanh hơn; các chat cộng đồng với hàng trăm bài đăng cần lấy có thể mất 2–3 phút.

Chờ lần chạy theo lịch đầu tiên

Sau khi chạy thủ công Generate report now, lần chạy tự động tiếp theo diễn ra vào giờ cron bạn đã cấu hình. Bạn sẽ nhận một báo cáo mỗi lần kích hoạt — không bị đăng trùng lặp.

Chi phí & tín dụng

X Bot dùng X API chính thức cho mọi lần lấy dữ liệu. Mỗi chat bắt đầu ở FREE; từ đó bạn có thể chọn một hoặc cả hai hướng trả phí:

Gói	Bạn trả gì	Bao gồm những gì
FREE	$0	100 bài đăng/tháng theo giới hạn cứng. Bot tạm dừng lấy dữ liệu ở mốc 100; đặt lại vào ngày 1 tháng sau.
Thuê bao PRO (Stripe)	$19/tháng + $0.02/bài đăng vượt quá 1.000/tháng (tính phí theo Stripe)	Tự động gia hạn. 1.000 bài đăng/tháng đầu tiên bao gồm như ngưỡng miễn phí (không phải số dư tín dụng — không có chuyển tiếp).
Tín dụng PRO (ETH)	$0.02/tín dụng, gói 1.000 / 2.000 / 3.000 / 4.000 / 5.000 / 10.000 / 50.000 / 100.000	Một lần. Tín dụng không bao giờ hết hạn. Cộng vào số dư hiện có.

Một chat có thể giữ cả PRO·sub và PRO·credits cùng lúc — tính phí theo từng lần lấy dữ liệu trừ tín dụng ETH trước, sau đó đến hạn mức hằng tháng của thuê bao, rồi đến phần vượt mức tính phí. Xem bảng giá để biết ma trận chuyển đổi gói đầy đủ và quy trình mua.

Gói + số dư luôn hiển thị tại /setup → 💳 Buy Credits. Các admin được chỉ định nhận DM Telegram khi tín dụng đạt 80% và lại khi cạn hoàn toàn.

Bước tiếp theo được khuyến nghị theo trường hợp sử dụng

Chọn hàng phù hợp với kịch bản của bạn, sau đó theo phần Tổng quan được liên kết để xem công thức đầy đủ:

Kịch bản	Thêm gì sau trình hướng dẫn	Chi tiết
Agency KOL theo dõi 5 KOL	Tinh chỉnh cashtag + hashtag chiến dịch, lịch 22:00 UTC	Trường hợp sử dụng 1
Dự án khuyến khích cộng đồng	Logo + URL trong 🎨 Customization cho thẻ xbot.ninja công khai	Trường hợp sử dụng 2
Hồ sơ KOL cá nhân	Ảnh chân dung cá nhân + URL LinkedIn trong Customization, chia sẻ URL xbot.ninja với khách hàng tiềm năng	Trường hợp sử dụng 3
Agency đa khách hàng	/setup → 🎯 Filters → ⤴ Named filters → ➕ Add named filter — một cho mỗi khách hàng	Trường hợp sử dụng 4
Nhận bài đăng tài khoản X theo thời gian thực	/setup → 📡 X Posts Auto-relay → ➕ Add account	Menu /setup

Những gì được cấu hình

Phần trong /setup	Bạn thiết lập gì	Tại sao quan trọng
🎯 Filters	Tài khoản, cashtag, từ khóa, mention cần theo dõi trên X	Xác định bài đăng nào bot lấy dữ liệu
⏰ Schedule	Thời điểm trong ngày cho báo cáo tự động	Bot chạy lấy dữ liệu + render theo lịch cron này
📊 Reports & Period	Khoảng thời gian tùy chọn (ví dụ khoảng thời gian một cuộc thi)	Giới hạn báo cáo trong một khoảng cụ thể
🎨 Customization	Tên dự án, mô tả, logo, URL, trọng số và màu sắc bảng xếp hạng	Thương hiệu cho hình ảnh báo cáo và khu trưng bày công khai xbot.ninja
👥 Admins	Ai nhận DM riêng tư về sự cố tín dụng / lấy dữ liệu	Khả năng quan sát vận hành
💳 Subscription	Gói, số dư tín dụng, điểm vào nâng cấp	Khả năng quan sát chi phí và thanh toán
📡 Auto-relay	Tài khoản X chuyển tiếp vào chat theo thời gian thực (mỗi 5 phút)	Cập nhật trực tiếp giữa các báo cáo theo lịch

Trưng bày công khai (tùy chọn)

Nếu dự án của bạn đáp ứng ngưỡng liệt kê công khai (≥ 300 điểm cao nhất, ≥ 5 bài đăng, ≥ 2 người dùng tích cực trong tháng hiện tại), nó sẽ xuất hiện trên xbot.ninja. Thêm metadata dự án dưới /setup → 🎨 Customization (Name, Description, Logo, URLs).

Thiết lập KOL cá nhân (một tài khoản) không vượt qua quy tắc "≥ 2 người dùng tích cực" và chỉ có thể truy cập tại URL trực tiếp — đó là chủ ý thiết kế.

Kiểm tra việc cài đặt

Hầu hết chẩn đoán hiển thị trực tiếp trong /setup (mỗi màn hình hiển thị trạng thái hiện tại của chat ở phía trên). Danh sách kiểm tra nhanh:

Kiểm tra	Cách làm
Bot là admin	Telegram → cài đặt nhóm → Administrators
Theo dõi đã được cấu hình	/setup → 🎯 Filters → xem danh sách tài khoản/cashtag/từ khóa
Bộ lọc hiển thị đúng	/setup → 🎯 Filters
Lịch đã được đặt	/setup (đầu menu hiển thị lịch hiện tại)
Tín dụng khả dụng	/setup → 💳 Buy Credits
Báo cáo thủ công hoạt động	/setup → 📊 Reports → ⚡ Generate report now

Báo cáo đầu tiên không xuất hiện — khắc phục sự cố

Nếu Generate report now không tạo ra bài đăng nào trong vòng 3 phút:

Triệu chứng	Nguyên nhân có thể	Cách khắc phục
Bot DM báo "no posts found"	Bộ lọc quá hẹp HOẶC không có bài đăng gần đây khớp	/setup → 🎯 Filters — kiểm tra chuỗi truy vấn X API xem có lỗi chính tả không. Thử nới rộng (bỏ khoảng thời gian nếu đã đặt).
Bot DM báo "credit exhausted"	Chat FREE đã đạt giới hạn 100/tháng	Chờ tháng sau, hoặc /setup → 💳 Buy Credits → 💰 Buy để đăng ký thuê bao / mua gói tín dụng
Không có gì xảy ra, không có DM	Bot không phải admin, HOẶC webhook đã dừng	Nâng lại bot lên admin. Nếu vẫn không có gì, liên hệ hỗ trợ.
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ợ — nhà cung cấp AI đôi khi có sự cố luân phiên
Lỗi "Unauthorized" / "Forbidden"	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

Tự chẩn đoán

/setup → ℹ️ About hiển thị chat ID, gói, và lịch trên một màn hình. Sao chép nội dung đó vào bất kỳ yêu cầu hỗ trợ nào — nó rút ngắn thời gian xử lý khoảng 80%.

Hỏi đáp — các câu hỏi cài đặt thường gặp

Hỏi. Tôi có thể cài bot trong một kênh Telegram (không phải nhóm) không? Không, chỉ nhóm và siêu nhóm. Kênh không cho phép ngữ cảnh trả lời tin nhắn, thứ mà luồng báo cáo sử dụng.

Hỏi. Tôi có thể chạy bot trong một nhóm dạng forum có topic không? Có. Dùng /set_topic từ bên trong topic bạn muốn báo cáo được đăng vào. Bot sẽ đăng vào topic đó từ đó về sau; nếu chưa đặt, nó đăng vào luồng chính.

Hỏi. Bot có cần quyền đọc tin nhắn nhóm của tôi không? Bot chỉ cần nhận tin nhắn lệnh (ví dụ /setup). Nó không đọc chat thông thường. Dữ liệu phía X đến từ X API chính thức, không phải từ tin nhắn Telegram của bạn.

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. Theo dõi một tài khoản được bảo vệ sẽ âm thầm trả về không có kết quả nào.

Hỏi. Xóa bot khỏi nhóm có xóa dữ liệu của tôi không? Không. Cài đặt, lịch sử, điểm số, và báo cáo vẫn còn trong cơ sở dữ liệu của bot. Nếu bạn thêm lại bot vào cùng chat ID, mọi thứ sẽ tiếp tục. Nếu bạn muốn xóa sạch hoàn toàn, hãy hỏi hỗ trợ.

Hỏi. Tôi có thể đổi tên dự án sau này không? Có — /setup → 🎨 Customization → 🏷 Name. Cập nhật báo cáo tiếp theo và slug URL xbot.ninja công khai.

Hỏi. Tại sao tôi thấy số bài đăng khác với [công cụ X]? 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 đã phát hiện chênh lệch 20–50% trên thực tế. Con số từ X API là nguồn chân lý.

Hỏi. Làm sao để hủy?

• Chat FREE: chỉ cần xóa bot khỏi nhóm.
• Thuê bao PRO: /setup → 💳 Buy Credits → 🛠 Manage subscription mở Stripe Customer Portal nơi bạn có thể hủy. Việc hủy có hiệu lực vào cuối kỳ thanh toán hiện tại.
• Tín dụng PRO (ETH): tín dụng không tự động gia hạn — chat tự hạ xuống FREE khi số dư về 0. Xóa bot bất cứ lúc nào.

Cần trợ giúp?

Xem Hỗ trợ, hoặc mở /setup → ℹ️ About trong chat của bạn để lấy thông tin chẩn đoán chia sẻ với đội ngũ.

Đọc Tổng quan X Bot để biết chi tiết đầy đủ về những gì mỗi đối tượng — dự án crypto, agency KOL, KOL cá nhân, nhà đầu tư — nhận được từ bot trước khi bạn bắt đầu thiết lập.