환영과 온보딩

Welcome은 새 멤버가 서버에 들어오는 첫 순간과 나가는 순간을 관리하는 기능이에요. 환영 채널 메시지, 개인 DM, 퇴장 안내, 인증, 자동 역할을 한 화면에서 맞출 수 있어요.

이 페이지에서 할 수 있는 일

Welcome 화면은 여섯 가지 카드로 나뉘어요.

카드 하는 일
인증 새 멤버에게 CAPTCHA 인증을 보내고 통과한 멤버에게 인증 역할을 부여해요
환영 메시지 지정한 채널에 입장 안내 메시지를 보내요
환영 DM 새 멤버에게 개인 안내 메시지를 보내요
자동 역할 입장한 멤버에게 역할을 자동으로 붙여요
퇴장 메시지 멤버가 나갔을 때 지정한 채널에 기록을 남겨요
퇴장 DM 멤버가 나갈 때 가능한 범위에서 개인 DM 안내를 보내요

전체 모듈을 켠 것과 각 하위 기능을 켠 것은 별도 상태예요. 처음에는 환영 채널 메시지부터 설정하고 실제 입장 흐름을 확인한 뒤 인증과 자동 역할을 더해 보세요.

먼저 정해야 할 것

  • 환영 메시지를 보낼 채널
  • 퇴장 메시지를 보낼 채널
  • 인증 안내를 보낼 채널 또는 DM 방식
  • 인증 완료 후 붙일 역할
  • 새 멤버에게 자동으로 붙일 역할
  • 운영 로그를 남길 채널

역할을 쓰는 기능은 봇 권한이 특히 중요해요. 봇에게 역할 관리 권한이 있어야 하고, 봇의 최상위 역할보다 높은 역할은 SOLE이 줄 수 없어요.

환영 메시지를 만들어요

환영 메시지 카드를 열고 채널을 고른 뒤 메시지 빌더에서 내용을 꾸며요. 현재 패널은 임베드 중심으로 메시지를 구성해요. 제목, 설명, 색상, 이미지, 필드, 버튼 같은 요소를 넣어서 실제 Discord 메시지처럼 미리 볼 수 있어요.

권장 흐름은 이렇게 잡아요.

  1. 환영 채널을 골라요.
  2. 제목에 서버 이름이나 짧은 인사말을 넣어요.
  3. 설명에 규칙 채널, 자기소개 채널, 문의 방법을 적어요.
  4. 미리보기에서 모바일에서도 읽기 괜찮은지 확인해요.
  5. 테스트로 실제 채널에 샘플 메시지를 보내요.
  6. 저장 또는 적용을 눌러 반영해요.

환영 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와 역할 권한 안내