설치

X Bot을 텔레그램 그룹에 세 단계로 설정하세요. 대부분의 팀은 3분 이내에 설치를 완료합니다. 마법사가 대부분의 작업을 처리합니다.

가장 빠른 경로 — @BWS_X_Bot → 그룹에 추가 → /setup → 🚀 Quick Start. 이어지는 네 가지 안내가 필요한 전부입니다.

시작 전에 준비할 5가지

시작하기 전에 다음을 준비하세요:

아래에서 설정할 각 옵션에 대한 화면별 투어는 The /setup menu를 참고하세요.

필요한 것	어디서 얻나요
텔레그램 계정	telegram.org
텔레그램 그룹의 관리자 권한	없다면 새로 만드세요: 텔레그램 → 새 그룹
추적하려는 X 핸들, 캐시태그, 또는 키워드	예: @your_username, $YOUR_TOKEN, "#YourCampaign"
(선택) 프로젝트 로고 + URL 목록	공개 xbot.ninja 쇼케이스용
(선택) 시간대 선호도	일정은 UTC 기준입니다. 커뮤니티가 가장 활발한 시각에 맞는 UTC 시간을 고르세요

어떤 요금제가 필요할지 잘 모르겠나요? Pricing을 확인하세요 — 대부분의 팀은 FREE 등급(월 100건 게시물)으로 시작해 나중에 업그레이드합니다.

어떤 시나리오가 자신에게 맞는지 확실하지 않다면 Overview의 4가지 사용 사례를 훑어보고 가장 가까운 것을 골라 아래 2단계에서 그 필터 권장 사항을 사용하세요.

1단계 — 그룹에 봇 추가하기

1. 텔레그램을 열고 @BWS_X_Bot을 검색합니다.
2. 그룹에 봇을 추가합니다.
3. 관리자로 승격합니다. 기본 관리자 권한 외에 특별한 권한은 필요 없습니다(봇이 관리자 상태가 필요한 이유는 순전히 텔레그램이 그룹 메시지를 읽고 리포트를 게시하도록 허용하기 때문입니다).

DM이 아니라 그룹입니다

봇의 분석 기능은 그룹에서만 작동하며 비공개 DM에서는 작동하지 않습니다. @BWS_X_Bot과 DM을 시작하면 /help와 /buy는 작동하지만 대부분의 설정 메뉴는 작동하지 않습니다.

2단계 — /setup 실행하기

그룹에서 다음을 입력하세요:

/setup

봇이 인터랙티브 메뉴로 응답합니다. 🚀 Quick Start를 탭해 4단계 마법사를 엽니다.

마법사는 순서대로 네 가지를 묻습니다:

단계	질문	예시
1	프로젝트 이름	MyToken, KOL Campaign Q2, @your_username Performance
2	X에서 무엇을 추적할지	📢 Accounts + 핸들, 💵 Cashtags + 티커, 또는 🔍 Keywords + 문구
3	봇이 언제 실행될지	일일 프리셋 선택(09:00 / 14:00 / 18:00 / 22:00 UTC) 또는 사용자 지정 시간 입력
4	완료	저장된 내용 요약

Skip과 Exit는 언제나 사용할 수 있습니다 — 부분적으로 완료된 마법사가 여러분을 막는 일은 없으며, 설정은 그저 기본값으로 유지됩니다.

왜 /setup인가요? 모든 관리자 명령을 클릭 가능한 즉시 편집 인터페이스로 감쌌기 때문에 명령어를 외울 필요가 없습니다. 설정은 즉시 저장됩니다. 파워 유저는 여전히 슬래시 명령을 직접 입력할 수 있습니다 — 두 방식은 동등하며 동작이 동일합니다. 전체 투어: The /setup menu.

3단계 — 확인하기

마법사가 완료되면 /setup → 📊 Reports → ⚡ Generate report now를 열어 즉시 리포트를 발행하세요(다음 예약된 리포트는 2단계에서 고른 시각에 실행됩니다).

봇은 약 1~3분 이내에 리더보드 이미지를 그룹에 게시합니다. 소규모 채팅(계정 몇 개, 낮은 게시물 양)은 더 빨리 끝나며, 수백 건의 게시물을 가져와야 하는 커뮤니티 채팅은 2~3분이 걸릴 수 있습니다.

첫 예약 실행을 기다리세요

수동으로 Generate report now를 실행한 후, 다음 자동 실행은 설정한 크론 시각에 발생합니다. 발동당 리포트 하나만 받게 되며 중복 게시는 없습니다.

비용 및 크레딧

X Bot은 모든 데이터 가져오기에 공식 X API를 사용합니다. 모든 채팅은 FREE로 시작하며, 여기서부터 하나 또는 두 가지 유료 경로를 추가할 수 있습니다:

