요금제

X Bot은 대부분의 커뮤니티에게 무료입니다. 사용량이 많은 사용자에게는 두 가지 경로가 있습니다 — 신용카드 구독(정기 결제; 월 1,000건 이상 게시물을 다루는 채팅이라면 더 저렴함) 또는 ETH 크레딧 팩(일회성, 만료 없음). 둘은 깔끔하게 함께 사용할 수 있습니다. 1 크레딧 = API가 반환한 X 게시물 1건.

요약 — FREE(월 100건 게시물, 카드 불필요)로 시작하세요. 규모가 커지면: Stripe로 구독하거나(월 $19, 첫 1,000건 무료, 이후 게시물당 $0.02 미터링 초과 요금), 또는 ETH 크레딧 팩을 구매하세요(크레딧당 $0.02, 1,000~100,000까지의 팩, 만료 없음). 둘은 깔끔하게 함께 사용됩니다 — 한 채팅이 ETH 크레딧과 Stripe 구독을 동시에 가질 수 있으며, 가져오기당 청구는 ETH 크레딧을 먼저 소진하고, 그다음 구독의 월간 지급분, 그다음 미터링 초과분 순으로 처리됩니다.

3번의 탭으로 구매 또는 업그레이드: /setup → 💳 Buy Credits

전체 구매 흐름은 텔레그램 안에서 이루어집니다. 요금이나 잔액을 확인하러 봇을 벗어날 필요가 없습니다.

채팅에서

1. /setup → 💳 Buy Credits를 엽니다.
2. 💰 Buy credits / upgrade를 탭합니다.
3. 봇이 결제 옵션 카드로 응답합니다. 표시되는 옵션은 현재 요금제에 따라 다릅니다:

현재 요금제	표시되는 옵션
FREE	둘 다 — Stripe 구독 또는 ETH 크레딧 팩
PRO · 크레딧(기존 ETH 잔액 있음)	둘 다 — ETH로 계속 충전하거나, 그 위에 Stripe 구독을 쌓을 수 있음(기존 ETH 크레딧은 유지되며 가져오기당 먼저 소진됨)
PRO · 구독(기존 Stripe 구독 있음)	카드 관리 화면으로 이동 — 이미 미터링 요금제이므로 추가 구매 불필요

4. 경로를 선택하세요:

경로 A — Stripe 구독(FREE 채팅 → PRO 구독)

