Menu /setup: Hướng dẫn đầy đủ giao diện Telegram của X Bot

Cách nhanh nhất để cấu hình X Bot là menu tương tác /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ỗ — không cần nhớ lệnh gạch chéo nào.

Cách nhanh nhất: thêm bot vào nhóm của bạn, gõ /setup, chạm 🚀 Quick Start, và làm theo bốn bước nhắc. Bạn sẽ có một lịch báo cáo hằng ngày chạy trên bộ lọc thực trong chưa đầy hai phút.

/setup trông như thế nào

╔══════════════════════════════════════════════╗
║ ⚙️  Bot Setup                                ║
║                                              ║
║ Pick a section. Settings save instantly.     ║
║                                              ║
║ Current state                                ║
║ ─ Project:  MyToken                          ║
║ ─ Filter:   3 keywords · 2 cashtags          ║
║ ─ Schedule: daily 18:00 UTC                  ║
║ ─ Plan:     FREE — 47/100 credits left       ║
╠══════════════════════════════════════════════╣
║ [ 🚀 Quick Start ]                           ║
║ [ 🎯 Filters     ] [ ⏰ Schedule       ]      ║
║ [ 📊 Reports     ] [ 🎨 Customization  ]      ║
║ [ 👥 Admins      ] [ 💳 Buy Credits   ]      ║
║ [ ℹ️  About       ]                          ║
║ [ ✕ Close ]                                  ║
╚══════════════════════════════════════════════╝

Mỗi màn hình hiển thị trạng thái hiện tại của bạn ở trên cùng để bạn biết những gì đã được cấu hình trước khi thay đổi bất cứ điều gì. Mọi thay đổi được lưu ngay lập tức vào cơ sở dữ liệu — không có nút "lưu" nào để quên bấm.

Trình hướng dẫn Quick Start

Chạm 🚀 Quick Start để có một luồng tuyến tính bốn bước, đưa một chat mới từ "chưa cấu hình gì" đến "báo cáo theo lịch đầu tiên" với số lượng bước nhắc tối thiể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.

Bốn bước:

Bước	Hỏi	Lưu vào
1	Tên dự án	Cài đặt ProjectName (dùng trên báo cáo, thẻ bảng xếp hạng, DM admin)
2	Theo dõi gì trên X — tài khoản, cashtag, hoặc từ khóa	Mảng from, cashtags, hoặc keywords của bộ lọc mặc định
3	Khi nào đăng báo cáo hằng ngày — 4 khung giờ mặc định hoặc HH:MM tùy chỉnh	Một job theo lịch gắn với chat của bạn
4	Xong — màn hình tóm tắt với gợi ý /recreate để xem trước ngay	(không có)

Toàn bộ menu

Mỗi nút cấp cao nhất mở một màn hình tập trung. Đi sâu thoải mái — mỗi màn hình có ← Back để quay lại cấp trước và ✕ Close để đóng.

🎯 Filters

Bot lấy những bài đăng X nào ở mỗi lần chạy theo lịch.

Chạm bất kỳ danh mục nào để đi sâu hơn. Excludes kiểu checkbox — một lần chạm bật/tắt "loại retweet / reply / quote tweet".

Named filters (nâng cao) cho phép bạn chạy nhiều bộ lọc đồng thời trên cùng một chat — hữu ích khi bạn quản lý nhiều khách hàng trong một nhóm. Mỗi named filter có nút xóa riêng theo hàng kèm xác nhận bằng một lần chạm. Chạm ➕ Add named filter để gửi một định nghĩa một dòng qua menu (name from:@x keywords:y cashtags:$Z mention:@m exclude:retweet ignore:@spam). Cần ít nhất một trong from / keywords / cashtags / mention.

Một màn hình danh mục trông như thế này — mô tả ngắn về danh mục làm gì, giá trị hiện tại, và các hành động Add / Remove / Clear all:

