환영과 온보딩
Welcome은 새 멤버가 서버에 들어오는 첫 순간과 나가는 순간을 관리하는 기능이에요. 환영 채널 메시지, 개인 DM, 퇴장 안내, 인증, 자동 역할을 한 화면에서 맞출 수 있어요.
이 페이지에서 할 수 있는 일
Welcome 화면은 여섯 가지 카드로 나뉘어요.
| 카드 | 하는 일 |
|---|---|
| 인증 | 새 멤버에게 CAPTCHA 인증을 보내고 통과한 멤버에게 인증 역할을 부여해요 |
| 환영 메시지 | 지정한 채널에 입장 안내 메시지를 보내요 |
| 환영 DM | 새 멤버에게 개인 안내 메시지를 보내요 |
| 자동 역할 | 입장한 멤버에게 역할을 자동으로 붙여요 |
| 퇴장 메시지 | 멤버가 나갔을 때 지정한 채널에 기록을 남겨요 |
| 퇴장 DM | 멤버가 나갈 때 가능한 범위에서 개인 DM 안내를 보내요 |
전체 모듈을 켠 것과 각 하위 기능을 켠 것은 별도 상태예요. 처음에는 환영 채널 메시지부터 설정하고 실제 입장 흐름을 확인한 뒤 인증과 자동 역할을 더해 보세요.
먼저 정해야 할 것
- 환영 메시지를 보낼 채널
- 퇴장 메시지를 보낼 채널
- 인증 안내를 보낼 채널 또는 DM 방식
- 인증 완료 후 붙일 역할
- 새 멤버에게 자동으로 붙일 역할
- 운영 로그를 남길 채널
역할을 쓰는 기능은 봇 권한이 특히 중요해요. 봇에게 역할 관리 권한이 있어야 하고, 봇의 최상위 역할보다 높은 역할은 SOLE이 줄 수 없어요.
환영 메시지를 만들어요
환영 메시지 카드를 열고 채널을 고른 뒤 메시지 빌더에서 내용을 꾸며요. 현재 패널은 임베드 중심으로 메시지를 구성해요. 제목, 설명, 색상, 이미지, 필드, 버튼 같은 요소를 넣어서 실제 Discord 메시지처럼 미리 볼 수 있어요.
권장 흐름은 이렇게 잡아요.
- 환영 채널을 골라요.
- 제목에 서버 이름이나 짧은 인사말을 넣어요.
- 설명에 규칙 채널, 자기소개 채널, 문의 방법을 적어요.
- 미리보기에서 모바일에서도 읽기 괜찮은지 확인해요.
- 테스트로 실제 채널에 샘플 메시지를 보내요.
- 저장 또는 적용을 눌러 반영해요.
환영 DM을 따로 보내요
환영 DM은 공개 채널 메시지보다 개인 안내에 가까워요. 서버 규칙, 인증 안내, 첫 행동을 차분하게 알려주는 용도로 쓰면 좋아요.
DM은 사용자의 개인 설정이나 Discord 제한 때문에 실패할 수 있어요. 중요한 안내는 DM에만 두지 말고 서버 안의 안내 채널에도 같이 남겨 주세요.
인증을 켜요
인증을 켜면 새 멤버에게 보안 문자 인증이 보내져요. 방식은 DM과 채널 중에서 고를 수 있어요.
- DM 방식: 멤버에게 개인 DM으로 보안 문자 이미지를 보내요.
- 채널 방식: 지정한 인증 채널에 멤버를 멘션하고 보안 문자 이미지를 보내요.
인증에는 인증 완료 역할이 필요해요. 인증이 켜져 있고 멤버가 그 역할을 아직 갖고 있지 않으면 자동 역할은 바로 붙지 않고 인증 이후로 미뤄져요.
보안 문자는 6자리 코드예요. 유효 시간은 10분이고 입력 시도는 5회까지예요. 코드가 잘 안 보이면 새 코드 요청을 할 수 있어요.
자동 역할을 붙여요
자동 역할 카드를 열면 입장한 멤버에게 줄 역할을 여러 개 고를 수 있어요. 역할은 여러 개를 선택할 수 있고, 끄면 선택 목록도 비워져요.
자동 역할이 실패하는 대표 원인은 세 가지예요.
- 봇에게 역할 관리 권한이 없어요.
- 선택한 역할이 봇 최상위 역할보다 높아요.
- 역할이 삭제됐거나 서버에서 찾을 수 없어요.
권한 진단에 오류가 보이면 Discord 서버 설정에서 봇 역할 위치를 먼저 조정해 주세요.
변수로 메시지를 개인화해요
| 변수 | 의미 |
|---|---|
| {user} | 멤버의 표시 이름 |
| {user.mention} | 실제 Discord 멘션 |
| {user.name} | Discord 사용자 이름 |
| {member.display_name} | 서버 표시 이름 |
| {server.name} | 서버 이름 |
| {member_count} | 현재 멤버 수 |
중요한 차이가 있어요. {user}는 멘션이 아니라 표시 이름이에요. 실제 알림이 가는 멘션을 원하면 {user.mention}을 써 주세요.
잘 안 되나요?
| 이런가요 | 이렇게 해 보세요 |
|---|---|
| 환영 메시지가 오지 않아요 | 모듈과 환영 메시지가 모두 켜져 있는지, 채널 권한이 맞는지 확인해요 |
| DM이 안 가요 | 사용자 DM 설정 때문에 실패할 수 있어요. 서버 안내 채널도 같이 준비해요 |
| 역할이 안 붙어요 | 역할 관리 권한과 봇 역할 순서를 확인해요 |
| 인증 코드가 안 보여요 | DM 방식인지 채널 방식인지, 파일 첨부 권한이 있는지 확인해요 |
캡처 기준
| 캡처 | 보여 줄 내용 |
|---|---|
| Welcome 메인 | 인증, 환영 메시지, 환영 DM, 자동 역할, 퇴장 메시지, 퇴장 DM 카드 |
| 환영 메시지 | 채널 선택, 메시지 빌더, Discord 미리보기 |
| 인증 설정 | DM·채널 방식, 인증 역할, 인증 채널 |
| 자동 역할 | 여러 역할 선택 UI와 역할 권한 안내 |