요금제	지불 금액	포함 내용
FREE	$0	하드 캡으로 월 100건 게시물. 봇은 100건에서 가져오기를 멈추고 다음 달 1일에 초기화됩니다.
PRO 구독(Stripe)	월 $19 + 월 1,000건 초과 시 게시물당 $0.02(Stripe 미터링)	자동 갱신. 매월 첫 1,000건은 무료 임계값으로 포함(크레딧 잔액이 아니며 이월되지 않음).
PRO 크레딧(ETH)	크레딧당 $0.02, 1,000 / 2,000 / 3,000 / 4,000 / 5,000 / 10,000 / 50,000 / 100,000 팩	일회성. 크레딧은 만료되지 않습니다. 기존 잔액에 충전됩니다.

한 채팅이 PRO·구독과 PRO·크레딧을 동시에 보유할 수 있습니다 — 가져오기당 청구는 ETH 크레딧을 먼저 소진하고, 그다음 구독의 월간 지급분, 그다음 미터링 초과분 순으로 처리됩니다. 전체 요금제 전환 매트릭스와 구매 흐름은 pricing을 참고하세요.

요금제와 잔액은 언제나 /setup → 💳 Buy Credits에서 확인할 수 있습니다. 지정된 관리자는 크레딧이 80%에 도달했을 때, 그리고 완전히 소진되었을 때 텔레그램 DM을 받습니다.

사용 사례별 다음 단계 권장

시나리오에 맞는 행을 고르고, 링크된 Overview 섹션에서 전체 레시피를 따라가세요:

시나리오	마법사 이후 추가할 것	상세
5명의 KOL을 추적하는 KOL 에이전시	캐시태그 + 캠페인 해시태그 정교화, 22:00 UTC 일정	Use case 1
커뮤니티를 참여시키는 프로젝트	공개 xbot.ninja 카드를 위해 🎨 Customization에 로고 + URL	Use case 2
솔로 KOL 포트폴리오	Customization에 개인 프로필 사진 + LinkedIn URL, 잠재 고객에게 xbot.ninja URL 공유	Use case 3
멀티 클라이언트 에이전시	/setup → 🎯 Filters → ⤴ Named filters → ➕ Add named filter — 클라이언트당 하나씩	Use case 4
X 계정 게시물을 실시간으로 수신	/setup → 📡 X Posts Auto-relay → ➕ Add Account	The /setup menu

설정되는 항목

/setup 내 섹션	설정하는 것	중요한 이유
🎯 Filters	X에서 추적할 계정, 캐시태그, 키워드, 멘션	봇이 가져올 게시물을 정의
⏰ Schedule	자동 리포트 시각	봇이 이 크론 주기로 가져오기 + 렌더링 실행
📊 Reports & Period	선택적 날짜 범위(예: 경쟁 기간)	리포트를 특정 구간으로 제한
🎨 Customization	프로젝트 이름, 설명, 로고, URL, 리더보드 가중치와 색상	리포트 이미지와 공개 xbot.ninja 쇼케이스의 브랜딩
👥 Admins	크레딧/가져오기 문제에 대한 비공개 DM을 받는 사람	운영 가시성
💳 Subscription	요금제, 크레딧 잔액, 업그레이드 진입점	비용 가시성과 결제
📡 Auto-relay	실시간(5분마다)으로 채팅에 전달할 X 계정	예약 리포트 사이의 실시간 업데이트

공개 쇼케이스(선택 사항)

프로젝트가 공개 리스팅 기준(최고 점수 ≥ 300, 게시물 ≥ 5건, 당월 활성 사용자 ≥ 2명)을 충족하면 xbot.ninja에 나타납니다. /setup → 🎨 Customization(이름, 설명, 로고, URL)에서 프로젝트 메타데이터를 추가하세요.

솔로 KOL 설정(단일 계정)은 "활성 사용자 ≥ 2명" 규칙을 통과하지 못하며 직접 URL로만 접근할 수 있습니다 — 의도된 설계입니다.

설치 확인하기

대부분의 진단은 /setup에서 직접 확인할 수 있습니다(모든 화면 상단에 채팅의 현재 상태가 표시됩니다). 빠른 점검 목록:

확인 항목	방법
봇이 관리자인가	텔레그램 → 그룹 설정 → 관리자
추적이 설정되었는가	/setup → 🎯 Filters → 나열된 계정/캐시태그/키워드 확인
필터가 올바르게 렌더링되는가	/setup → 🎯 Filters
일정이 설정되었는가	/setup(메뉴 상단에 현재 일정 표시)
크레딧이 있는가	/setup → 💳 Buy Credits
수동 리포트가 작동하는가	/setup → 📊 Reports → ⚡ Generate report now