Khi bạn chạm ➕ Add, menu chuyển sang chế độ nhập liệu — gõ câu trả lời của bạn như một tin nhắn bình thường, và màn hình tự động vẽ lại với một banner xác nhận ("✓ Added 2 cashtags: $BTC, $ETH").

➕ Add cashtags

Send the cashtags to track, space-separated.
The $ is optional.

Example:  $BTC $ETH SOL

Type your reply as a normal message,
or tap Cancel to go back.

[✕ Cancel]

⏰ Schedule

Khi nào bot chạy và đăng báo cáo hằng ngày.

Bốn khung giờ mặc định hằng ngày phù hợp với hầu hết cộng đồng. Khung giờ đang hoạt động có tiền tố ✓ trong nhãn của nó. Custom time yêu cầu HH:MM. Specific days chấp nhận 14:30 Mon Wed Fri. Cron chấp nhận biểu thức cron chuẩn (ví dụ cron(0 12 ? * MON-FRI *)). Bot áp dụng tần suất tối thiểu 12 giờ để chi phí có thể dự đoán được.

Nếu bạn chạm một khung giờ mặc định trên một chat chưa có bộ lọc, menu sẽ từ chối với một lỗi thân thiện trỏ về 🎯 Filters — bot sẽ không lên lịch cho một chat không có gì để lấy dữ liệu.

📊 Reports & Period

📊 Reports & Period

Period: 01/05/2026 7days
Start:  2026-05-01
End:    2026-05-07

The bot fetches X posts inside this window on
every scheduled run. Without a period
configured, the bot uses a rolling 24-hour
window.

[📆 Set period]   [🗑 Clear period]
[⚡ Generate report now]
[📰 Show last report]

Set period giới hạn báo cáo trong một khoảng thời gian cụ thể (ví dụ một cuộc thi kéo dài một tuần). Định dạng DD/MM/YYYY Ndays hoặc Nweeks. Clear period trở về mặc định là khoảng 24h cuộn. Generate report now kích hoạt cùng Step Function mà cron dùng — hữu ích để xem trước ngay. Show last report trỏ về /report (đăng lại hình ảnh đã lưu gần nhất mà không tốn tín dụng).

🎨 Customization

Metadata dự án xuất hiện trên báo cáo và bảng xếp hạng công khai.

🎨 Customization

🏷 Name:        MyToken
✏️ Description: A community-driven DeFi project
📝 Long desc.:  (multi-paragraph project pitch…)
🖼 Logo:        ✓ uploaded
🔗 URLs:        2 URLs
💬 Topic:       Forum topic "Reports"

[🏷 Name]      [✏️ Description]
[📝 Long desc.][🖼 Logo]
[🔗 URLs]      [💬 Topic]
[📈 Leaderboard customization]

Cây con Leaderboard hiển thị:

Cài đặt	Định dạng
🏆 Points	Năm số, cách nhau bằng khoảng trắng: likes retweets replies quotes views (ví dụ 5 1 20 10 0.01)
🎨 Colors	Năm mã màu hex, cùng thứ tự
🔢 Top count	Số nguyên 1..10 — bao nhiêu người dùng trên bảng xếp hạng
📛 Top title	Văn bản tự do. Hậu tố tùy chọn |#hex đặt màu tùy chỉnh (ví dụ Top contributors|#FF8800)
🥇 Best-tweet title	Tương tự
📊 Engagement title	Tương tự

Tải logo dùng chung trình xử lý ảnh sẵn có của bot — chạm 🖼 Logo, sau đó gửi ảnh dưới dạng ảnh Telegram (không phải file). Bot sẽ đổi kích thước và tải lên CDN của website.

Topic yêu cầu bạn gửi /set_topic từ bên trong topic forum mong muốn. Menu không thể bắt được message_thread_id từ một nút bấm callback, nên phần này vẫn phải dùng lệnh gạch chéo.

👥 Admins & Notifications

