VELTO WIKI

VeltoBot 가이드

VeltoBot은 Discord 서버를 효율적으로 관리하고 모니터링하기 위한 올인원 봇입니다. 이 가이드에서 주요 기능과 설정 방법을 안내합니다.

핵심 기능

자동 모더레이션

스팸, 도배, 금지어 등을 자동으로 감지하고 처리합니다.

티켓 시스템

카테고리 기반 지원 티켓을 생성하고 관리합니다.

실시간 알림

치지직, 유튜브, SOOP, 씨미 방송·영상 알림을 Discord에서 받을 수 있습니다.

통계 대시보드

서버 활동을 시각적으로 분석하고 추적합니다.

봇 추가하기

VeltoBot을 Discord 서버에 추가하는 방법을 안내합니다.

대시보드 접속

bot.veltostudio.com 대시보드에 Discord 계정으로 로그인합니다.

서버 선택

봇을 추가할 서버를 선택합니다. 서버의 관리자 권한이 필요합니다.

권한 승인

요청되는 봇 권한을 확인하고 승인합니다. VeltoBot은 메시지 관리, 역할 관리, 채널 관리 등의 권한이 필요합니다.

관리자 권한

봇을 추가하려면 해당 Discord 서버에서 관리자(Administrator) 권한이 있어야 합니다.

초기 설정

봇을 추가한 후 대시보드에서 기본 설정을 구성합니다.

자동 감지

VeltoBot은 서버에 추가되면 채널과 역할 목록을 자동으로 가져옵니다. 별도 동기화가 필요 없습니다.

권장 설정 순서

1. 기본 설정 — 접두사, 언어, 로그 채널 지정
2. 환영 메시지 — 입장/퇴장 메시지 및 DM 설정
3. 자동 모더레이션 — 스팸, 금지어 필터 활성화
4. 티켓 시스템 — 지원 채널 및 카테고리 구성

티켓 시스템

카테고리 기반 티켓을 생성하여 사용자 지원을 체계적으로 관리할 수 있습니다.

주요 기능

카테고리별 티켓 분류 (일반 문의, 버그 신고, 건의사항 등)
대화 기록 자동 저장 (트랜스크립트)
담당자 지정 및 티켓 상태 관리
웹 대시보드에서 전체 티켓 현황 조회

설정 방법

대시보드 → 서버 설정 → 티켓 탭에서 티켓 채널, 카테고리, 환영 메시지 등을 설정할 수 있습니다.

자동 모더레이션

스팸, 도배, 금지어, 링크 필터, 멘션 스팸 등을 자동으로 감지하고 처리합니다.

스팸 감지

동일 메시지 반복 감지

도배 감지

대량 메시지 감지

금지어 필터

설정한 금지어 자동 삭제

링크 필터

화이트리스트 기반 링크 관리

대문자 도배

70% 이상 대문자 감지

멘션 스팸

과도한 멘션 감지

처리 방식

위반 시 메시지 삭제, 경고 부여(경고 시스템 연동), 타임아웃 중 선택 가능합니다. 역할/채널/유저 단위로 예외를 설정할 수 있습니다.

로그 보관

자동 모더레이션 위반 기록은 30일간 보관된 뒤 자동으로 정리됩니다.

경고 시스템

유저에게 경고를 부여하고, 경고 횟수에 따라 자동 처벌을 설정할 수 있습니다.

자동 처벌 규칙

경고 횟수에 따라 자동으로 처벌을 적용할 수 있습니다.

경고 횟수	처벌 예시
3회	1시간 타임아웃
5회	서버 킥
7회	서버 밴

경고 만료

경고에 만료 기간을 설정할 수 있습니다. 영구 또는 N일 후 자동 만료를 선택하세요.

실시간 알림

치지직, 유튜브, SOOP, 씨미 채널을 등록하면 새 방송이나 영상이 올라올 때 Discord로 알림을 보냅니다.

치지직 알림

라이브 방송 시작을 1분 주기로 감지합니다. 채널 URL 또는 ID로 등록할 수 있습니다.

유튜브 알림

영상 업로드와 라이브 방송을 각각 감지하며(기본 10분 주기), 알림 메시지를 유형별로 개별 설정할 수 있습니다.

SOOP 알림

SOOP(구 아프리카TV) BJ의 라이브 방송 시작을 1분 주기로 감지합니다. BJ ID 또는 방송국 URL로 등록할 수 있습니다.

씨미 알림

씨미(ci.me) 크리에이터의 라이브 방송 시작을 1분 주기로 감지합니다. @닉네임 또는 프로필 URL로 등록할 수 있습니다.

채널 등록 팁

대시보드에서 URL을 붙여넣으면 채널 ID가 자동으로 추출됩니다. 등록 전 미리보기로 올바른 채널인지 확인하세요. 치지직은 라이브 URL(/live/)은 등록할 수 없으며, 채널 페이지 URL을 사용해야 합니다.

