디스코드 봇 토큰은 봇 계정의 비밀번호예요. 이 토큰을 가진 사람은 그 봇을 디스코드에 로그인시키고, 이미 들어가 있는 모든 서버에서 권한이 허용하는 어떤 일이든 시킬 수 있어요. 봇 애플리케이션을 만들면 디스코드 개발자 포털에서 무료로 받을 수 있어요. 봇의 사용자 ID나 초대 링크 같은 공개 식별자가 아니라, 실제로 그 자체가 비밀번호이므로 비밀번호처럼 다루세요.
디스코드 봇 토큰 발급받기
- 개발자 포털 열기. discord.com/developers/applications로 가서, 봇을 소유해야 할 디스코드 계정으로 로그인하세요.
- 애플리케이션 만들기. New Application을 누르고 이름을 정하세요. 이 이름은 아직 봇의 표시 이름이 아니라, 애플리케이션의 이름일 뿐이에요.
- Bot 탭 열기. 디스코드가 애플리케이션에 봇 사용자를 자동으로 추가해요. 여기서 사용자 이름과 아바타를 설정하세요. 이것이 멤버에게 서버에서 보이는 모습이에요.
- 필요한 인텐트 켜기. Privileged Gateway Intents에서 Server Members Intent와 Message Content Intent는 기본적으로 꺼져 있어요. 새 멤버를 환영하거나, 메시지 내용을 읽거나, 역할을 추적하는 대부분의 봇은 둘 다 켜야 해요.
- Reset Token 누르기. 디스코드가 토큰을 생성하고 딱 한 번만 보여 줘요. 바로 복사하세요. 나중에 같은 토큰을 다시 볼 방법은 없어요. Reset Token을 한 번 더 누르면 첫 번째 토큰은 무효화되고 새 토큰이 발급돼요.
- 필요한 곳에 붙여넣기. 내 봇 코드에 환경 변수로 넣거나, 호스팅 업체 대시보드의 입력 칸에 넣으세요. 채팅 메시지, 공개 저장소, 지원 티켓에는 절대 넣으면 안 돼요.
봇 토큰이 실제로 허용하는 것
토큰은 코드가 디스코드 게이트웨이와 REST API에 봇 사용자로 인증하는 수단이에요. 유효한 토큰이 있으면 코드는 다음을 할 수 있어요:
- 봇을 로그인시키고 온라인 상태로 유지하기
- 봇이 볼 수 있는 모든 채널에서 메시지 보내고 읽기
- 이미 들어가 있는 각 서버에서 봇의 역할 권한이 허용하는 모든 작업 수행하기: 역할 관리, 추방, 밴, 채널 삭제 등
- 봇 자신의 DM을 읽고 인터랙션(슬래시 명령어, 버튼, 모달)에 응답하기
토큰이 허용하지 않는 것은 봇을 새 서버에 추가하는 능력이에요. 봇을 초대하려면 애플리케이션의 클라이언트 ID와 선택한 권한 집합으로 만든, 서버 관리자가 승인해야 하는 별도의 OAuth2 인증 링크가 필요해요. 유출된 토큰으로 봇을 새 곳에 초대할 수는 없어요. 하지만 봇이 이미 들어가 있는 모든 서버에서, 그 봇이 가진 권한만큼 실제 피해를 줄 수 있어요.
봇 토큰을 채팅에 절대 붙여넣으면 안 되는 이유
봇 토큰은 내장된 만료가 없는 평문 인증 정보예요. 이것을 가진 사람은 토큰을 재설정할 때까지 내 봇의 정체성으로 자기 복사본을 돌릴 수 있어요. 디스코드 지원 서버, GitHub 이슈, 잠깐이라도 화면에 보이는 화면 공유에서도 마찬가지예요. 예를 들어 GitHub 커밋에 공개로 올리면, 디스코드는 이를 유출된 인증 정보로 취급해요. 봇이 해킹당해 자신이 들어간 모든 서버에 스팸을 뿌리게 되는 흔한 경로이기도 해요. 유출된 토큰을 누가 썼는지, 무엇을 했는지는 사후에 알 방법이 없어요. 해결 방법은 재설정뿐이에요.
호스팅 업체와 토큰을 공유할 때도 같은 주의가 필요해요. 업체의 대시보드 입력 칸에 HTTPS로만 붙여넣으세요. 아무리 믿을 만한 사람이라도 메시지로 보내거나, 버그 리포트에 넣으면 안 돼요.
토큰을 재설정하면 접근이 즉시 취소돼요
개발자 포털에서 Reset Token을 누르면 이전 토큰이 즉시 무효화돼요. 여전히 그 토큰을 쓰고 있던 모든 프로세스, 즉 내 코드, 호스팅 업체, 허가 없이 토큰을 얻은 누구든지, 다음 재연결 시도에서 연결이 끊기고 이전 값으로는 다시 로그인할 수 없어요. 이것이 알아 둘 가치가 있는 두 가지의 원리예요:
- 비상 차단 스위치예요. 토큰이 유출되었을 가능성이 있다면 다른 무엇보다 먼저 재설정하세요. 봇은 이전 토큰을 가진 쪽에서는 오프라인이 되고, 새 토큰을 입력한 곳에서만 다시 온라인이 돼요.
- 업체를 바꿀 때도 쓰여요. 호스팅 서비스에 토큰을 넘겨 줬는데 그만두고 싶나요? 개발자 포털에서 토큰을 재설정하면 그들의 접근이 즉시 끝나고, 그들에게 무언가를 삭제해 달라고 요청할 필요도 없어요.
재설정된 토큰 때문에 연결이 끊긴 봇은 보통 로그에 게이트웨이 종료 코드 4004(잘못된 토큰)를 남겨요. 이것은 디스코드가 "사용하려던 인증 정보가 더 이상 존재하지 않는다"고 알려 주는 방식이에요.
Noxyr가 토큰을 보관하는 방식
Noxyr는 커스텀 봇 기능에서만 봇 토큰을 요청해요. 이 기능에서는 내 봇의 이름과 아바타 아래에서 Noxyr의 전체 기능 세트를 실행해요. 토큰은 암호화되어 저장되고, 내 봇을 디스코드 게이트웨이에 로그인시키는 용도로만 쓰여요. 붙여넣은 뒤에는 나에게도, 다른 누구에게도 다시 보여 주지 않아요. 접근을 끊고 싶다면 위에서 설명한 방식 그대로 개발자 포털에서 토큰을 재설정하세요. 그 순간 Noxyr의 봇도 이전 토큰을 쓰는 다른 클라이언트와 똑같이 연결이 끊겨요. 전체 설정 단계, 필요한 인텐트, 무료 Top.gg 투표 기반 접근 모델은 커스텀 봇 문서와 커스텀 봇 설정 가이드에 있어요.
자주 묻는 질문
디스코드 봇 토큰은 어디에서 찾나요? 개발자 포털에서 내 애플리케이션을 열고, Bot 탭에서 Reset Token을 누르세요. 생성할 때 한 번만 보여 주고, 이미 있는 토큰을 다시 보여 주는 페이지는 없어요.
봇 토큰을 공유해도 안전한가요? 아니요. 비공개로라도 공유하면, 그 사람이 봇이 들어간 모든 서버에 대한 완전한 통제권을 가지게 돼요. 내 코드나 호스팅 업체의 대시보드 입력 칸에만 넣으세요.
봇 토큰을 재설정하면 어떻게 되나요? 이전 토큰은 사용되던 모든 곳에서 즉시 작동을 멈춰요. 코드나 업체 대시보드에 붙여넣을 새 토큰을 받게 돼요. 봇의 정체성, 서버, 기존 데이터는 영향을 받지 않아요.
유출된 토큰으로 내 봇을 다른 서버에 추가할 수 있나요? 아니요. 그러려면 별도의 OAuth2 초대 링크와 대상 서버 관리자의 승인이 필요해요. 하지만 유출된 토큰은 봇이 이미 들어가 있는 모든 서버에서 여전히 위험해요.
토큰을 재설정하면 무언가가 삭제되나요? 아니요. 이전 인증 정보를 무효화할 뿐이에요. 봇의 애플리케이션과 사용자 ID에 연결된 설정, 역할, 저장된 데이터는 그대로 남아요.
직접 만든 봇을 설정하려고 하시나요? Noxyr를 무료로 추가하거나, 직접 코드를 작성하고 있다면 호스팅 가이드를 보세요.