Liệt kê người dùng được chỉ định nhận DM riêng tư về cạn tín dụng, lỗi lấy dữ liệu, và cảnh báo không tìm thấy chat. Thêm admin vẫn cần /add_admin @user1 @user2 từ chat — trình phân tích @-mention của Telegram chỉ kích hoạt trên tin nhắn thật, không phải callback.

👥 Admins & Notifications

Currently:
  • Alice (@alice_admin)
  • Bob (@bob_dev)

To add admins, send /add_admin @user1 @user2
in this chat.

[🗑 Clear notification list]

💳 Buy Credits & Plan

Hiển thị gói + số dư, cùng các nút điều khiển luồng mua và quản lý. Màn hình hiển thị khác nhau tùy theo gói hiện tại của chat:

Chat FREE:

💳 Buy Credits & Plan

Plan: FREE
Used this month: 47 / 100
Remaining:        53
Resets: 2026-06-01

[💰 Buy credits / upgrade]   [🛠 Manage subscription]
[📊 Usage this month]

Chat thuê bao PRO:

💳 Buy Credits & Plan

Plan: PRO (subscription) ✓
Unlimited fetching with Stripe metering above 1 000 / month free.

[💰 Buy credits / upgrade]   [🛠 Manage subscription]
[📊 Usage this month]

Chat tín dụng PRO (mua bằng ETH):

💳 Buy Credits & Plan

Plan: PRO (credits)
Credits remaining: 4 152
Total purchased:   5 000

[💰 Buy credits / upgrade]   [🛠 Manage subscription]
[📊 Usage this month]

Nút 💰 Buy credits / upgrade đăng một thẻ tùy chọn thanh toán bên dưới menu. Các tùy chọn bot đưa ra phụ thuộc vào gói hiện tại:

• FREE → cả hai 💳 Pay with Credit Card (thuê bao Stripe) và 🪙 Pay with ETH (gói tín dụng).
• PRO credits → cả hai tùy chọn đều hiển thị. ETH nạp thêm vào số dư hiện có; Stripe xếp chồng một thuê bao lên trên (tín dụng ETH hiện có vẫn còn và được chi tiêu trước).
• PRO subscription → không có tùy chọn mua. Bot trả lời bằng tin nhắn "đã có thuê bao" và trỏ tới 🛠 Manage để đến Stripe portal.

Nút 🛠 Manage subscription mở Stripe Customer Portal trong trình duyệt của bạn — đó là nơi bạn cập nhật thẻ, hủy, hoặc tải hóa đơn. Chỉ có ý nghĩa khi bạn có thuê bao Stripe đang hoạt động.

Màn hình con 📊 Usage this month tách fetched_posts và fetch_attempts cho tháng hiện tại và hôm nay — hữu ích để 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 hoặc truy vấn rỗng) và để xem trước hóa đơn Stripe tiếp theo khi bạn sắp đạt ngưỡng 1.000 bài đăng.

Mua + quản lý cũng có thể truy cập qua lệnh gạch chéo cũ /buy và /subscription. Hành vi giống hệt; các nút menu chỉ giúp bạn đỡ phải gõ.

📡 X Posts Auto-relay

Chuyển tiếp bài đăng từ các tài khoản X đã chọn vào chat ngay khi chúng được đăng — riêng biệt với báo cáo theo lịch. Hữu ích khi một dự án muốn admin cộng đồng thấy tweet tài khoản chính thức theo thời gian thực mà không cần kiểm tra X.

📡 X Posts Auto-relay

Forward posts from X accounts to this chat as soon
as they're published. Posts can take up to 5
minutes to appear here after the original was
posted on X.

3 active relays:
▶️ @MyTokenOfficial    (4/10 today)
▶️ @MyTokenCEO         (1/10 today)
⏸ @MyTokenSupport     (0/10 today)

[ ▶️ @MyTokenOfficial ]
[ ▶️ @MyTokenCEO ]
[ ⏸ @MyTokenSupport ]
[ ➕ Add Account ]

