왜 /setup을 재설계했나: 슬래시 명령어 50개에서 메뉴 하나로

예전에 X Bot을 그룹 채팅에 추가해 본 적이 있다면, 지금과는 아주 다른 봇을 기억할 것입니다. 그때는 /set_x_filtering, /set_calendar, /set_top_count, /set_colors, /set_points, /set_topic을 비롯해 이와 비슷한 명령어가 45개 넘게 더 있었습니다. 기능 하나마다 전용 슬래시 명령어가 있었는데, 늘어나는 기능을 텔레그램에서 노출하는 자연스러운 방식이라고 생각했기 때문입니다. 하지만 그렇지 않았습니다.

이 글은 왜 그 구조를 걷어내고 단일 /setup 메뉴로 교체했는지, 재설계 전후 수치가 무엇을 말해줬는지, 그리고 예전 방식을 선호하는 사람들을 위해 무엇을 남겨두었는지에 관한 이야기입니다.

문제: 명령어 50개는 기능 목록이 아니라 미로다#

텔레그램의 명령어 자동완성은 /를 입력하는 순간 스크롤 가능한 목록을 보여줍니다. 명령어가 대여섯 개일 때는 문제없이 작동합니다. 하지만 50개가 넘어가면 더 이상 메뉴가 아니라, 아무도 처음부터 끝까지 읽지 않는 텍스트 벽이 됩니다. 크립토 프로젝트 텔레그램 그룹에서 “이 트래킹 봇 좀 설정해줘”라는 말을 방금 들은 신규 관리자는 /setup을 입력하고 낯선 명령어 더미를 마주한 뒤, 잘못 추측하거나 아예 포기하곤 했습니다.

제대로 된 ❓ Help & Support 흐름을 갖추기 전, 우리는 이런 문의를 지원 티켓으로 끊임없이 받았습니다: “캐시태그는 어떻게 추가하나요,” “스케줄은 어디서 설정하나요,” “이 봇이 리포트 기능도 있긴 한가요.” 답은 항상 존재했지만, 시간 내서 읽지 않은 목록 어딘가에 묻힌 명령어였습니다. 봇에는 사람들이 원하는 기능이 모두 있었습니다. 다만 그게 어디 있는지 알려주지 못했을 뿐입니다.

슬래시 명령어는 조합해서 쓰기도 어렵습니다. 필터, 스케줄, 커스터마이징을 모두 설정하려면 서로 다른 명령어 호출을 세 번(혹은 그 이상) 해야 했고, 매번 정확한 문법을 기억해야 했습니다 — /set_x_filtering @handle1 @handle2 $TOKEN처럼 형식을 정확히 맞추고, 오타 없이, 관대한 재시도도 없이 말이죠. 인자 하나만 잘못 써도 짧은 에러 메시지를 받고 처음부터 다시 시작해야 했습니다. “이 봇을 방금 추가했다”에서 “작동하는 리포트를 갖췄다”까지 안내해주는 경로가 없었습니다.

해결책: 진입점 하나, 모든 것이 눈에 보이도록#

우리는 명령어 표면을 단일 /setup 명령어로 압축했고, 이 명령어는 텔레그램이 기본 지원하는 탭 가능한 버튼 메뉴, 즉 인라인 키보드를 엽니다. 명령어 50개를 외울 필요 없이, 레이블이 붙은 8개 섹션을 보고 원하는 것을 탭하면 됩니다:

• 🎯 Filters — 계정, 캐시태그, 키워드, 멘션, 제외 목록, 무시 목록, 이름이 지정된 필터
• ⏰ Schedule — 매일 프리셋, 사용자 지정 시간, 특정 요일, 또는 완전한 cron 표현식
• 📊 Reports — 즉시 리포트를 트리거하거나 리포트 기록을 확인
• 🎨 Customization — 프로젝트 이름, 설명, 로고, URL, 리더보드 제목과 색상, 가중치, top-N 개수
• 👥 Admins — 봇을 설정할 수 있는 다른 관리자
• 💳 Buy Credits — ETH 크레딧 팩 또는 PRO 구독
• 📡 X Posts Auto-relay — 선택한 계정의 게시물을 거의 실시간으로 채팅에 전달
• ❓ Help & Support — 티켓을 열고 텔레그램 DM으로 답변 받기

버튼마다 다음 메뉴로 이어질 뿐, 외워야 할 문법은 없습니다. 예전에는 캐시태그를 설정하려면 /set_x_filtering을 기억하고 인자 순서를 정확히 맞춰야 했습니다. 이제는 /setup → 🎯 Filters → 💵 Cashtags → ➕ Add로 이동하면 봇이 다음에 필요한 정보를 알아서 물어봅니다.

가장 크게 바뀐 것은 첫 사용 경험입니다. 새 채팅방은 이제 4단계 퀵스타트 마법사를 거칩니다: 프로젝트 이름, 필터, 스케줄, 그리고 확인 화면 순서로, 명령어 문법을 틀릴 걱정 없이 1분 이내에 끝납니다.

실제로 움직인 것: 활성화 수치#

