X Bot 지원: 문제 해결, FAQ & 문의 가이드
대부분의 문제는 /setup 조작 한 번으로 해결됩니다. 이 페이지의 전반부는 자가 진단 흐름을 안내하고, 후반부는 FAQ입니다. 둘 다 해결되지 않으면 하단의 문의 폼이 BWS 개발자 지원 채널로 바로 연결됩니다.
먼저 — 자가 진단 흐름
채팅에서 /setup → ℹ️ About을 여세요.
└─ 그 텍스트를 복사하세요. 지원팀이 문제를 파악하는 데 필요한 전부입니다.
그런 다음 순서대로 자문해 보세요:
1. 봇이 /setup에 응답하는가?
├─ 아니오 → 봇이 관리자에서 강퇴되거나 강등됨 → 재승격 후 재시도
└─ 예 → 계속.
2. /setup → 📊 Reports → ⚡ Generate report now가 3분 이내에
무언가를 생성했는가?
├─ DM 없음, 게시물 없음 → 다음 질문 확인.
├─ DM "게시물을 찾지 못함" → 필터가 너무 좁거나 온토픽 게시물이 없음;
실제 X API 쿼리를 확인하려면
/setup → 🎯 Filters.
├─ DM "크레딧 소진" → /setup → 💳 Buy Credits → 💰 Buy.
├─ 게시물은 왔지만 이미지가 이상함 → 재실행하세요. 지속되면
채팅 ID와 함께 지원팀에 문의하세요.
└─ 게시물이 정상적으로 도착함 → 문제 없음.
3. 예약 리포트가 오는가?
├─ 아니오 → /setup 상단 화면이 크론을 보여줍니다. 실제 UTC 시각과 비교하세요.
봇의 첫 예약 실행은 설정 직후가 아니라 다음 크론 틱
이후에 발생합니다.
└─ 예 → 모두 정상.이 중 어느 것도 해결되지 않으면 FAQ를 지나 문의 링크로 이동하세요.
FAQ — 자주 묻는 질문
설정 & 설치
Q. 봇을 추가했는데 응답하지 않아요. "멤버"가 아니라 관리자로 승격되었는지 확인하세요. 텔레그램 → 그룹 설정 → 관리자. 재승격은 즉시 적용되며 봇을 재설치할 필요는 없습니다.
Q. 봇을 다른 그룹으로 옮길 수 있나요? 네 — 새 그룹에 추가하고 그곳에서 /setup을 실행하세요. 두 채팅은 독립적입니다(서로 다른 채팅 ID = 서로 다른 설정, 일정, 점수). 채팅 간 데이터 마이그레이션은 없습니다.
Q. 봇이 메인 스레드에 리포트를 게시하는데, 제 그룹에는 토픽이 있어요 — 리디렉션할 수 있나요? 원하는 포럼 토픽 안에서 다음을 전송하세요:
/set_topic Reports이후 리포트는 해당 토픽으로 라우팅됩니다. /set_topic clear로 초기화할 수 있습니다.
Q. 어떻게 제거하나요?
- 먼저 리포트를 중단하세요:
/setup→ ⏰ Schedule → ✕ Disable schedule. - 봇을 제거하세요: 텔레그램 → 그룹 → 관리자 →
@BWS_X_Bot강퇴. - 설정은 데이터베이스에 남습니다. 같은 채팅 ID에 봇을 다시 추가하면 모든 것이 재개됩니다. 완전 삭제는 지원팀에 요청하세요.
리포트 & 필터링
Q. 왜 제 수치가 서드파티 트래커와 다른가요? X Bot은 공식 X API에서 직접 가져옵니다. 대부분의 서드파티 트래커는 스크래핑하거나 추정합니다 — 실제로 20~50%의 오차를 측정했습니다. X API 수치가 진실의 원천입니다.
Q. 리더보드에 예상하지 못한 사용자가 표시돼요. 필터는 합산 방식입니다. 채팅이 $YOUR_TOKEN 캐시태그를 추적하면, 여러분이 나열한 계정뿐 아니라 그 캐시태그를 트윗하는 누구나 순위에 오릅니다. 계정과 캐시태그를 모두 요구하려면 /set_x_filtering을 통해 from:@x cashtags:$YOUR_TOKEN 형식(명명된 필터의 전체-AND 의미론)을 사용하세요.
Q. 리포트에 "게시물 0건"이라고 나와요 — 이제 어떻게 하죠? 가능성이 높은 순서대로 세 가지입니다:
- 필터가 너무 좁음 —
/setup→ 🎯 Filters가 실제 X API 쿼리를 보여줍니다. 흔한 오타:$BTC(끝에 공백) vs$BTC. - 기간이 너무 좁음 — 사용자 지정 기간을 설정했다면 그 범위 밖의 게시물은 카운트되지 않습니다.
/setup→ 📊 Reports → 🗑 Clear period로 롤링 24시간으로 되돌리세요. - 추적 중인 계정이 실제로 24시간 동안 온토픽 게시를 하지 않음 — 폴백 신호로 캐시태그나 키워드를 추가해 확장하세요.
Q. 비공개/보호된 X 계정을 추적할 수 있나요? 아니요 — X API는 공개 게시물만 반환합니다.
Q. 채팅 리더보드에서 특정 사용자(예: 스팸봇)를 제외할 수 있나요? 네: /setup → 🎯 Filters → 🙈 Ignore → ➕ Add. 나열된 핸들은 가져오기 이후 결과에서 제외됩니다.
Q. 왜 제 채팅에는 하루 여러 번 리포트 발동이 있나요? 다중 발동 크론(cron(0 14,22 ? * * *))을 설정했거나, 같은 일정에서 여러 개의 명명된 필터가 운영되고 있을 수 있습니다. 각 명명된 필터는 자체 리포트를 생성합니다.
Q. "Best Tweet" 선정이 이상해 보여요. AI 선택기는 최근에 선택되지 않은 게시물 중 참여도가 가장 높은 것을 고릅니다. 결과가 계속 이상하게 느껴지면 지원팀에 문의하세요 — 프롬프트는 조정 가능합니다.
X Posts Auto-relay
Q. 릴레이가 6개짜리 스레드를 한 번에 전달했어요. 첫 번째만 원했는데요. X API의 exclude=replies는 다른 사용자에 대한 답글만 필터링합니다. 자기 답글(스레드 연속)은 이를 우회합니다. /setup → 📡 X Posts Auto-relay → @account → ☐ Thread continuations를 off로 전환하세요. 그러면 봇은 각 스레드의 첫 트윗만 유지합니다.
Q. 릴레이가 하루 중간에 전달을 멈췄어요. 릴레이별 화면을 확인하세요 — Today: 10/10 forwarded라면 일일 한도에 도달한 것입니다. ✏️ Cap을 탭해 올리세요. 자정 UTC에 한도가 자동 초기화됩니다.
Q. 릴레이가 ⏸ Paused로 표시되는데 일시정지한 적이 없어요. 텔레그램 채팅-없음 오류(강퇴/차단/채팅 업그레이드)로 봇이 자동으로 일시정지하며 폴링 일정을 중단합니다. 봇을 다시 추가할 경우를 대비해 /setup → 📡 X Posts Auto-relay에 해당 행이 표시됩니다.
결제 & 크레딧
Q. "크레딧"이 정확히 뭔가요? 크레딧 하나는 X API가 반환한 게시물 하나입니다. FREE 채팅은 월 100개의 무료 크레딧을 받으며, PRO 채팅은 Stripe(구독) 또는 ETH(크레딧 팩)로 청구됩니다.
Q. 크레딧 잔액은 어디서 확인하나요?/setup → 💳 Buy Credits. 사용량/잔여량/초기화 날짜가 표시됩니다.
Q. 방금 결제했는데 잔액/요금제가 업데이트되지 않았어요.
- Stripe 경로(카드 구독): 웹훅은 보통 몇 초 안에 PRO를 활성화합니다. 5분 이상 지나도
/setup→ 💳 Buy Credits에PRO ✓가 보이지 않으면 Stripe 영수증과 채팅 ID를 첨부해 지원팀에 문의하세요. - ETH 경로(크레딧 팩): 온체인 확인에는 1~3분이 걸릴 수 있습니다. 10분 후에도 크레딧이 표시되지 않으면 트랜잭션 해시와 채팅 ID를 첨부해 지원팀에 문의하세요.
Q. 한 채팅에 Stripe 구독과 ETH 크레딧을 동시에 가질 수 있나요? 네 — 함께 계층화됩니다. 구독한 PRO·크레딧 채팅은 기존 ETH 잔액을 유지하며, 가져오기당 청구는 구독의 월간 지급분보다 ETH 크레딧을 먼저 소진합니다. 실질적 효과: ETH 크레딧 5,000개를 보유한 채 구독하면 처음 5,000건의 가져오기는 Stripe를 전혀 건드리지 않습니다. 이후 가져오기는 구독의 월 1,000건 지급분을 사용합니다. 그 이상은 게시물당 $0.02 미터링 초과분입니다. ETH 잔액은 만료되지 않습니다.
유일한 제약: 이미 PRO·구독 중인 채팅은 같은 구매 흐름에서 새 ETH 팩을 추가할 수 없습니다(구매 명령이 이를 차단합니다). 크레딧 전용으로 돌아가려면 먼저 구독을 취소하세요.
Q. PRO·크레딧 잔액이 0이 되면 어떻게 되나요? 라이선스가 자동으로 FREE로 강등됩니다. 봇은 월 100건 FREE 한도가 소진될 때까지 계속 가져옵니다. 이후 /setup → 💳 → 💰 Buy가 두 경로를 다시 제공합니다.
Q. 크레딧 잔액은 채팅별인가요, 사용자별인가요? 채팅별입니다. 각 텔레그램 그룹은 자체 크레딧과 라이선스를 가집니다.
공개 대시보드
Q. 제 프로젝트가 xbot.ninja에 표시되지 않아요.당월 안에 세 가지 기준을 모두 충족해야 합니다:
- 최고 사용자 점수 ≥ 300
- 추적된 게시물 ≥ 5
- 활성 사용자 ≥ 2
보통 첫 달이 병목입니다. 직접 URL https://xbot.ninja/?chatId=<your-id>는 그와 무관하게 작동합니다.
Q. 제 채팅 ID는 어떻게 찾나요?/setup → ℹ️ About. 음수로 시작하는 긴 정수입니다.
Q. 공개 xbot.ninja 카드를 커스터마이즈할 수 있나요?/setup → 🎨 Customization. 이름, 설명, 로고, URL을 설정하세요. 다음 리포트 주기에 카드가 갱신됩니다.
X API 특이사항
Q. 왜 예상보다 오래된 게시물이 카운트되나요? 봇은 tweets/search/all(전체 아카이브 엔드포인트)을 사용합니다. 기간을 설정하면 봇은 그 안의 어느 시점의 게시물이든 가져올 수 있습니다. 기본값은 롤링 24시간이지만, 사용자 지정 기간은 과거로 소급될 수 있습니다.
Q. 가끔 릴레이에 게시물이 5분 이상 지나서 나타나요. X Posts Auto-relay는 5분마다 폴링합니다. 지연은 최대 폴링 간격 하나만큼(평균 약 2.5분 / 최악 약 5분) 발생할 수 있으며, 여기에 X API와 텔레그램 전달의 짧은 지연이 더해집니다.
Q. X API가 오류를 반환하면 운영자에게 무엇이 보이나요? 내부 오류 카운터가 증가하며, 지정된 관리자가 비공개 DM을 받습니다(/setup → 👥 Admins에서 수신자 설정). 흔한 4xx 코드: 401/403(운영자 측 자격 증명), 402(크레딧 소진), 429(속도 제한 — 봇이 백오프하며 재시도).
지원 요청에 포함할 내용
아래 템플릿을 복사해서 사용하세요:
Project: <your project name>
Chat ID: <from /setup → ℹ️ About>
Plan: FREE / PRO·credits / PRO·sub
What's wrong: <1–2 sentences>
What you tried: </setup → … → … steps you ran>
When it broke: <approx UTC time>
Recent change: <any new filter / schedule / payment in the last 24 h>채팅 ID 하나만으로도 지원팀에게 문제 파악 정보의 80%가 전달됩니다 — 항상 포함해 주세요.
예상 응답 시간
- 긴급: 봇 전체 오프라인, 결제 실패 → EU+US 업무 시간 겹침 구간 기준 1영업시간 이내 응답
- 높음: 특정 채팅의 리포트 미전송 → 당일 이내
- 일반: 기능 문의, 설정 도움 → 1~2영업일 이내
유용한 링크
- 텔레그램 봇: @BWS_X_Bot
- 공개 대시보드: xbot.ninja
- 문서: /docs/
- GitHub 이슈: blockchain-web-services/bws-api-telegram-xbot
- 직접 지원: bws.ninja — BWS 개발자 지원팀으로 연결되는 문의 폼
지원팀에 문의하기 전에 Troubleshooting 자가 진단 흐름을 먼저 확인해 보세요 — 대부분의 문제는 처음 두 가지 확인에서 해결됩니다.