Mỗi relay thăm dò mỗi 5 phút qua X API. Bài đăng mới (kể từ lần chuyển tiếp thành công gần nhất) được đẩy vào chat dưới dạng URL thuần — Telegram tự động render thẻ xem trước X nên nội dung bài đăng hiển thị được.

Màn hình quản lý theo từng relay cho phép người vận hành tinh chỉnh hành vi:

📡 X Posts Auto-relay › @MyTokenOfficial

State: ▶️ Active
Today: 4/10 forwarded
Polls every: 5 min

Post types to forward
☐ Retweets
☐ Replies (to other users)
✅ Quote tweets
✅ Thread continuations (self-replies)

Topic: (default — top of chat)

[ ⏸ Pause ] [ ✏️ Cap: 10/day ]
[ ☐ Retweets ] [ ☐ Replies ]
[ ✅ Quote tweets ] [ ✅ Thread ]
[ 💬 Set topic ] [ 🧹 Clear topic ]
[ 🗑 Delete relay ]

Cài đặt	Tác dụng
Cap (1–100/ngày)	Số lần chuyển tiếp tối đa mỗi chat mỗi ngày UTC — khi đạt tới, relay ngừng chuyển tiếp âm thầm đến nửa đêm UTC. Mặc định 10.
Pause / Resume	Vô hiệu hóa lịch thăm dò cho relay này; khôi phục sẽ tạo lại ngay lập tức.
Retweets	Khi ✅, retweet của tài khoản được relay sẽ được chuyển tiếp. Mặc định tắt.
Replies	Khi ✅, reply tới người dùng khác sẽ được chuyển tiếp. Mặc định tắt.
Quote tweets	Khi ✅, quote tweet sẽ được chuyển tiếp. Mặc định bật.
Thread continuations	Khi ✅, self-reply (một người dùng reply lại tweet của chính họ) sẽ được chuyển tiếp — bao gồm cả thread Twitter. Mặc định bật. Tắt cái này nếu bạn chỉ muốn phần đầu của mỗi thread.
Topic	ID topic forum Telegram tùy chọn. Khi đặt, relay chỉ đăng vào topic đó thay vì luồng chính.

Tự dọn dẹp: nếu Telegram trả về lỗi "chat-gone" (bot bị kick / chặn), relay tự động xóa lịch thăm dò và cấu hình đã lưu. Không rò rỉ.

Giới hạn cứng: 10 relay mỗi chat. Điều chỉnh hằng số cơ bản nếu bạn cần nhiều hơn.

ℹ️ About

ℹ️ About this chat

Chat ID: -1002593612414
Plan: PRO ✓
Schedule: daily 18:00 UTC
Project: MyToken

Một bảng chẩn đoán cho các yêu cầu hỗ trợ.

/setup liên hệ với lệnh gạch chéo như thế nào

/setup là bổ sung — mọi lệnh gạch chéo hiện có vẫn hoạt động y hệt như trước. Menu bọc quanh cùng các nguyên thủy (buildQueryFromComponents, saveXBotSetting, createScheduleRule, v.v.), nên hành vi giống hệt nhau giữa hai bề mặt. Người dùng thành thạo có thể tiếp tục gõ /add_keywords DeFi airdrop cho tốc độ ghi nhớ cơ bắp; người mới có được một giao diện thân thiện có thể chạm.

Ba lệnh về cơ bản không thể chuyển thành nút menu vì chúng cần ngữ cảnh văn bản thuần + thực thể tin nhắn Telegram mà callback không mang theo:

Lệnh	Tại sao vẫn giữ nguyên
/set_topic [name]	Bắt message_thread_id của topic mà tin nhắn được gửi trong đó — một nút bấm không có ngữ cảnh thread
/add_admin @user	Dựa vào các thực thể mention đã xác minh của Telegram để xác minh admin chat
/set_x_filtering	Lệnh gạch chéo cũ để thêm một named filter; ⤴ Named filters → ➕ Add named filter của menu làm điều tương tự

