Vì sao chúng tôi làm lại /setup: từ 50 lệnh gộp thành 1 menu
X Bot từng có hơn 50 lệnh gạch chéo khiến người dùng mới bối rối. Chúng tôi gộp mọi thứ vào /setup với nút bấm inline. Đây là những gì đã thay đổi và lý do.
Nacho leads the Blockchain Web Services (BWS) team that builds and operates X Bot — the Telegram bot that turns X (Twitter) activity into leaderboards for crypto communities.

Nếu bạn đã thêm X Bot vào một nhóm chat cách đây một thời gian, có thể bạn còn nhớ một phiên bản bot rất khác. Từng có /set_x_filtering, /set_calendar, /set_top_count, /set_colors, /set_points, /set_topic, và khoảng 45 lệnh khác tương tự như vậy. Mỗi tính năng có một lệnh gạch chéo riêng, vì lúc đó điều này có vẻ là cách tự nhiên để trình bày một tập tính năng ngày càng lớn trên Telegram. Nhưng thực ra không phải vậy.
Bài viết này nói về lý do chúng tôi loại bỏ cấu trúc đó và thay bằng một menu /setup duy nhất, những con số nói lên điều gì trước và sau khi thay đổi, và những gì chúng tôi vẫn giữ lại cho những ai thích cách làm cũ.
Vấn đề: 50 lệnh không phải là danh sách tính năng, mà là một mê cung#
Tính năng tự động gợi ý lệnh của Telegram hiển thị một danh sách có thể cuộn ngay khi bạn gõ /. Điều này ổn với năm hoặc sáu lệnh. Nhưng với hơn 50 lệnh, nó không còn là một menu nữa mà trở thành một bức tường chữ mà không ai đọc hết từ đầu đến cuối. Các admin mới — người trong nhóm Telegram của một dự án crypto vừa được giao nhiệm vụ “này, cài đặt bot theo dõi đi” — sẽ gõ /setup, thấy một loạt lệnh xa lạ, rồi hoặc đoán sai hoặc bỏ cuộc.
Chúng tôi liên tục nhận được phản ánh này qua các ticket hỗ trợ, trước khi có luồng ❓ Help & Support thực sự để tiếp nhận: “làm sao để thêm cashtag,” “đặt lịch ở đâu,” “bot này có làm báo cáo không.” Câu trả lời luôn là một lệnh mà họ chưa tìm ra, bị chôn vùi trong một danh sách mà họ không có thời gian đọc. Bot đã có đầy đủ chức năng người dùng cần. Nó chỉ không cho bạn biết mọi thứ nằm ở đâu.
Các lệnh gạch chéo cũng không kết hợp tốt với nhau. Nếu bạn muốn thiết lập bộ lọc, lịch chạy và tùy chỉnh, đó là ba (hoặc nhiều hơn) lần gọi lệnh riêng biệt, mỗi lần đòi hỏi bạn phải nhớ đúng cú pháp — /set_x_filtering @handle1 @handle2 $TOKEN, định dạng chuẩn xác, không gõ sai, không có cơ chế thử lại dễ chịu. Chỉ cần một đối số sai định dạng là bạn sẽ nhận một thông báo lỗi cộc lốc và phải làm lại từ đầu. Không có lộ trình hướng dẫn nào từ “tôi vừa thêm bot này” đến “tôi đã có báo cáo hoạt động.”
Giải pháp: một điểm khởi đầu duy nhất, mọi thứ đều dễ tìm#
Chúng tôi thu gọn toàn bộ tập lệnh thành một lệnh /setup duy nhất, mở ra một bàn phím inline — dạng menu nút bấm mà Telegram hỗ trợ sẵn. Thay vì phải nhớ tên của 50 lệnh, bạn sẽ thấy 8 mục có nhãn rõ ràng và chỉ cần chạm vào mục mình cần:
- 🎯 Bộ lọc — tài khoản, cashtag, từ khóa, lượt nhắc đến, loại trừ, danh sách bỏ qua, bộ lọc có tên
- ⏰ Lịch chạy — khung giờ mặc định hằng ngày, giờ tùy chỉnh, ngày cụ thể, hoặc biểu thức cron đầy đủ
- 📊 Báo cáo — kích hoạt báo cáo theo yêu cầu, xem lại lịch sử báo cáo
- 🎨 Tùy chỉnh — tên dự án, mô tả, logo, URL, tiêu đề và màu bảng xếp hạng, trọng số, số lượng top-N
- 👥 Quản trị viên — ai khác có thể cấu hình bot
- 💳 Mua Credit — gói ETH credit hoặc gói thuê bao PRO
- 📡 Tự động chuyển tiếp bài đăng X — chuyển tiếp bài đăng từ các tài khoản đã chọn vào nhóm chat gần như theo thời gian thực
- ❓ Trợ giúp & Hỗ trợ — mở ticket, nhận phản hồi qua tin nhắn riêng Telegram