우리는 봇을 추가한 지 24시간 안에 첫 리포트를 발행한 신규 채팅방 비율을 추적했습니다 — “이 사람이 실제로 설정을 끝냈는가, 아니면 도중에 이탈했는가”를 가장 명확하게 보여주는 신호입니다. 메뉴 재설계 이전에는 신규 설치 중 상당수가 설정을 끝내지 못했습니다. 관리자들은 슬래시 명령어를 몇 번 시도해보다 잘못된 인자 때문에 에러를 만나고는 그대로 조용해지곤 했습니다. 재설계 이후에는 퀵스타트 마법사를 시작한 대부분의 신규 채팅방이 마법사를 끝까지 완료했고, 같은 날 리포트 스케줄을 갖췄습니다. 마법사가 거둔 가장 큰 성과는 새로운 기능을 가르친 것이 아니라, 뭔가를 잘못 입력할 가능성 자체를 없앤 것이었습니다.

메뉴가 출시된 뒤 “X를 어떻게 설정하나요” 같은 지원 티켓도 크게 줄었고, 대신 튜닝에 관한 좀 더 구체적인 질문(예: 베스트 트윗 선정 로직이 어떻게 동작하는지)으로 바뀌었습니다. “이 기능 버튼이 어디 있나요”가 아니라 말이죠.

직접 명령어로 남겨둔 것들#

모든 것을 없앤 건 아닙니다. 사용 빈도가 높거나 빠른 경로로 유용한 일부 명령어는 메뉴 밖에 그대로 남겨두었습니다:

• /setup — 메뉴를 엽니다 (진입점 그 자체)
• /report — 메뉴 탐색 없이 즉시 리포트를 트리거합니다
• /buy — 크레딧 구매로 바로 이동합니다
• /subscription — PRO 구독을 확인하거나 관리합니다
• /add_admin — 👥 Admins를 뒤질 필요 없이 봇 관리자를 추가합니다
• /set_topic — 포럼 모드 그룹에서 대상 토픽을 설정합니다
• /status — 빠른 상태 점검 (필터 활성 여부, 스케줄, 플랜)
• /get_chatid — 지원 티켓이나 API 디버깅에 가끔 필요합니다

이들은 파워 유저가 습관적으로 입력하는 명령어이자, 스크립트나 자동화가 직접 호출할 가능성이 높은 명령어입니다. 이 명령어들을 남겨둠으로써 기존 워크플로를 깨지 않으면서도, 나머지 모든 사용자를 위한 발견 가능성 문제를 해결할 수 있었습니다. 나머지 레거시 명령어 40여 개는 하위 호환을 위해 여전히 기술적으로는 작동하지만, 어디에도 문서화되거나 안내되지 않습니다 — 이제 지원되는 경로는 메뉴뿐입니다.

마이그레이션 비용을 감수할 가치가 있었나?#

있었습니다, 다만 공짜는 아니었습니다. 모든 메뉴 화면은 사용자가 버튼을 탭한 뒤 텔레그램을 닫고 사흘 뒤에 돌아와서도 같은 상태를 기대하는 경우를 처리해야 했습니다 — 인라인 키보드는 대화 컨텍스트를 무기한 유지하지 않으므로, 선형 흐름을 가정하는 대신 모든 단계를 다시 진입할 수 있게 만들어야 했습니다. 권한 문제도 더 신경 써야 했습니다. 찾아서 직접 입력해야 하는 명령어보다 메뉴는 클릭을 더 유도하기 때문에, 동시에 👥 Admins와 역할 검사도 강화했습니다.

설정 항목이 여러 개인 텔레그램 봇을 만들고 있다면, 우리의 결론은 이렇습니다: 명령어가 50개가 될 때까지 기다리지 마세요. 기능을 하나씩 추가하는 입장에서 느끼는 것보다, 명령어 목록이 쓸모없어지는 임계점은 훨씬 낮습니다. 사용자가 매일 하지는 않는 작업 — 스케줄 문법, 필터 조합, 이름이 지정된 필터 — 을 설정해야 한다면, 안내형 메뉴가 외워야 하는 명령어보다 언제나 낫습니다. 반대로 하루에도 수십 번 실행할 명령어라면, 빠르고 직접적인 명령어로 남겨두세요.

/setup의 필터링 부분이 실제로 어떻게 동작하는지 더 깊이 살펴보려면 토큰 런칭을 위한 X 활동 추적하기와 크립토 프로젝트를 위한 캐시태그 추적하기를 확인하세요 — 두 글 모두 현재 🎯 Filters 메뉴를 단계별로 다룹니다. 전체 메뉴 레퍼런스는 setup 메뉴 문서에서 모든 화면을 확인할 수 있고, 봇을 처음 접한다면 x-bot-overview가 가장 좋은 출발점입니다.

X에서 커뮤니티를 추적할 준비가 되셨나요? 텔레그램 그룹에 @BWS_X_Bot을 추가하고 /setup을 실행하면, 설정한 스케줄에 맞춰 첫 리포트가 발행됩니다. FREE 플랜은 월 100개 게시물까지 무료로 제공하며, 카드 등록이 필요하지 않습니다.

이 글에 대하여: 이 포스트는 X Bot의 콘텐츠 워크플로를 활용해 AI의 도움으로 초안이 작성되었으며, 발행 전 Blockchain Web Services(BWS) 창업자 겸 대표인 Nacho Coll의 검토를 거쳤습니다. 모든 제품 관련 주장은 실제 운영 중인 봇을 기준으로 확인됩니다. 콘텐츠 제작에 AI를 활용하는 방식을 읽어보세요. 오류를 발견하셨나요? /setup → ❓ Help & Support를 통해 저희에게 알려주세요.

“이 글은 저희가 다루는 여러 제품 업데이트 중 하나입니다 — 릴리스 노트, 사례 연구, 심층 분석은 X Bot 블로그에서 확인하세요.”