Discord 자격 증명
다음 node를 인증하는 데 이 자격 증명을 사용할 수 있습니다: 어떤 방법을 사용할지 모르겠다면 인증 방법 선택을 참조하세요. 서비스에 대한 자세한 내용은 Discord 개발자 문서를 참조하세요. OAuth2 대신 봇 토큰을 사용하여 Discord 서버에 봇을 추가하려는 경우 이 방법을 사용합니다.
다음 node를 인증하는 데 이 자격 증명을 사용할 수 있습니다:
사전 요구 사항#
- Discord 계정을 생성합니다.
- Bot 및 OAuth2 자격 증명의 경우:
- 로컬 개발자 환경을 설정합니다.
- 애플리케이션과 봇 사용자를 생성합니다.
- 웹훅 자격 증명의 경우 웹훅을 생성합니다.
지원되는 인증 방법#
- Bot
- OAuth2
- Webhook
어떤 방법을 사용할지 모르겠다면 인증 방법 선택을 참조하세요.
관련 리소스#
서비스에 대한 자세한 내용은 Discord 개발자 문서를 참조하세요.
Bot 사용#
OAuth2 대신 봇 토큰을 사용하여 Discord 서버에 봇을 추가하려는 경우 이 방법을 사용합니다.
이 자격 증명을 구성하려면 다음이 필요합니다:
- Bot Token: 봇이 포함된 애플리케이션을 생성하면 발급됩니다.
봇이 포함된 애플리케이션을 생성하고 Bot Token을 생성하려면:
- 아직 없다면 개발자 포털에서 앱을 생성합니다.
- 앱의 Name을 입력합니다.
- Create를 선택합니다.
- 왼쪽 메뉴에서 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를 선택합니다.
- 여전히 Installation 페이지에서 Default Install Settings 섹션에서
applications.commands와bot스코프를 선택합니다. 이 스코프와 다른 스코프에 대한 자세한 내용은 Discord의 스코프 문서를 참조하세요. - Bot > Bot Permissions 페이지에서 권한을 추가합니다. 자세한 내용은 Discord의 권한 문서를 참조하세요. n8n은 Discord node에 대해 다음 권한을 선택할 것을 권장합니다:
- Manage Roles
- Manage Channels
- Read Messages/View Channels
- Send Messages
- Create Public Threads
- Create Private Threads
- Send Messages in Threads
- Send TTS Messages
- Manage Messages
- Manage Threads
- Embed Links
- Attach Files
- Read Message History
- Add Reactions
- 서버 또는 테스트 서버에 앱을 추가합니다:
- Installation > Install Link로 이동하여 거기 나열된 링크를 복사합니다.
- 링크를 브라우저에 붙여넣고 Enter를 누릅니다.
- 설치 프롬프트에서 Add to server를 선택합니다.
- 앱이 서버에 추가되면 멤버 목록에서 확인할 수 있습니다.
이 단계는 n8n 자격 증명 설정에 필요한 기본 기능을 설명합니다. 앱 생성에 대한 자세한 내용은 Discord 앱 만들기 가이드를 참조하세요. 특히:
- 자격 증명 가져오기: 앱의 자격 증명을 로컬 개발자 환경에 가져오는 방법입니다.
- 상호작용 처리: 대화형
/slash명령을 위한 공개 엔드포인트 설정에 대한 정보입니다.
OAuth2 사용#
OAuth2 플로우를 사용하여 Discord 서버에 봇을 추가하려는 경우 이 방법을 사용합니다. 앱을 설치하는 사용자에게 프로세스를 단순화합니다.
이 자격 증명을 구성하려면 다음이 필요합니다:
- Client ID
- Client Secret
- Authentication을 Header 또는 Body 중 어디에 보낼지 선택
- Bot Token
봇이 포함된 애플리케이션을 생성하고 토큰을 생성하는 방법은 위의 Bot 사용 단계와 동일합니다.
그런 다음:
- 생성한 Bot Token을 복사하여 n8n 자격 증명에 입력합니다.
- Discord 애플리케이션의 OAuth2 페이지를 열어 Client ID에 접근하고 Client Secret을 생성합니다. 이를 n8n 자격 증명에 추가합니다.
- n8n에서 OAuth Redirect URL을 복사하여 Discord 애플리케이션의 OAuth2 > Redirects에 입력합니다. 변경 사항을 저장해야 합니다.
웹훅 사용#
이 자격 증명을 구성하려면 다음이 필요합니다:
- Webhook URL: 웹훅을 생성하면 발급됩니다.
Webhook URL을 가져오려면 웹훅을 생성하고 생성된 URL을 복사합니다:
- Discord Server Settings를 열고 Integrations 탭을 엽니다.
- Create Webhook을 선택하여 새 웹훅을 생성합니다.
- 의미 있는 웹훅 Name을 지정합니다.
- Name 옆의 아바타를 선택하여 아바타를 편집하거나 새 아바타를 업로드합니다.
- CHANNEL 드롭다운에서 웹훅이 게시할 채널을 선택합니다.
- Copy Webhook URL을 선택하여 Webhook URL을 복사합니다. 이 URL을 n8n 자격 증명에 입력합니다.
자세한 내용은 Discord 웹훅 만들기 문서를 참조하세요.
인증 방법 선택#
가장 간단한 설치 방법은 **webhook(웹훅)**입니다. Discord 서버의 단일 채널에 웹훅을 생성하고 추가합니다. 웹훅은 채널에 메시지를 게시할 수 있습니다. 봇 사용자나 인증이 필요하지 않습니다. 하지만 사용자 요청이나 명령을 수신하거나 응답할 수 없습니다. 상호작용이나 피드백 없이 채널에 메시지를 보내는 간단한 방법이 필요한 경우 웹훅을 사용합니다.
**bot(봇)**은 웹훅보다 상호작용이 가능한 한 단계 높은 수준입니다. Discord 서버(Discord API 문서에서는 guild라고 함) 또는 사용자 계정에 봇을 추가합니다. 서버에 추가된 봇은 서버의 모든 채널에서 사용자와 상호작용할 수 있습니다. 채널을 관리하고, 메시지를 보내고 받고, 모든 사용자 목록을 가져오고, 역할을 변경할 수 있습니다. 대화형, 복잡하거나 다단계 워크플로가 필요한 경우 봇을 사용합니다.
OAuth2는 기본적으로 봇 토큰 대신 OAuth2 플로우를 사용하는 봇입니다. 봇과 마찬가지로 Discord 서버 또는 사용자 계정에 추가합니다. 이 자격 증명은 봇과 동일한 기능을 제공하지만 서버에 봇 설치를 단순화할 수 있습니다.
