서버 관리
커스텀 환영 · 부스트 알림
개요
운영진이 채팅에
.환영합니다 @유저처럼 쓰면, 해나봇이 그 메시지를 지우고 서버가 직접 꾸민 환영 카드(CV2)를 대신 올립니다 — 안내 데스크 직원이 손님 이름만 부르면, 미리 준비해 둔 환영 카드를 정중하게 건네주는 셈입니다.
접두사(기본 .) · 명령어 이름 · 카드의 색과 문구 · 사진 · 버튼까지 서버마다 따로 정할 수 있고, 모든 설정은 웹 대시보드의 「환영 · 부스트」 탭에서 미리보기를 보면서 꾸밉니다. 명령어는 서버마다 최대 10개라, .환영합니다와 .어서와처럼 상황별로 다른 카드를 둘 수도 있습니다.
명령어마다 줄 역할 · 뺄 역할을 정해 두면, 환영하면서 「멤버」 역할을 주고 「미인증」 역할을 떼는 일까지 한 번에 끝납니다.
누가 서버를 부스트하면 같은 방식으로 꾸민 감사 카드를 올리는 부스트 알림도 같은 탭에서 켤 수 있습니다.사용 방법
-
01대시보드에서 켜기대시보드 → 커뮤니티 → 환영 · 부스트 탭에서 「환영 명령어 사용」을 켜고 저장합니다. 처음에는 꺼진 채로 시작합니다 — 다른 봇과 접두사가 겹치는 서버에서 의도치 않게 메시지가 지워지지 않게 하기 위해서입니다.
-
02카드 꾸미기명령어 이름, 카드 색, 머리말 · 제목(크기 3단계) · 본문 · 바닥글, 오른쪽 작은 그림(환영할 유저 프로필 · 서버 아이콘 · 주소 · 내 이미지), 아래 큰 그림(주소 · 내 이미지, GIF 가능), 링크 버튼(최대 3개)을 정합니다. 오른쪽 미리보기가 입력하는 즉시 바뀝니다.
-
03역할 정하기「역할」 칸에서 줄 역할과 뺄 역할을 각각 최대 5개까지 고릅니다. 관리 권한이 있는 역할과 봇 전용 역할은 목록에서 고를 수 없고, 해나봇 역할보다 높은 역할에는 경고가 붙습니다. 비워 두면 역할은 건드리지 않습니다.
-
04미리 보내 보기오른쪽 테스트 보내기로 저장하기 전의 카드를 원하는 채널에 한 장 보내 봅니다. 대상은 대시보드를 쓰는 본인이고, 알림과 역할 지급은 하지 않습니다.
-
05채팅에서 쓰기
.환영합니다 @유저— 보낸 메시지는 지워지고 환영 카드가 올라가며, 정해 둔 역할이 처리됩니다..환영합니다 @유저1 @유저2처럼 한 번에 5명까지 멘션하면 사람마다 카드가 한 장씩 올라갑니다. 멘션 대신 환영할 사람의 메시지에 답장으로.환영합니다만 써도 되고,.환영합니다 @유저 @신입처럼 역할을 함께 멘션하면 카드의<role>자리에 그 역할이 들어갑니다(이 역할을 주지는 않습니다).
역할 지급
- 명령어를 쓰면 멘션한 사람에게 줄 역할을 주고 뺄 역할을 뗍니다. 이미 가진 역할은 다시 주지 않고, 디스코드 감사 로그에는 「[환영 명령어] .환영합니다 · 실행 운영진」처럼 어떤 명령어로 누가 바꿨는지 남습니다.
- 주지도 빼지도 않는 역할 — 관리자 · 서버 관리 · 역할 관리 · 채널 관리 · 웹후크 관리 · 메시지 관리 · 차단 · 추방 · 타임아웃 · @everyone 멘션 권한이 있는 역할, 봇 · 연동 전용 역할, @everyone. 환영 명령어를 쓰는 운영진이 관리 권한을 대신 나눠 주거나 빼앗지 못하게 하기 위해서입니다.
- 해나봇은 자기 역할보다 아래에 있는 역할만 줄 수 있습니다(디스코드 규칙). 서버 설정 › 역할에서 해나봇 역할을 줄 역할보다 위로 올리고 「역할 관리」 권한을 켜 주세요.
- 처리하지 못한 역할이 있어도 카드는 그대로 보내고, 명령어를 쓴 채널에 역할 이름과 이유를 9초 동안 보여 줍니다(알림 없음).
- 카드에
<grantedRoles>·<removedRoles>를 넣으면 실제로 준 · 뗀 역할이 들어갑니다. 「카드 속 역할에게 알림」을 켜면 그 역할을 가진 모든 멤버에게 알림이 가니 주의하세요. - 「환영 카드 보내기」를 끄면 카드 없이 역할만 처리하고, 결과는 명령어를 쓴 사람에게 6초 동안만 보여 줍니다 — 인증 처리처럼 조용히 역할만 바꿀 때 씁니다.
부스트 알림
- 누가 서버를 부스트하면 해나봇이 서버가 꾸민 감사 카드(CV2)를 정한 채널에 올립니다. 대시보드 「환영 · 부스트」 탭 위쪽의 부스트 알림으로 넘어가 켜고(처음에는 꺼짐), 환영 카드와 같은 편집기로 색 · 문구 · 그림 · 버튼을 꾸밉니다. 미리보기와 테스트 보내기도 그대로 쓸 수 있습니다.
- 카드를 보낼 채널을 비워 두면 디스코드 서버 설정의 시스템 메시지 채널로 보냅니다. 시스템 메시지 채널이 없는 서버는 채널을 꼭 골라야 합니다.
- 해나봇은 두 곳에서 부스트를 알아챕니다 — 멤버에게 부스터 표시가 처음 생길 때, 그리고 디스코드가 올리는 「부스트했어요」 시스템 메시지. 서버 설정 › 시스템 메시지 채널에서 부스트 메시지를 켜 두면 이미 부스터인 사람의 추가 부스트까지 잡힙니다.
- 같은 사람이 1분 안에 여러 번 부스트하면 카드는 한 장만 올라갑니다. 카드에는
<boostCount>(지금 부스트 수) ·<boostTier>(지금 부스트 레벨)를 넣을 수 있습니다. - 「부스트한 유저에게 알림」을 켜면 그 유저에게만 알림이 갑니다. @everyone · @here는 울리지 않고, 테스트 보내기 카드는 아무에게도 알림을 보내지 않습니다.
내 이미지 올리기
- 오른쪽 작은 그림 · 아래 큰 그림에서 내 이미지를 고르면, 그림 주소 대신 갖고 있는 이미지 파일을 올려 쓸 수 있습니다. 환영 카드와 부스트 감사 카드 모두 되고, 이미지는 대시보드에서만 올릴 수 있습니다.
- PNG · JPG(JPEG) · GIF · WebP · BMP를 한 장에 5MB까지 올릴 수 있습니다. 칸에 끌어 놓거나 「파일 고르기」로 고르면 바로 올라가 미리보기에 보이고, 움직이는 GIF는 움직이는 그대로 보냅니다.
- BMP는 디스코드가 미리보기를 보여 주지 않는 형식이라 PNG로 바꿔 올립니다. 사진 속 촬영 정보(EXIF · XMP — 위치 · 기기 등)는 올릴 때 지웁니다.
- 파일 내용으로 형식을 확인합니다 — 이름만 바꾼 파일, 손상된 파일, SVG처럼 그림이 아닌 내용이 들어갈 수 있는 형식은 받지 않습니다.
- 올린 이미지는 해나봇 서버에 암호화(AES-256-GCM)해 보관하고, 카드를 보낼 때와 그 서버의 대시보드 권한이 있는 관리자가 작성기에서 볼 때만 풀어서 씁니다. 카드를 보낼 때마다 메시지에 파일로 붙여 올리므로, 디스코드에 올라간 카드의 그림은 일반 첨부파일과 같습니다.
- 어느 카드에도 쓰이지 않는 이미지(카드에서 빼거나 바꾼 이미지, 올리고 저장하지 않은 이미지)는 올린 때부터 12시간이 지나면 자동으로 지웁니다. 서버마다 30장까지 보관할 수 있습니다.
함수
카드 문구 · 그림 주소 · 버튼에 아래 함수를 쓰면, 보낼 때 실제 값으로 바뀝니다. 대시보드의 함수 목록에서 누르면 커서 자리에 바로 들어가고, 역할 · 채널은 고르기만 하면
<role:역할ID> · <channel:채널ID>가 자동으로 입력됩니다. 디스코드 문법(**굵게** · *기울임* · > 인용 · -# 작은 글씨 · [글자](주소))도 그대로 쓸 수 있습니다.| 함수 | 들어가는 값 |
|---|---|
<user> | 환영할 유저(부스트 알림에서는 부스트한 유저) 멘션 |
<userName> | 그 유저의 서버 표시 이름 |
<userID> | 그 유저의 ID 숫자 |
<userAvatar> | 그 유저의 프로필 사진 주소 (이미지 칸에 사용) |
<author> | 명령어를 쓴 사람 멘션 — 환영 명령어 전용 |
<authorName> | 명령어를 쓴 사람의 표시 이름 — 환영 명령어 전용 |
<authorID> | 명령어를 쓴 사람의 ID 숫자 — 환영 명령어 전용 |
<grantedRoles> | 이 명령어로 준 역할 멘션 (「줄 역할」) — 환영 명령어 전용 |
<removedRoles> | 이 명령어로 뺀 역할 멘션 (「뺄 역할」) — 환영 명령어 전용 |
<role> | 명령어에 함께 멘션한 역할 (예: .환영합니다 @유저 @신입) — 환영 명령어 전용 |
<roleID> | 함께 멘션한 역할의 ID 숫자 — 환영 명령어 전용 |
<boostCount> | 지금 서버의 부스트 수 (예: 14) — 부스트 알림 전용 |
<boostTier> | 지금 서버의 부스트 레벨 (예: 레벨 2) — 부스트 알림 전용 |
<role:역할ID> | 지정한 역할 멘션 — 예: <role:123456789012345678> |
<channel:채널ID> | 지정한 채널 링크 — 예: <channel:123456789012345678> |
<server> | 서버 이름 |
<serverID> | 서버 ID 숫자 |
<serverIcon> | 서버 아이콘 주소 (이미지 칸에 사용) |
<memberCount> | 지금 서버 인원 수 |
<date> | 오늘 날짜 (한국 시간, 예: 2026년 11월 1일) |
<time> | 지금 시각 (한국 시간, 예: 오후 3:20) |
사용 권한과 안전장치
- 서버 관리자는 항상 쓸 수 있습니다. 「사용할 수 있는 역할」을 정하면 그 역할만, 정하지 않으면 「메시지 관리」 권한이 있는 사람만 쓸 수 있습니다 — 아무나 봇 카드를 찍어내는 도배를 막기 위해서입니다.
- 「명령어를 받을 채널」을 정하면 그 채널에서만 동작합니다. 카드는 명령어를 쓴 채널로 가고, 명령어마다 다른 채널을 지정할 수도 있습니다.
- 같은 사람이 3초 안에 다시 쓰면 무시합니다. 권한이 없거나 환영할 사람을 빠뜨리면 6초 뒤 사라지는 안내만 남깁니다. 한 번에 환영할 수 있는 사람은 최대 5명이고, 봇은 대상에서 빠집니다.
- 대시보드가 해나봇 권한을 미리 점검합니다 — 해나봇이 글을 쓸 수 없는 채널, 메시지를 지울 수 없는 채널, 「역할 관리」 권한이 없거나 해나봇보다 높은 역할을 저장하기 전에 알려 줍니다.
- 카드 속 멘션은 「환영할 유저에게 알림」을 켠 경우 그 유저에게만 알림이 가고, 역할 알림은 따로 켜야 합니다. @everyone · @here는 어떤 경우에도 울리지 않습니다.
- 함수를 넣어 글이 길어져도 디스코드 한도(메시지당 4,000자) 안으로 자동으로 줄입니다. 그림 · 버튼 주소는 https로 시작하는 주소(또는 <userAvatar> · <serverIcon>)만 받습니다. 직접 올리는 이미지는 위 「내 이미지 올리기」를 참고하세요.
명령어
/환영커스텀이 서버의 환영 메시지 상태(켜짐 여부 · 명령어 목록 · 역할 지급 · 사용 예 · 부스트 알림)와 대시보드 바로가기 버튼을 보여 줍니다 (나만 보기)
.환영합니다 @유저환영 카드 전송과 정해 둔 역할 지급 — 한 번에 최대 5명. 접두사와 명령어 이름은 대시보드에서 서버마다 바꿀 수 있습니다
파트너 서버