Công thức cấu hình

Mục tiêu thường gặp → đường dẫn menu chính xác. Mỗi công thức chỉ mất một hoặc hai phút bấm chuột.

"Chỉ theo dõi bài đăng gốc (không retweet, không reply)"

Hầu hết cộng đồng muốn bảng xếp hạng thưởng cho nội dung gốc, không phải chia sẻ lại.

/setup → 🎯 Filters → 🚫 Excludes → chạm Retweets và Replies để cả hai hiển thị ✅. Xong. Các lần lấy dữ liệu tiếp theo sẽ gửi -is:retweet -is:reply tới X API và quote tweet vẫn được giữ lại.

"Thưởng reply nhiều hơn like (xây dựng cộng đồng)"

Điểm mặc định: like 1×, retweet 2×, reply 1.5×, quote 3×, view 0.001. Để ưu tiên đối thoại:

/setup → 🎨 Customization → 📈 Leaderboard customization → 🏆 Points → gửi:

1 1 5 3 0.001

Giờ reply nặng gấp 5× — thảo luận thực chất vượt trội hơn việc lướt qua thả tim.

"Chạy báo cáo hai lần một ngày"

Lịch mặc định kích hoạt tối đa một lần mỗi ngày. Để có báo cáo cuối giờ EU và cuối giờ Mỹ:

/setup → ⏰ Schedule → 🔧 Cron expression → gửi:

cron(0 14,22 ? * * *)

Hai lần kích hoạt/ngày lúc 14:00 + 22:00 UTC. Kiểm tra tần suất tối thiểu 12 giờ tự động áp dụng khoảng cách ≥ 12h — khung hẹp hơn sẽ bị từ chối với lỗi rõ ràng.

"Theo dõi nhiều chiến dịch đồng thời trong một nhóm"

Ba chiến dịch khách hàng đồng thời, một nhóm Telegram, một báo cáo cho mỗi chiến dịch mỗi lần kích hoạt.

/setup → 🎯 Filters → ⤴ Named filters → ➕ Add named filter, sau đó gửi một trong các dòng này ở mỗi lần:

campaign_a from:@kol1,@kol2 keywords:"#CampaignALaunch"
campaign_b from:@kol3,@kol4,@kol5 cashtags:$CBT
campaign_c from:@kol6 mention:@CampaignC_Official

Mỗi campaign kích hoạt theo cùng lịch và đăng một báo cáo riêng được gắn thẻ tên bộ lọc.

"Chuyển tiếp tweet của một tài khoản theo thời gian thực, giữa các báo cáo"

Tin tức lớn từ @MyTokenOfficial không nên chờ báo cáo 22:00 UTC.

/setup → 📡 X Posts Auto-relay → ➕ Add Account → gửi:

@MyTokenOfficial 5

(Tùy chọn 5 là giới hạn hằng ngày; mặc định 10.) Bot thăm dò mỗi 5 phút, chuyển tiếp URL khi có bài đăng mới, Telegram render thẻ xem trước.

"Giới hạn báo cáo trong một khung chiến dịch (ví dụ đợt đẩy 7 ngày)"

Không muốn nhiễu trước chiến dịch làm bẩn bảng xếp hạng.

/setup → 📊 Reports → 📆 Set period → gửi:

01/05/2026 7days

Báo cáo giờ chỉ lấy bài đăng nghiêm ngặt trong khung thời gian đó. 🗑 Clear period trở về khoảng 24h cuộn.

"Làm cho báo cáo đăng vào một topic forum, không phải luồng chính"

Nhóm dùng topic; báo cáo nên vào một topic Reports riêng.

Mở topic Reports, sau đó từ bên trong nó gửi:

/set_topic Reports

Báo cáo tương lai sẽ vào topic đó. Để hoàn tác: /set_topic clear từ bất kỳ đâu trong nhóm.

