시작하기
빠른 시작
기본 설정 순서
-
01봇 초대초대 링크로 서버에 봇을 추가합니다.
Administrator권한을 허용해야 모든 기능이 정상 작동합니다. -
02인증 시스템 설정대시보드 → 웹인증 탭에서 인증 방식(v1 · v2 · v2.1)과 인증 채널 · 역할을 정하고 저장하세요. 보안이 중요한 서버라면 웹인증 v2를 권장합니다. 같은 탭 「04 인증 패널」에서 인증 버튼을 배치하세요.
-
03처벌 기록 · 이의제기 채널 설정
/처벌기록설정실행 후 뜨는 패널에서 채널 선택창으로 처벌 로그 채널과 이의제기 채널을 각각 지정하세요. 모든 제재 내역과 이의제기 알림이 한 명령어로 관리됩니다. -
04경고 시스템 설정
/경고 설정으로 경고 권한 역할, 자동 추방 횟수, 횟수별 역할 자동 부여를 설정하세요. -
05레벨 시스템 설정대시보드 → 레벨 탭의 레벨 역할에서 레벨마다 줄 역할을 정하고 켜세요(기본 꺼짐 · 최대 30개). 채팅과 음성 활동으로 XP가 자동 적립됩니다.
-
06대시보드 확인대시보드에서 인증 현황·보안 이벤트·경고 내역을 실시간으로 확인하고 관리할 수 있습니다.
추천 설정 조합
서버 규모와 목적에 따라 아래 조합을 참고하세요.
| 서버 유형 | 추천 인증 | 추가 설정 |
|---|---|---|
| 소규모 커뮤니티 | 웹인증 v1 | 경고 시스템 + 레벨 |
| 중규모 커뮤니티 | 웹인증 v2 | 경고 + 레벨 + 티켓 |
| 대규모 / 공개 서버 | 웹인증 v2 + 통합보안 | 블랙리스트 + 자동추방 + 서버로그 |
| 게임 커뮤니티 | 웹인증 v1 | 게임공지 알림 + 범프 알림 + 레벨 |
필수 봇 권한
Administrator 권한은 사실상 필수입니다. 레벨·경고·티켓·블랙리스트·생일 알림·범프 알림·서버업 알림·음성채널 관리·웹 보안 인증(웹인증 v1/v2)을 포함한 대부분의 핵심 기능이 해나봇에게 서버 관리자 권한이 없으면 해당 서버에서 아예 동작하지 않고, 명령어 실행 시 권한을 활성화해달라는 안내만 표시됩니다. 아래 개별 권한은 Administrator를 줄 수 없는 특수한 상황에서 최소한으로 필요한 항목을 참고용으로 정리한 것입니다.
| 권한 | 필요 기능 | 없을 때 |
|---|---|---|
| Administrator | 레벨·경고·티켓·블랙리스트·생일·범프·서버업·음성채널·웹 보안 인증 등 대부분의 핵심 기능 | 해당 기능 전체가 서버에서 작동하지 않음(명령어 실행 시 권한 활성화 안내만 표시) |
| Ban Members | /차단 | 차단 불가 |
| Kick Members | /추방 | 추방 불가 |
| Moderate Members | /타임아웃 | 타임아웃 불가 |
| Manage Roles | 역할 자동 부여 (레벨·경고) | 역할 지급 불가 |
| Manage Messages | /청소 | 메시지 삭제 불가 |
| View Audit Log | 보안 이벤트 감지 | 감지 정확도 저하 |
자주 하는 실수
- 봇 관리자 권한 미부여 — 서버 설정 → 역할에서 해나봇 역할의 관리자(Administrator) 권한을 활성화하지 않으면 레벨·경고·티켓·블랙리스트·웹 보안 인증 등 핵심 기능 대부분이 통째로 동작하지 않습니다. 초대 직후 반드시 가장 먼저 확인하세요.
- 봇 역할 순서 — 봇 역할이 관리하려는 멤버 역할보다 위에 있어야 역할 지급·제재가 작동합니다.
- 인증 역할 미설정 — 대시보드 웹인증 탭 「02 입장」에서 "인증 완료 역할"을 반드시 지정해야 합니다.
- 슬래시 커맨드 미표시 — 봇 재초대 또는 봇 재시작 후 잠시 기다리면 커맨드가 표시됩니다.
- 처벌 기록 채널 미설정 —
/처벌기록설정을 설정하지 않으면 차단·경고 로그가 기록되지 않습니다.
파트너 서버