빠른 시작 가이드
뚜봇 사용 중 자주 묻는 질문과 답변을 모았어요. 원하는 답변을 못 찾으셨다면 디스코드에서 질문해주세요!
봇 초대/입장
Q: 봇을 어떻게 넣나요?
A: 대시보드에 네이버 계정으로 로그인하고 치지직 채널을 연동한 뒤, [뚜봇 초대하기] 를 누르면 돼요.
예전처럼 치지직 커뮤니티에 봇 입장을 희망합니다. 댓글을 다는 방식은 이제는 쓰지 않아요.
Q: 봇이 채널에 입장하지 않아요
A: 다음 사항을 확인해보세요:
- 스트리머 본인 계정으로 로그인했는지 확인 (매니저는 봇을 넣을 수 없어요)
- 치지직 계정 연동이 되어 있는지 확인
- 이미 봇이 입장한 상태인지 확인 (
!업타임명령어로 테스트)
문제가 지속되면 디스코드로 문의해주세요.
Q: 봇을 채널에서 퇴장시키고 싶어요
A: 채팅창에서 !퇴장 명령어를 사용하면 돼요.
!퇴장
스트리머만 사용할 수 있어요. 명령어를 입력하면 인증번호가 나오고, !퇴장 [인증번호]를 입력하면 봇이 퇴장해요.
주의
봇이 퇴장하면 명령어·변수 기능이 전부 꺼지고, 채널이 대시보드 목록에서 사라져요. 봇도 채팅방에서 나가요.
기록 자체는 남아 있어서, 나중에 봇을 다시 초대하면 예전 명령어와 출석 기록이 그대로 돌아와요. (봇은 퇴장할 때 "데이터(변수, 명령어 등)이 제거되었습니다" 라고 안내하지만 실제로는 기능만 꺼지는 것이에요)
그래도 채널이 목록에서 사라져 대시보드로 손댈 수 없게 되니, 잠깐 쉬는 거라면
!퇴장 대신 필요한 기능만 개별로 꺼두시는 걸 권해요.
Q: 봇 UID가 뭔가요?
A: 봇에게 권한을 부여할 때 필요한 고유 식별자예요.
뚜봇 UID 목록:
| 봇 이름 | UID |
|---|---|
| 뚜봇 | f61127606edd1902e89f7e9cace91059 |
| 뚜이봇 | 7539c7aff49cb4b33f2cac6824d3d0e1 |
| 뚜삼봇 | 62e27807733d3e011866db387f49027b |
| 뚜사봇 | ee144a96804e71430ad25f5cd46f360a |
| 뚜오봇 | afe0c98ec9a277c17f0ac110a9159cf5 |
| 뚜육봇 | 5224cfe7d9a0e8ac84582f934df0d4a4 |
| 뚜칠봇 | 22cdbe7a2e5d6736e1a1c033409cbeb2 |
| 뚜팔봇 | eea5d291b388f7ef8ba966d77006d35a |
| 뚜구봇 | 8e0508081382ebce3b547037cf436fa3 |
어떤 봇이 입장했는지는 디스코드에서 확인하거나, 대시보드에서 확인할 수 있어요.
Q: 어떤 봇에게 권한을 줘야 하나요?
A: 내 채널에 입장한 봇에게 권한을 부여하면 돼요.
봇이 처음 입장하면 채팅에 이렇게 나와요.
봇 입장을 희망하셔서, '뚜봇' 이(가) 입장하였습니다.
여기서 봇 이름을 확인하고, 위 UID 목록에서 해당 봇의 UID를 찾아 권한을 부여하세요.
기능이 작동하지 않아요
Q: 후원했는데 룰렛이 안 돌아가요
A: 가장 흔한 원인은 후원 금액이 숨겨져 있는 것이에요.
뚜봇은 치지직이 보내주는 후원 이벤트를 직접 받아요. 다만 금액을 가려두면 봇에게는 0원으로 들어와서 룰렛 금액과 맞춰볼 수가 없어요.
익명 후원도 룰렛은 정상적으로 돌아가고 익명의 후원자 로 기록에 남아요.
봇에게 채널 관리자 권한이 있으면 익명 후원이어도 실제 후원자 신원까지 기록돼요.
익명이 아예 배제되는 건 참여 제한(리밋)이 걸린 룰렛 하나뿐이에요.
해결 방법 — 아래 중 하나를 하시면 돼요.
- 사용 중인 뚜봇에게 채널 관리자 권한 부여
- 우회 권한(채널 관리자) 신청
- 디스코드에서
#팔로우알림-우회-신청작성
그 외에 확인할 것:
- 룰렛 확률 합계가 100% 인지 (합이 안 맞으면 후원·명령어로는 조용히 실패해요)
- 후원 금액이 룰렛 금액과 정확히 일치하는지 (1,000치즈 룰렛에 1,500치즈는 발동 안 함)
- 단 연차를 설정해뒀다면 별도로 지정한 금액도 인식하고, 자동 연차를 켜뒀다면 배수 금액도 인식해요 (1,000치즈 룰렛에 2,000치즈 → 2회)
- 룰렛 스위치가 켜져 있는지
Q: "다른 봇이 감지되어 ○○을 켤 수 없습니다"라고 나와요
A: 채널에 다른 챗봇이 함께 들어와 있으면 일부 기능이 막혀요. 알림이 중복으로 나가는 것을 막기 위한 장치예요.
막히는 기능
- 팔로우 알림 켜기
- 게임 티어 조회 (
$game_tier:) - 게임 닉네임 조회 (
$game_nick:) - 신청곡
- 노래방
- 스포티파이 신청곡 (
$spotify-song-requests)
이미 켜둔 것도 자동으로 꺼져요
다른 봇이 처음 감지되는 순간, 뚜봇이 팔로우 알림 · 신청곡 명령어 · 룰렛 자동 연차 · 룰렛 연차 설정을 스스로 꺼요. 무엇을 껐는지는 채팅으로 알려줘요.
다른 봇을 내보낸 뒤에는 껐던 것들을 직접 다시 켜주셔야 해요.
다른 봇을 내보낸 뒤 다시 시도해보세요. 오류라고 생각되시면 디스코드로 문의해주세요.
Q: 오버레이가 화면에 안 보여요
A: 순서대로 확인해보세요.
- 설정 후 저장을 눌렀나요?
- 주소 복사 버튼으로 복사한 주소를 넣었나요?
- OBS 브라우저 소스의 너비·높이가 0은 아닌가요?
- 소스가 다른 소스에 가려져 있진 않나요? (소스 순서를 위로)
- 해당 기능 자체가 켜져 있나요? (예: 팔로우 알림 오버레이는
!팔로우알림 켜기가 선행되어야 해요)
Q: 오버레이 주소를 방송에 보여줘도 되나요?
A: 절대 안 돼요. 주소를 아는 사람은 누구나 그 오버레이를 열어볼 수 있어요.
그래서 뚜봇은 주소를 기본적으로 가려두고, 클릭해서 확인한 뒤 20초가 지나면 자동으로 다시 가려요. 방송 화면에 주소가 잡히지 않도록 주의해주세요.
권한 설정
Q: 권한 슬롯이 가득 찼어요
A: 한도는 내 채널이 아니라 봇 계정 쪽에 걸려 있어요. 치지직은 한 계정이 받을 수 있는 매니저 권한을 100개로 제한해요.
이 계정은 너무 많은 채널들의 관리자로 등록되어 있어 더 이상 추가할 수 없습니다
그래서 내 채널에서 다른 계정의 권한을 풀어도 해결되지 않아요. 이미 꽉 찬 건 뚜봇 계정 쪽이니까요.
해결 방법: 아직 자리가 남은 다른 뚜봇(뚜육봇 · 뚜칠봇 등)에 권한을 주거나, 우회 계정을 이용하세요. 자세한 방법 →
Q: '채널 관리자' 권한은 어떻게 부여하나요?
A: 채널 관리자 권한은 채널 소유자(스트리머)만 부여할 수 있어요.
Q: '채팅 운영자' 권한은 어떻게 부여하나요?
A: 채팅 운영자 권한은 스트리머 또는 채널 관리자가 부여할 수 있어요.
명령어
Q: 명령어가 작동하지 않아요
A: 다음 사항을 확인해보세요:
- 명령어 접두사(
!)를 올바르게 입력했는지 확인 - 해당 명령어가 활성화되어 있는지 대시보드에서 확인
- 권한이 필요한 명령어인 경우 봇에게 권한이 있는지 확인
- 봇이 채널에 입장해 있는지 확인 (
!업타임으로 테스트)
Q: 커스텀 명령어는 어떻게 추가하나요?
A: 두 가지 방법이 있어요:
방법 1: 채팅창에서 추가
!추가 !인사 안녕하세요! 반갑습니다 :>
방법 2: 대시보드에서 추가
- 대시보드 접속
- 좌측 뚜봇 관리 → 유저 명령어 클릭
- 목록 오른쪽 위 추가 버튼 클릭
- 명령어와 응답을 넣고 추가 클릭
Q: 변수가 작동하지 않아요
A: 다음 사항을 확인해보세요:
- 변수 이름이 정확한지 확인 (대소문자 구분)
$기호가 앞에 붙어있는지 확인:이 들어간 변수는 뒤에 띄어쓰기가 필요해요- ✅
$countdown:2025-12-25 메리크리스마스! - ❌
$countdown:2025-12-25메리크리스마스!
- ✅
대시보드
Q: 대시보드 로그인이 안 돼요
A: 다음 사항을 확인해보세요:
- 네이버 계정으로 로그인 중인지 확인 (대시보드 로그인은 네이버 계정을 사용해요)
- 브라우저 쿠키/캐시 삭제 후 재시도
- 다른 브라우저로 시도
- 시크릿 모드(프라이빗 모드)로 시도
네이버 로그인 vs 치지직 연동
- 네이버 로그인: 대시보드 계정 인증용
- 치지직 연동: 채널 소유권 확인용. 스트리머 본인은 치지직 로그인(OAuth) 으로만 확인해요
- 채팅창 인증 코드: 매니저가 권한을 받을 때 쓰는 경로예요.
!인증이 매니저 전용 명령어라 구독자는 쓸 수 없어요. 스트리머도 이 방법을 쓸 수 없어요 (스트리머는 해당 방법으로 인증할 수 없습니다. 치지직 로그인을 이용해주세요.)
Q: 설정을 변경했는데 적용이 안 돼요
A: 설정 변경 후 '저장' 버튼을 눌렀는지 확인해보세요. 일부 설정은 적용까지 시간이 걸릴 수 있어요 (최대 1분).
Q: UID는 어디서 확인하나요?
A: UID를 확인하는 방법:
- 치지직에서 원하는 사용자의 프로필 클릭
- 주소창에서
chzzk.naver.com/뒤의 문자열이 UID예요
예시:
- 주소:
https://chzzk.naver.com/f61127606edd1902e89f7e9cace91059 - UID:
f61127606edd1902e89f7e9cace91059
기능
Q: 이미 출석한 시청자에게 다른 메시지를 보여주고 싶어요
A: $att_check 변수와 삼항 연산자를 사용하면 중복 출석 시 다른 메시지를 보여줄 수 있어요.
!추가 !출석 #ternary:$att_check==True?$nick님 $att_add번 출석!:$nick님 오늘은 이미 출석하셨어요!
$att_check는 출석 가능 여부를 반환해요. True면 출석 가능(아직 안 함), False면 이미 출석한 상태예요.
방송이 꺼져 있을 때
$att_check 는 방송 여부를 보지 않아요. 방송이 꺼져 있어도 True 를 돌려줘요.
정작 출석을 처리하는 $att_add 는 방송이 꺼져 있으면 [방송이 꺼져있습니다.] 를 반환해요.
그래서 방송 종료 중에 위 명령어를 치면 홍길동님 [방송이 꺼져있습니다.]번 출석! 처럼 어색하게 나와요.
Q: 신청곡 기능이 작동하지 않아요
A: 다음 사항을 확인해보세요:
- 대시보드에서 신청곡 기능이 활성화되어 있는지 확인
$song-requests변수가 포함된 명령어가 있는지 확인- 신청곡 대기열이 가득 찼는지 확인
기타
Q: 버그를 발견했어요 / 기능 제안을 하고 싶어요
A: 디스코드 서버에서 제보해주세요.
Q: 연령제한을 켰더니 뚜사봇, 뚜오봇이 작동하지 않아요!
A: 뚜사봇, 뚜오봇, 뚜구봇은 실명 인증이 되지 않아서 연령 제한 방송에 접근할 수 없어요.
연령 제한 방송에서는 뚜봇, 뚜이봇, 뚜삼봇, 뚜육봇, 뚜칠봇, 뚜팔봇 중 하나를 사용해주세요.
연령 제한 방송에서 사용 가능한 봇으로 변경하려면 디스코드에서 요청해주세요.
더 많은 도움이 필요하신가요?
디스코드 서버에서 실시간으로 도움을 받을 수 있어요.