"Thông báo cho hai admin cụ thể khi hết tín dụng"

Bot DM cho admin được chỉ định khi có lỗi tín dụng / lấy dữ liệu / chat-gone. Mặc định, nó dùng lại toàn bộ admin chat — thu hẹp lại danh sách chọn lọc.

/add_admin @alice @bob

Giờ DM chỉ gửi tới @alice và @bob. Để xóa: /setup → 👥 Admins → 🗑 Clear notification list.

"Ẩn chat khỏi khu trưng bày công khai xbot.ninja"

Hồ sơ KOL cá nhân tự động bị ẩn (một người dùng không vượt qua ngưỡng ≥ 2 người dùng tích cực). Với các dự án cộng đồng muốn giữ riêng tư:

Không có công tắc ẩn rõ ràng — liệt kê công khai được kiểm soát bởi ngưỡng chỉ số. Hai cách để giữ riêng tư:

• Chạy một chat nhỏ / yên tĩnh không đạt ngưỡng (điểm người dùng cao nhất < 300, bài đăng < 5/tháng, hoặc người dùng tích cực < 2).
• Liên hệ hỗ trợ để đặt chat ở trạng thái miễn trừ — bảng điều khiển công khai sẽ bỏ qua nó bất kể chỉ số.

URL trực tiếp của chat (https://xbot.ninja/?chatId=…) vẫn có thể truy cập bất kể trạng thái. Chỉ chia sẻ với những người nên xem dữ liệu.

Các vướng mắc thường gặp

Triệu chứng	Lý do	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 — chọn khoảng cách ít nhất 12 giờ. Thông báo lỗi nêu tên cặp giờ vi phạm.
/setup không xuất hiện trong gợi ý tự động	Danh sách lệnh BotFather đã lỗi thời	Bot chấp nhận /setup bất kể gợi ý tự động. Cập nhật BotFather → /setcommands nếu khả năng khám phá quan trọng.
Xem trước bộ lọc hiển thị dấu ngoặc trống / truy vấn lạ	Một số thành phần trống	/setup → 🎯 Filters hiển thị truy vấn thực. Thêm ít nhất một trong tài khoản / cashtag / từ khóa / mention.
X Posts Auto-relay chuyển tiếp cả một thread 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 thread.
Đạt giới hạn hằng ngày nhưng tôi muốn nhiều hơn	Đạt MAX_POSTS_PER_DAY của relay	Chạm ✏️ Cap và tăng lên. Mỗi bài đăng chuyển tiếp tính một tín dụng.
Tiêu đề / màu tùy chỉnh trở lại như cũ qua đêm	Cập nhật cài đặt đã thành công nhưng UPDATED_AT bump làm mất hiệu lực cache render; 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. Cache render sẽ xây lại ở lần lấy dữ liệu tiếp theo.
Báo cáo có "0 bài đăng" ở mọi nơi	Không có bài đăng nào khớp bộ lọc trong khoảng thời gian đã cấu hình	Bỏ khoảng thời gian (24h cuộn khoan dung hơn), hoặc nới rộng bộ lọc. Thường là lỗi chính tả trong một cashtag.
Bot "online" nhưng báo cáo ngừng đến	Bot bị hạ khỏi admin / bị kick âm thầm	Kiểm tra Telegram → admin nhóm. Nâng lại nếu thiếu. Bot tự vô hiệu hóa khi có lỗi chat-gone.

Xong

Màn hình cuối cùng của trình hướng dẫn tóm tắt mọi thứ đã lưu và trỏ tới /setup → 📊 Reports → ⚡ Generate report now để xem trước ngay:

Đó là toàn bộ hướng dẫn. Gõ /setup trong nhóm của bạn để bắt đầu.

Gặp sự cố khi cấu hình một mục menu? Xem Khắc phục sự cố để biết ma trận triệu chứng-đến-khắc phục bao gồm bộ lọc, lịch, và thanh toán.