Mỗi nút bấm dẫn đến một menu khác, chứ không phải một cú pháp bạn phải nhớ. Trước đây, thiết lập cashtag nghĩa là phải nhớ /set_x_filtering và sắp đúng thứ tự đối số. Giờ đây chỉ cần /setup → 🎯 Bộ lọc → 💵 Cashtag → ➕ Thêm, và bot sẽ nhắc bạn nhập những gì cần tiếp theo.

Trải nghiệm lần đầu thay đổi nhiều nhất. Các nhóm chat mới giờ đây có một trình hướng dẫn khởi động nhanh gồm 4 bước: tên dự án, sau đó là bộ lọc, rồi lịch chạy, và cuối cùng là màn hình xác nhận — hoàn tất trong chưa đầy một phút, không có cú pháp lệnh nào để gõ sai.


Con số thực sự thay đổi: tỷ lệ kích hoạt#
Chúng tôi theo dõi tỷ lệ phần trăm nhóm chat mới tạo ra báo cáo đầu tiên trong vòng 24 giờ sau khi thêm bot — tín hiệu rõ ràng nhất cho biết “người này có thực sự hoàn tất thiết lập hay đã bỏ ngang.” Trước khi thiết kế lại menu, một phần lớn các lượt cài đặt mới không bao giờ hoàn tất cấu hình; admin thử gõ vài lệnh gạch chéo, gặp lỗi do đối số sai định dạng, rồi im lặng bỏ đi. Sau khi thiết kế lại, phần lớn các nhóm chat mới bắt đầu trình hướng dẫn khởi động nhanh đều hoàn tất nó và có báo cáo được lên lịch ngay trong ngày. Thành công lớn nhất của trình hướng dẫn không phải là dạy người dùng tính năng mới — mà là loại bỏ khả năng gõ sai điều gì đó.
Các ticket hỗ trợ dạng “làm sao để cấu hình X” cũng giảm mạnh sau khi menu ra mắt, thay vào đó là những câu hỏi cụ thể hơn về việc tinh chỉnh (chẳng hạn cách công cụ chọn tweet hay nhất hoạt động) thay vì “nút bấm cho cái này ở đâu.”
Những gì chúng tôi giữ lại làm lệnh trực tiếp#
Chúng tôi không xóa hết mọi thứ. Một số ít lệnh đủ thường dùng, hoặc đủ hữu ích như một lối tắt nhanh, nên chúng tôi vẫn giữ chúng bên ngoài menu:
/setup— mở menu (chính là điểm khởi đầu)/report— kích hoạt báo cáo ngay lập tức, không cần điều hướng menu/buy— đi thẳng đến mua credit/subscription— kiểm tra hoặc quản lý gói thuê bao PRO/add_admin— thêm quản trị viên bot mà không cần vào sâu trong mục 👥 Quản trị viên/set_topic— đặt chủ đề mục tiêu trong các nhóm ở chế độ forum/status— kiểm tra nhanh tình trạng (bộ lọc đang hoạt động, lịch chạy, gói dịch vụ)/get_chatid— thỉnh thoảng cần dùng cho ticket hỗ trợ và gỡ lỗi API
Đây là những lệnh mà người dùng thành thạo gõ theo thói quen, và cũng là những lệnh mà script hay công cụ tự động hóa nhiều khả năng sẽ gọi trực tiếp. Việc giữ lại chúng đồng nghĩa với việc chúng tôi không phá vỡ quy trình làm việc hiện có của bất kỳ ai, trong khi vẫn cải thiện khả năng dễ tìm cho tất cả những người dùng khác. Hơn 40 lệnh cũ còn lại về mặt kỹ thuật vẫn hoạt động để đảm bảo tương thích ngược, nhưng chúng không còn được ghi trong tài liệu hay gợi ý ở bất kỳ đâu — menu giờ là lộ trình được hỗ trợ chính thức.
Chi phí chuyển đổi có đáng không?#
Có, nhưng không hề miễn phí. Mỗi màn hình menu phải xử lý được trường hợp người dùng chạm vào một nút, đóng Telegram lại, rồi ba ngày sau quay lại và mong đợi trạng thái vẫn như cũ — bàn phím inline không giữ ngữ cảnh hội thoại vô thời hạn, nên chúng tôi phải làm cho mỗi bước có thể quay lại được thay vì giả định một luồng tuyến tính. Chúng tôi cũng phải suy nghĩ kỹ hơn về quyền hạn: một menu khuyến khích người dùng bấm lung tung nhiều hơn so với một lệnh mà họ phải tra cứu rồi gõ vào, nên mục 👥 Quản trị viên và các kiểm tra vai trò cũng được siết chặt hơn cùng lúc.
Nếu bạn đang xây dựng một bot Telegram với nhiều hơn một vài tùy chọn cấu hình, quan điểm của chúng tôi là: đừng đợi đến khi có 50 lệnh mới quyết định thay đổi. Ngưỡng mà tại đó một danh sách lệnh không còn hữu ích nữa thấp hơn nhiều so với cảm giác của bạn khi đang lần lượt thêm từng tính năng một. Nếu người dùng của bạn cấu hình những thứ họ không làm hằng ngày — cú pháp lịch chạy, các tổ hợp bộ lọc, bộ lọc có tên — một menu có hướng dẫn sẽ luôn tốt hơn một lệnh phải ghi nhớ. Nếu đó là một lệnh mà ai đó sẽ chạy hàng chục lần mỗi ngày, hãy giữ nó như một lệnh trực tiếp, nhanh gọn.
Để tìm hiểu sâu hơn về cách phần bộ lọc của /setup hoạt động trong thực tế, hãy xem theo dõi hoạt động X cho một đợt ra mắt token và theo dõi cashtag cho các dự án crypto — cả hai bài đều hướng dẫn từng bước qua menu 🎯 Bộ lọc hiện tại. Để tham khảo đầy đủ về menu, tài liệu menu setup bao quát mọi màn hình, và x-bot-overview là điểm khởi đầu tốt nhất nếu bạn hoàn toàn mới với bot.
Sẵn sàng theo dõi cộng đồng của bạn trên X chưa? Thêm @BWS_X_Bot vào nhóm Telegram của bạn, chạy /setup, và báo cáo đầu tiên sẽ được tạo theo lịch đã cấu hình. Gói FREE bao gồm 100 bài đăng/tháng — không cần thẻ thanh toán.
Về bài viết này: Bài viết này được soạn thảo với sự hỗ trợ của AI thông qua quy trình nội dung của X Bot và được Nacho Coll, Nhà sáng lập & Principal tại Blockchain Web Services (BWS), xem xét trước khi đăng. Mọi tuyên bố về sản phẩm đều được đối chiếu với bot đang hoạt động thực tế. Đọc thêm về cách chúng tôi dùng AI trong nội dung. Phát hiện lỗi? Liên hệ với chúng tôi qua
/setup→ ❓ Trợ giúp & Hỗ trợ.
“Đây là một trong nhiều cập nhật sản phẩm mà chúng tôi đề cập — xem blog X Bot để biết ghi chú phát hành, case study và bài phân tích chuyên sâu.”
Về bài viết này
Bài viết này được hỗ trợ bởi AI, con người biên tập và kiểm chứng thực tế trên nền tảng IPFS.NINJA trước khi xuất bản. Tìm hiểu cách chúng tôi dùng AI trong nội dung .

Về tác giả
Nacho Coll
Founder & Principal, Blockchain Web Services
Nacho leads the Blockchain Web Services (BWS) team that builds and operates X Bot — the Telegram bot that turns X (Twitter) activity into leaderboards for crypto communities. He writes about KOL performance tracking, the X API, and running analytics bots for Telegram groups, from the operator side of the wire. Building on blockchain and decentralized infrastructure since 2019.
- telegram bot ux
- slash commands vs menu
- x bot setup redesign
- telegram inline keyboard ux