설정 방법

대시보드 → 서버 설정 → 알림 연동 그룹에서 각 플랫폼 탭(치지직 / SOOP / 씨미 / 유튜브)을 선택하고, 알림 채널과 커스텀 메시지를 설정하세요.

마인크래프트 연동

마인크래프트 서버 상태를 실시간으로 모니터링하고 Discord에 표시합니다.

모니터링 항목

서버 온라인/오프라인 상태
접속 플레이어 수
서버 버전 및 핑
상태 변경 시 Discord 채널 알림

기능 활성화 필요

마인크래프트 연동은 서버별로 기능이 활성화된 경우에만 대시보드에 표시됩니다. 필요 시 VeltoBot 운영팀에 문의하세요.

환영 메시지

새로운 멤버가 입장하거나 퇴장할 때 자동으로 메시지를 전송합니다. 채널 메시지와 DM을 각각 설정할 수 있습니다.

지원 기능

입장 환영 메시지 (채널 + Embed)
입장 DM 메시지 (서버 규칙 안내 등)
퇴장 알림 메시지
입퇴장 로그 채널 기록

변수 사용

메시지에 {{user}}, {{server}}, {{memberCount}} 등의 변수를 사용하여 동적 메시지를 작성할 수 있습니다.

공지 수신

VeltoBot 공식 공지사항과 업데이트 알림을 서버 내 지정 채널로 받을 수 있습니다.

설정 방법

대시보드 → 서버 설정 → 공지 수신 탭에서 알림을 받을 텍스트 채널을 선택하고 저장하세요.

멤버 인증

새 멤버가 버튼을 눌러 기본 역할(멤버)을 받고 서버에 접근하는 입장 인증 시스템입니다.

알아두기

인증 패널은 서버 템플릿 적용 시 자동으로 생성됩니다
대시보드 인증 탭에서는 현재 설정(채널, 부여 역할)을 확인할 수 있습니다
패널 문구·버튼을 직접 수정하려면 템플릿을 다시 적용하거나 역할 패널을 별도로 만드세요

역할 패널

역할 패널을 만들어 멤버가 버튼을 클릭하여 원하는 역할을 자유롭게 선택할 수 있습니다. 승인 워크플로우와 선행 역할(하위 역할)도 지원합니다.

주요 기능

다중 역할 패널 생성 (채널별로 여러 패널)
버튼별 역할, 라벨, 이모지, 스타일 설정
선행 역할 — 상위 역할을 먼저 받아야 하위 역할 선택 가능 (선택 후 세부 역할 버튼 표시)
승인 필요 역할 (관리자 승인 후 부여)
치지직 팔로워/구독자 인증 — 등록된 치지직 채널과 연동해 팔로워·구독자 역할 자동 부여

설정 방법

대시보드 → 서버 설정 → 역할 패널 탭에서 패널을 생성하고, 버튼을 추가한 뒤 채널에 배포하세요. 치지직 팔로워 인증은 치지직 알림에 채널이 등록되어 있어야 설정할 수 있습니다.

멤버 인증과의 차이

입장 시 필수로 눌러야 하는 멤버 인증 패널은 별도의 "인증" 탭에서 확인합니다. 인증 패널은 템플릿 적용 시 자동 생성되며, 자유 역할 선택은 역할 패널을 사용하세요.

레이드 방지

대량 가입을 감지하고 자동으로 서버를 잠금 상태로 전환합니다.

동작 방식

감지

N초 내 M명 이상 가입 시 레이드로 판정합니다.

잠금

자동으로 서버 인증 레벨을 VeryHigh로 올립니다.

차단

설정된 기간 미만의 신규 계정을 자동 킥합니다.

해제

설정된 시간 후 자동으로 잠금을 해제합니다.

채널 잠금

개별 또는 전체 채널의 메시지 전송을 차단하고, 해제 시 원래 권한으로 복원합니다.

개별 잠금

특정 채널만 선택적으로 잠금합니다.

전체 잠금

예외 채널/역할을 제외한 모든 채널을 잠급니다.

감사 로그

서버에서 발생하는 모든 이벤트를 기록하고 로그 채널에 실시간으로 전송합니다.

기록 대상

메시지 삭제/수정

채널 생성/수정/삭제

역할 생성/수정/삭제

멤버 변경

밴/밴 해제

닉네임 변경

슬로우모드 스케줄

특정 시간대에만 슬로우모드를 자동으로 적용할 수 있습니다.

항상 모드

특정 채널에 항상 슬로우모드를 적용합니다.

시간대 모드

지정 시간대에만 적용합니다. (예: 18:00~23:00)

예약 모드

특정 시점에 1회성으로 켜기/끄기 합니다.