첫 리포트가 나타나지 않을 때 — 문제 해결

Generate report now가 3분 이내에 게시물을 생성하지 않는다면:

증상	가능성 있는 원인	해결 방법
봇 DM이 "게시물을 찾지 못함"이라고 표시	필터가 너무 좁거나 최근 매칭 게시물이 없음	/setup → 🎯 Filters — 실제 X API 쿼리의 오타를 확인. 범위를 넓혀보세요(설정된 기간이 있다면 제거).
봇 DM이 "크레딧 소진"이라고 표시	FREE 채팅이 월 100건 한도에 도달	다음 달까지 기다리거나 /setup → 💳 Buy Credits → 💰 Buy로 구독하거나 크레딧 팩 구매
아무 일도 일어나지 않고 DM도 없음	봇이 관리자가 아니거나 웹훅이 중단됨	봇을 관리자로 재승격하세요. 여전히 아무 일도 없다면 support에 문의하세요.
이미지는 렌더링되지만 텍스트가 비어있음	AI 코멘터리 시간 초과	재실행하세요. 일시적 현상입니다. 계속되면 지원팀에 문의하세요 — AI 제공사에 간헐적 장애가 있을 수 있습니다
"Unauthorized" / "Forbidden" 오류	X API 토큰 문제(운영자 측)	지원팀에 문의하세요. 사용자가 고칠 수 있는 부분이 아닙니다

셀프서비스 진단

/setup → ℹ️ About는 채팅 ID, 요금제, 일정을 한 화면에 보여줍니다. 이 텍스트를 지원 요청에 복사해 넣으면 처리 속도가 약 80% 빨라집니다.

FAQ — 자주 묻는 설치 질문

Q. 텔레그램 채널(그룹이 아닌)에 봇을 설치할 수 있나요? 아니요, 그룹과 슈퍼그룹에서만 가능합니다. 채널은 리포트 흐름이 사용하는 메시지 답글 컨텍스트를 허용하지 않습니다.

Q. 토픽이 있는 포럼형 그룹에서 봇을 운영할 수 있나요? 네. 리포트를 게시하고 싶은 토픽 안에서 /set_topic을 사용하세요. 이후 봇은 그 토픽에 게시하며, 설정하지 않으면 메인 스레드에 게시합니다.

Q. 봇이 그룹 메시지에 대한 읽기 권한이 필요한가요? 봇은 명령 메시지(예: /setup)만 수신하면 됩니다. 일반 채팅은 읽지 않습니다. X 쪽 데이터는 텔레그램 메시지가 아니라 공식 X API에서 가져옵니다.

Q. 비공개/보호된 X 계정을 추적할 수 있나요? 아니요 — X API는 공개 게시물만 반환합니다. 보호된 계정을 추적하면 결과 없이 조용히 실패합니다.

Q. 그룹에서 봇을 제거하면 데이터가 삭제되나요? 아니요. 설정, 히스토리, 점수, 리포트는 봇의 데이터베이스에 남아 있습니다. 같은 채팅 ID에 봇을 다시 추가하면 모든 것이 재개됩니다. 완전히 정리하고 싶다면 지원팀에 문의하세요.

Q. 프로젝트 이름을 나중에 변경할 수 있나요? 네 — /setup → 🎨 Customization → 🏷 Name. 다음 리포트와 공개 xbot.ninja URL 슬러그에 반영됩니다.

Q. [다른 도구]와 게시물 수가 다르게 나오는 이유는요? X Bot은 공식 X API에서 직접 가져옵니다. 대부분의 서드파티 트래커는 스크래핑하거나 추정합니다. 실제로 20~50%의 오차를 확인했습니다. X API 수치가 진실의 원천입니다.

Q. 취소는 어떻게 하나요?

• FREE 채팅: 그룹에서 봇을 제거하기만 하면 됩니다.
• PRO 구독: /setup → 💳 Buy Credits → 🛠 Manage subscription을 열면 취소할 수 있는 Stripe 고객 포털이 열립니다. 취소는 현재 결제 주기가 끝날 때 적용됩니다.
• PRO 크레딧(ETH): 크레딧은 자동 갱신되지 않으며, 잔액이 0이 되면 채팅이 자동으로 FREE로 강등됩니다. 언제든 봇을 제거할 수 있습니다.

도움이 필요하신가요?

Support를 참고하거나, 채팅에서 /setup → ℹ️ About을 열어 팀과 공유할 진단 정보를 확인하세요.

설정을 시작하기 전에 각 대상 — 크립토 프로젝트, KOL 에이전시, 솔로 KOL, 투자자 — 이 봇에서 무엇을 얻는지 전체적으로 알아보려면 X Bot overview를 읽어보세요.