1. 💳 Pay with Credit Card를 탭합니다.
2. 봇이 Stripe Checkout 세션을 생성하고 결제 링크 버튼으로 응답합니다.
3. 버튼을 탭하면 브라우저에서 Stripe Checkout이 열립니다.
4. 카드 정보를 입력하고 결제를 완료합니다.
5. Stripe가 텔레그램으로 다시 리디렉션합니다(https://t.me/BWS_X_Bot?start=payment_success_<chatId>).
6. Stripe의 웹훅이 몇 초 안에 봇의 활성화 핸들러를 발동시킵니다 — /setup → 💳 Buy Credits에 이제 PRO ✓(구독)가 표시됩니다.
7. 봇이 채팅의 지정 관리자에게 활성화 확인 DM을 보냅니다.

청구 내역:

• 구독이 활성화되어 있는 동안 매월 기본 $19(다음 달 첫날에 청구되며, 이후 일할 계산).
• 당월 1,000건을 초과한 모든 가져온 게시물에 대해 게시물당 $0.02 — Stripe 미터링으로 해당 월 인보이스에 추가됨.
• 매월 첫 1,000건은 기본 요금에 포함됩니다 — 이월 가능한 크레딧 잔액이 아니라 무료 임계값입니다.

언제든 취소 — /setup → 💳 Buy Credits → 🛠 Manage subscription을 열면 Stripe 고객 포털이 열립니다. 취소는 현재 결제 주기가 끝날 때 적용되며, 그 전까지는 동일한 미터링 규칙으로 PRO 상태가 유지됩니다.

경로 B — ETH 크레딧 팩(FREE → PRO·크레딧, 또는 PRO·크레딧 → 충전)

1. 🪙 Pay with ETH를 탭합니다.

2. 봇이 약 15분간 유효한 단기 구매 세션을 생성하고 링크 버튼으로 응답합니다.

3. 탭하면 브라우저에서 xbot.ninja/buy-ethereum.html이 열립니다.

4. 지갑을 연결하세요(MetaMask, WalletConnect 등).

5. 드롭다운에서 크레딧 팩을 선택합니다:

   팩 크기	가격(USD)
   1,000 크레딧	$20
   2,000 크레딧	$40
   3,000 크레딧	$60
   4,000 크레딧	$80
   5,000 크레딧	$100
   10,000 크레딧	$200
   50,000 크레딧	$1,000
   100,000 크레딧	$2,000

6. 페이지가 현재 시세 기준 ETH 환산 금액을 보여줍니다.

7. 트랜잭션에 서명하세요. 자금은 이더리움 메인넷의 BWS 트레저리 컨트랙트로 전송됩니다.

8. 온체인 확인이 완료되면 백엔드가 여러분의 채팅에 크레딧을 지급합니다. /setup → 💳 Buy Credits에서 Credits remaining: <balance>로 확인할 수 있습니다.

청구 내역: 정기 결제 없음. 팩당 한 번만 지불하며, ETH만 결제 수단으로 사용됩니다.

나중에 충전하기: 동일한 흐름입니다 — 같은 드롭다운에서 다른 팩을 선택하세요. 기존 크레딧에 새 팩 수량이 더해집니다. 크레딧은 만료되지 않습니다.

경로 A와 경로 B는 깔끔하게 함께 사용됩니다

한 채팅이 둘 다 동시에 보유할 수 있습니다. 가져오기당 청구는 다음 순서로 잔액을 소진합니다:

1. ETH 크레딧 먼저(LICENSES.REMAINING_CREDITS의 원자적 차감).
2. 구독의 월간 지급분(PRO·구독의 무료 1,000건).
3. Stripe 미터링 초과분(지급분 초과 시 게시물당 $0.02).

ETH 크레딧 5,000개를 보유한 상태에서 구독하면, 이후 5,000건의 가져오기는 크레딧을 소비합니다(Stripe 청구 없음). 5,001~6,000번째 가져오기는 구독의 월간 지급분을 사용합니다. 6,001번째부터는 미터링됩니다. ETH 잔액은 업그레이드 후에도 유지됩니다.

남아있는 유일한 제약: 이미 PRO·구독 중인 채팅은 오늘 ETH 팩을 추가할 수 없습니다(구매 흐름이 이를 차단합니다). 크레딧 전용 결제로 전환하려면 먼저 구독을 취소하세요.

구매 후

크레딧 잔액과 요금제는 언제든 확인할 수 있습니다:

/setup → 💳 Buy Credits

💳 Buy Credits & Plan

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

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

(Stripe 구독 채팅의 경우, 크레딧 잔액 없이 Plan: PRO (subscription) ✓ 줄이 표시됩니다 — 사용량은 저장된 카운트가 아니라 미터링됩니다. 📊 Usage this month는 미터링 임계값을 산정하는 실행 중인 fetched_posts 카운터를 보여줍니다.)

요금제 한눈에 보기

	FREE	PRO 구독	PRO 크레딧(ETH)
정기 비용	$0	월 $19	$0
게시물당 비용	해당 없음 — 월 100건 하드 캡	첫 1,000건/월 $0, 초과분 게시물당 $0.02(미터링)	크레딧당 $0.02 정액
크레딧 잔액	해당 없음 — STATS 카운터만	해당 없음 — STATS 카운터 + Stripe 미터	REMAINING_CREDITS 원장
카드 필요	아니오	예(Stripe checkout)	아니오(ETH 지갑)
자동 갱신	해당 없음	매월, 언제든 취소 가능	해당 없음(일회성)
크레딧 만료	매월 100으로 초기화	해당 없음	없음
소진 시 동작	봇이 가져오기 중단; 관리자 DM	해당 없음(무제한, 청구만 됨)	FREE로 자동 강등; 봇이 월 100건 한도를 다시 적용
적합한 대상	체험 그룹, 소규모 커뮤니티, 솔로 KOL	안정적인 프로덕션 커뮤니티, 예측 가능한 월간 물량	폭발적/일회성/크립토 네이티브 팀; 만료 없는 예산으로서의 크레딧

크레딧 계산, 솔직한 버전

크레딧 하나는 API가 반환한 X 게시물 하나와 같습니다. 필터가 일일 리포트에서 47개의 게시물을 가져오면, 그것이 47 크레딧 차감(PRO·크레딧)이거나 이번 달 임계값을 향한 47건(PRO·구독)이거나 월 100건 한도를 향한 47건(FREE)입니다.

카운트되는 것:

• X API 호출이 반환한 모든 고유 트윗은 오프토픽이라 가져온 후 제외되더라도 카운트됩니다.
• X Posts Auto-relay 폴링은 대부분의 틱에서 0건을 반환하며(무료), 사용자가 실제로 게시한 틱에서는 1~10건을 반환합니다(전달된 게시물당 크레딧 1개).
• 인용 트윗은 카운트됩니다: X API에는 exclude=quotes가 없어서 봇이 이를 가져온 후 클라이언트 측에서 필터링합니다. 채팅 노이즈는 줄지만 크레딧은 절약되지 않습니다.

카운트되지 않는 것:

• 서버 측 exclude=retweets / exclude=replies — 이 게시물들은 API에서 아예 반환되지 않으므로 아무것도 차감되지 않습니다.
• 데이터 반환 전에 4xx로 실패한 요청.
• /setup → 📊 Reports → 📰 Show last report로 다시 제공되는 캐시된 게시물.

월간 필요량 산정하기

일반적인 형태:

형태	물량	최적 요금제
솔로 계정 포트폴리오, 하루 1~2건 게시	월 ~50건	FREE
소규모 커뮤니티, 팔로워 30명, 가벼운 $TOKEN 트래픽	100~300건	FREE — 또는 가끔의 급증 달을 위한 1,000크레딧 ETH 팩($20)
5-KOL 에이전시, 온토픽 전용 24시간 일일 리포트	800~1,500건	FREE의 경계 → PRO·구독. 꾸준히 1,000건을 초과한다면 구독하세요. 일회성 달이라면 ETH 팩을 사용하세요
대형 프로젝트, 해시태그 캠페인, 게시자 50명 이상	3,000~8,000건	PRO·구독: $19 + ($0.02 × 약 5,000 초과) ≈ 월 $119 — 예측 가능
헤비 auto-relay(계정 5개 × 하루 5건 × 30일)	릴레이만으로 월 750건	릴레이만이라면: 나머지가 가벼우면 FREE 유지. 리포트까지 있다면: PRO·구독

무엇을 선택할지

FREE 유지

• 커뮤니티가 월 100건 이하의 온토픽 게시물을 가짐.
• 솔로 KOL 포트폴리오(계정 하나, 낮은 빈도).
• 무비용으로 제품을 평가 중.
• 테스트/스테이징 그룹.

PRO 구독으로 전환(월 $19)

• 안정적인 프로덕션 커뮤니티 — 예측 가능한 월간 게시물 물량.
• 여러 캠페인이나 명명된 필터가 동시에 운영됨 — ETH 팩을 계속 구매하는 것보다 미터링으로 급증을 흡수하는 편이 쉬움.
• 활발한 KOL 에이전시 — 많은 클라이언트를 위한 일일 리포트.
• 크레딧 잔액을 신경 쓰고 싶지 않고 "사용한 만큼만 청구해 달라"는 경우.

ETH 크레딧 팩 구매

• 폭발적: 출시/콘테스트/캠페인 기간 동안 급증했다가 조용해질 예정.
• 일회성 프로젝트 — 5,000크레딧을 사서 여러 달에 걸쳐 사용.
• 정기 카드 인증 없이 온체인 결제를 선호하는 크립토 네이티브 팀.
• 정기 카드 청구를 허용하지 않는 컴플라이언스/회계 요건.
• 만료 없는 예산: 오늘 구매한 크레딧은 1년 후에도 여전히 사용 가능.
• 한도가 정해진 계약 — "이 캠페인은 $400로 제한, 초과 없음": 20,000 팩을 사서 지갑이 비면 완전히 멈추게 하세요.

결제 FAQ

Q. 한 채팅에 Stripe 구독과 ETH 크레딧을 동시에 가질 수 있나요?네 — 함께 계층화됩니다. Stripe로 구독한 PRO·크레딧 채팅은 ETH 잔액을 유지하며, 가져오기당 청구는 ETH 잔액을 먼저 소진하고, 그다음 구독의 월간 지급분, 그다음 나머지를 미터링합니다. 현재 유일한 제약: 이미 활성 Stripe 구독이 있는 채팅은 같은 흐름에서 ETH 팩을 추가할 수 없습니다(buy.mjs가 두 번째 구매를 차단합니다). 크레딧 전용으로 돌아가려면 먼저 구독을 취소하세요.

Q. PRO·크레딧이 0이 되면 제 채팅은 어떻게 되나요? 라이선스가 자동으로 FREE로 강등되며, 다음 가져오기부터 월 100건 한도가 적용됩니다(이는 당월의 FREE 등급 카운터도 포함합니다). 이후 봇은 다음 /buy에서 Stripe와 ETH 옵션을 모두 다시 제공합니다.

Q. PRO·구독에서 월 1,000건을 초과하면 어떻게 되나요? 미터링됩니다. Stripe는 1,000건 임계값을 초과한 게시물마다 record_usage 호출을 받으며, 다음 달 인보이스에 $0.02 × 초과분이 포함됩니다. 하드 캡도 없고 갑작스러운 중단도 없습니다 — 봇은 계속 가져오고 청구액이 늘어날 뿐입니다.

Q. 크레딧은 채팅별인가요, 사용자별인가요? 채팅별입니다. 각 텔레그램 그룹은 자체 잔액과 라이선스를 가집니다. 봇을 두 번째 그룹에 추가하면 두 번째 FREE 월 100건 한도가 생깁니다.

Q. 여러 채팅에서 하나의 구독을 공유할 수 있나요? 아니요 — 각 채팅은 자체 Stripe 고객 + 구독을 가집니다.

Q. 크레딧이 월별로 이월되나요?

• FREE: 아니요, 매월 새로 100건입니다. 미사용 100단위 크레딧은 누적되지 않습니다.
• PRO·구독의 포함된 1,000건: 아니요 — 결제 주기에 맞춰 임계값이 초기화됩니다.
• ETH로 구매한 크레딧: 네, 만료되지 않습니다. 3월에 구매한 팩은 11월에도 여전히 잔액이 남아 있습니다.

Q. 크레딧을 구매했는데 잔액이 바뀌지 않았어요?

• Stripe: 웹훅은 보통 몇 초 안에 발동합니다. 5분 이상 지나도 크레딧이 없다면 Stripe 영수증과 채팅 ID를 첨부해 지원팀에 문의하세요(/setup → ℹ️ About).
• ETH: 온체인 확인에는 1~3분이 걸릴 수 있습니다. 10분 후에도 크레딧이 표시되지 않으면 트랜잭션 해시와 채팅 ID를 첨부해 지원팀에 문의하세요.

Q. 환불받을 수 있나요? 사용하지 않은 구독 기간: 가능합니다. 지원팀에 문의하면 일할 계산해 드립니다. 이미 일부 소비된 크레딧 팩: 사안별로 다르지만, 봇이 명백히 오작동했을 때만 일반적으로 가능합니다. ETH 구매는 트랜잭션이 확인되면 환불 불가합니다(프로토콜이 되돌리지 않습니다).

Q. 관리자 화면의 "누적 결제액"이 제 영수증과 맞지 않아요. Stripe는 구독과 단건 결제를 다르게 그룹화합니다. 관리자 화면은 성공한 결제 + 완료된 인보이스를 합산합니다. ETH 구매는 포함되지 않습니다(Stripe가 아니라 온체인 트레저리로 추적됩니다). 환불은 차감되지 않습니다(별도로 표시됩니다). 감사 추적이 필요하면 Stripe Dashboard → Customers → 채팅 ID로 검색하세요.

Q. 월 중간에 구독을 취소했어요 — 언제 PRO를 잃나요? 현재 결제 주기가 끝날 때입니다. Stripe는 cancel_at_period_end: true를 설정하며, 봇의 웹훅은 실제 취소 이벤트(customer.subscription.deleted)가 발생하는 주기 종료 시점에 라이선스를 FREE로 되돌립니다.

Q. PRO의 무료 체험판이 있나요? FREE 요금제가 여러분의 체험판입니다. 월 100건은 평가하기에 충분히 넉넉하며, 테스트 중에 초과한다면 가장 작은 ETH 팩(1,000크레딧 = $20)이 가장 저렴하게 확장하는 방법입니다.

다음 단계

• Installation — 3단계로 채팅을 실행 상태로 만들기.
• The /setup menu — 전체 Subscription 화면 투어.
• Troubleshooting — 결제 관련 증상 매트릭스.
• Support — 문의 escalation 템플릿 + 응답 SLA.

각 요금제 등급이 지원하는 사용 사례(KOL 에이전시 추적, 커뮤니티 참여, 솔로 KOL 포트폴리오, 멀티 클라이언트 에이전시)는 product overview를 참고하세요.