자동 음성 채널

허브 채널에 입장하면 임시 음성 채널이 자동으로 생성되고, 모든 사용자가 퇴장하면 자동 삭제됩니다.

간편 설정

대시보드에서 허브 채널만 지정하면 자동으로 동작합니다. 채널 이름은 랜덤으로 생성됩니다.

투표/설문

다중 선택지 투표를 생성하고 Discord 채널에 Embed + 버튼으로 전송합니다.

지원 기능

최대 10개 선택지, 단일/복수 선택
익명 투표 지원
기간 설정 및 자동 종료
실시간 결과 업데이트

출석 체크

멤버가 매일 버튼을 눌러 출석을 기록할 수 있습니다. 연속 출석 추적과 보상 역할 자동 부여를 지원합니다.

주요 기능

매일 버튼 클릭으로 간편 출석
연속 출석(스트릭) 추적
N일 연속 출석 시 보상 역할 자동 부여
주간/월간/전체 랭킹 조회
리셋 시각 설정 (KST 기준)

설정 방법

대시보드 → 서버 설정 → 출석 체크 탭에서 채널, 리셋 시각, 보상 역할 등을 설정하고 출석 패널을 생성하세요.

DM 알림

구독한 유저에게만 DM을 발송하는 opt-in 기반 캠페인 시스템입니다. Discord ToS를 준수하며 동의한 유저에게만 메시지를 보냅니다.

동작 방식

구독 패널 생성

대시보드에서 채널을 선택하고 구독 패널을 생성합니다.

유저 구독

유저가 구독 버튼을 클릭하여 DM 알림을 동의합니다.

캠페인 작성

대시보드에서 제목, 내용, 색상을 설정하여 캠페인을 작성합니다.

DM 발송

구독자에게 DM이 발송됩니다. 각 DM에는 구독 해제 버튼이 포함됩니다.

구독 해제

유저는 구독 패널에서 버튼을 다시 클릭하거나, DM 내 구독 해제 버튼을 눌러 언제든 구독을 취소할 수 있습니다.

서버 진단

봇 설정에서 참조하는 채널, 역할, 권한이 정상인지 한 번에 진단합니다. 삭제된 채널이나 역할을 자동으로 감지하고, 관리자 채널을 복구할 수 있습니다.

진단 항목

봇 필수 권한

관리자 채널/카테고리

티켓 채널/역할

자동음성 채널

환영/인증 채널

알림 연동 채널

경고/모더레이션 채널

감사 로그 채널

자동 복구

관리자 카테고리나 봇-공지/봇-로그 채널이 삭제된 경우, 진단 결과에서 "관리자 채널 복구" 버튼으로 자동 복구할 수 있습니다.

멤버 메모

관리자가 유저에게 메모를 남겨 관리 이력을 기록할 수 있습니다. Discord에서 직접 추가하거나 웹 대시보드에서 관리할 수 있습니다.

메모 유형

정보 (info)

주의 (warning)

긍정 (positive)

부정 (negative)

Discord에서 추가

유저를 우클릭 → 앱 → "메모 관리"를 통해 Discord 내에서 바로 메모를 추가할 수 있습니다.

통계 대시보드

서버의 활동 데이터를 자동으로 수집하고 시각적으로 분석합니다.

통계 항목

멤버 증감

가입/탈퇴 추이를 일별로 추적합니다.

메시지 통계

채널별, 유저별, 일별 메시지 수를 집계합니다.

시간대별 활동

서버가 가장 활발한 시간대를 파악합니다.

데이터 보관

통계 데이터는 90일 이상 지난 데이터를 자동으로 정리하여 저장 공간을 관리합니다.

서버 템플릿

사전 설정된 서버 구조를 템플릿으로 적용하거나, 현재 서버 구조를 내보낼 수 있습니다.

VeltoBot 공식

기본 권장 서버 구성

스트리머

방송인/크리에이터용 구성

게임 커뮤니티

게임 서버/클랜용 구성

심플

최소한의 기본 구성

서버 내보내기

템플릿 페이지 또는 서버 설정 → 템플릿 적용에서 현재 서버의 역할·채널·카테고리 구조를 내보낼 수 있습니다. 내보내기와 적용은 백그라운드 작업으로 진행되며, 진행률을 실시간으로 확인할 수 있습니다.

커뮤니티 템플릿

내보낸 템플릿을 공개하려면 관리자 승인이 필요합니다. 승인 후 다른 서버에서도 사용할 수 있습니다. 템플릿 적용 시 일부 봇 설정(환영 메시지, 티켓 등)은 함께 구성되며, 적용 중 오류가 있으면 경고와 함께 결과가 표시됩니다.

주의

템플릿 적용은 기존 채널·역할 구조를 변경할 수 있습니다. 적용 전 대시보드의 경고 문구를 확인하세요.