Discord 자격 증명#
다음 노드를 인증하는 데 이러한 자격 증명을 사용할 수 있습니다:
전제 조건#
지원하는 인증 방법#
- Bot
- OAuth2
- 웹후크
어떤 방법을 사용해야 할지 모르겠다면, 인증 방법 선택을 참조하세요.
관련 자료#
서비스에 대한 자세한 정보는 Discord의 개발자 문서를 참조하세요.
봇 사용하기#
OAuth2가 아닌 봇 토큰을 사용하여 Discord 서버에 봇을 추가하려는 경우 이 방법을 사용하세요.
이 자격 증명을 구성하려면 다음이 필요합니다:
- Bot Token: 봇이 있는 애플리케이션을 생성하면 생성됩니다.
봇이 있는 애플리케이션을 만들고 Bot Token을 생성하려면:
- 아직 없는 경우, 개발자 포털에서 앱을 만드세요.
- 앱의 이름을 입력하세요.
- 생성을 선택하세요.
- 왼쪽 메뉴에서 Bot을 선택하세요.
- Token에서 Reset Token을 선택하여 새 봇 토큰을 생성하세요.
- 토큰을 복사하여 n8n 자격 증명에 추가하세요.
- Bot > Privileged Gateway Intents에서 봇이 가져야 할 권한 있는 인텐트를 추가하세요. 권한 있는 인텐트에 대한 자세한 내용은 봇 구성을 참조하세요.
- n8n은 SERVER MEMBERS INTENT: Required for your bot to receive events listed under GUILD_MEMBERS을 활성화하는 것을 추천합니다.
- Installation > Installation Contexts에서 봇이 사용할 설치 컨텍스트를 선택하세요:
- 서버에 설치된 앱의 경우 Guild Install을 선택하세요. (n8n 사용자에게 가장 일반적임)
- 사용자 설치 앱의 경우 User Install을 선택하세요. (n8n 사용자에게 덜 일반적이지만 테스트에 유용할 수 있음)
- 이러한 설치 컨텍스트에 대한 자세한 내용은 Discord의 설치 컨텍스트 선택 문서를 참조하세요.
- Installation > Install Link에서 Discord Provided Link가 선택되어 있는지 확인하세요.
- 여전히 설치 페이지에서 Default Install Settings 섹션에서
applications.commands
와bot
범위를 선택하세요. 이 범위와 기타 범위에 대한 자세한 내용은 Discord의 범위 문서를 참조하세요. - Bot > Bot Permissions 페이지에서 권한을 추가하세요. 권한에 대한 자세한 내용은 Discord의 권한 문서를 참조하세요. n8n은 Discord 노드에 대해 다음 권한을 선택할 것을 권장합니다:
- 역할 관리
- 채널 관리
- 메시지 읽기/채널 보기
- 메시지 보내기
- 공개 스레드 생성
- 비공식 스레드 생성
- 스레드에서 메시지 보내기
- TTS 메시지 보내기
- 메시지 관리
- 스레드 관리
- 링크 삽입
- 파일 첨부
- 메시지 기록 읽기
- 반응 추가
- 앱을 서버나 테스트 서버에 추가하세요:
- 설치 > Install Link로 가서 거기에 나열된 링크를 복사하세요.
- 브라우저에 링크를 붙여넣고 Enter를 누르세요.
- 설치 프롬프트에서 서버에 추가를 선택하세요.
- 앱이 서버에 추가되면 회원 목록에서 확인할 수 있습니다.
이 단계들은 n8n 자격 증명을 설정하는 데 필요한 기본 기능을 설명합니다. 앱 생성에 대한 자세한 내용은 Discord 앱 만들기 가이드를 참조하세요. 특히:
- 자격 증명 가져오기는 로컬 개발 환경에 앱의 자격 증명을 가져오는 방법입니다.
- 상호 작용 처리는 상호작용 '/슬래시' 명령을 위한 공용 엔드포인트 설정에 대한 정보입니다.
OAuth2 사용하기#
OAuth2 흐름을 사용하여 Discord 서버에 봇을 추가하려면 이 방법을 사용하세요. 이는 앱을 설치하는 프로세스를 단순화합니다.
이 자격 증명을 구성하려면 다음이 필요합니다:
- 클라이언트 ID
- 클라이언트 비밀
- 헤더 또는 본문에 인증을 보낼지 선택
- 봇 토큰
봇과 함께 애플리케이션을 만들고 토큰을 생성하는 방법에 대한 자세한 내용은 위의 봇 사용하기와 동일한 단계를 따르세요.
그런 다음:
- 생성한 봇 토큰을 복사하여 n8n 자격 증명에 추가합니다.
- Discord 애플리케이션의 OAuth2 페이지를 열어 클라이언트 ID에 접근하고 클라이언트 비밀을 생성합니다. 이를 n8n 자격 증명에 추가합니다.
- n8n에서 OAuth Redirect URL을 복사하고 이를 Discord 애플리케이션의 OAuth2 > Redirects에 추가합니다. 변경 사항을 저장해야 합니다.
웹훅 사용하기#
이 자격 증명을 구성하려면 다음이 필요합니다:
- 웹훅 URL: 웹훅을 생성하면 생성된 URL.
웹훅 URL을 얻으려면 웹훅을 생성하고 생성된 URL을 복사합니다:
- Discord 서버 설정을 열고 통합 탭을 엽니다.
- 웹훅 생성을 선택하여 새 웹훅을 생성합니다.
- 웹훅에 적절한 이름을 부여합니다.
- 이름 옆의 아바타를 선택하여 새 아바타를 편집하거나 업로드합니다.
- 채널 드롭다운에서 웹훅이 게시할 채널을 선택합니다.
- 웹훅 URL 복사를 선택하여 웹훅 URL을 복사합니다. 이 URL을 n8n 자격 증명에 입력합니다.
자세한 정보는 Discord 웹훅 만들기 문서를 참조하세요.
인증 방법 선택하기#
가장 간단한 설치 방법은 웹훅입니다. Discord 서버의 단일 채널에 웹훅을 생성하고 추가합니다. 웹훅은 채널에 메시지를 게시할 수 있습니다. 봇 사용자나 인증이 필요하지 않습니다. 그러나 사용자 요청이나 명령을 듣거나 응답할 수는 없습니다. 상호 작용이나 피드백이 필요 없는 채널에 메시지를 보내는 간단한 방법이 필요하다면 웹훅을 사용하세요.
봇은 웹훅보다 상호 작용이 가능한 한 단계 높은 방법입니다. Discord 서버(Discord API 문서에서 guild
로 언급됨) 또는 사용자 계정에 봇을 추가합니다. 서버에 추가된 봇은 서버의 모든 채널에서 사용자와 상호 작용할 수 있습니다. 채널을 관리하고, 메시지를 보내고 검색하며, 모든 사용자의 목록을 검색하고, 역할을 변경할 수 있습니다. 상호 작용, 복잡하거나 다단계의 워크플로를 구축해야 하는 경우 봇을 사용하세요.
OAuth2는 기본적으로 봇 토큰 대신 OAuth2 흐름을 사용하는 봇입니다. 봇과 마찬가지로 Discord 서버나 사용자 계정에 추가합니다. 이 자격 증명은 봇과 동일한 기능을 제공하지만 서버에 봇을 설치하는 과정을 단순화할 수 있습니다.