이 자격 증명을 사용하여 다음 노드를 인증할 수 있습니다:

• Discord

사전 준비 사항#

• Discord 계정을 생성합니다.
• Bot 및 OAuth2 자격 증명의 경우:
  • 로컬 개발자 환경을 설정합니다.
  • 애플리케이션과 봇 사용자를 생성합니다.
• 웹훅 자격 증명의 경우 웹훅을 생성합니다.

지원되는 인증 방법#

• Bot
• OAuth2
• Webhook

어떤 방법을 사용해야 할지 잘 모르시겠나요? 자세한 안내는 인증 방법 선택을 참조하세요.

관련 리소스#

이 서비스에 대한 자세한 내용은 Discord 개발자 문서를 참조하세요.

Bot 사용하기#

OAuth2가 아닌 봇 토큰을 사용하여 봇을 Discord 서버에 추가하려면 이 방법을 사용하세요.

이 자격 증명을 구성하려면 다음이 필요합니다:

• Bot Token: 봇이 있는 애플리케이션을 생성하면 한 번 생성됩니다.

봇이 있는 애플리케이션을 생성하고 Bot Token을 생성하려면:

1. 아직 없다면 개발자 포털에서 앱을 생성합니다.
2. 앱의 Name을 입력합니다.
3. Create를 선택합니다.
4. 왼쪽 메뉴에서 Bot을 선택합니다.
5. Token 아래에서 Reset Token을 선택하여 새 봇 토큰을 생성합니다.
6. 토큰을 복사하여 n8n 자격 증명에 추가합니다.
7. Bot > Privileged Gateway Intents에서 봇에 부여하려는 권한 부여 인텐트(privileged intents)를 추가합니다. 권한 부여 인텐트에 대한 자세한 내용은 봇 구성하기를 참조하세요.
   • n8n은 SERVER MEMBERS INTENT: GUILD_MEMBERS 아래 나열된 이벤트를 봇이 수신하는 데 필요함을 활성화할 것을 권장합니다.
8. Installation > Installation Contexts에서 봇이 사용할 설치 컨텍스트를 선택합니다:
   • 서버에 설치되는 앱의 경우 Guild Install을 선택합니다. (n8n 사용자에게 가장 일반적입니다.)
   • 사용자에게 설치되는 앱의 경우 User Install을 선택합니다. (n8n 사용자에게는 덜 일반적이지만 테스트 시 유용할 수 있습니다.)
   • 이러한 설치 컨텍스트에 대한 자세한 내용은 Discord의 설치 컨텍스트 선택하기 문서를 참조하세요.
9. Installation > Install Link에서 아직 선택되어 있지 않다면 Discord Provided Link를 선택합니다.
10. 계속해서 Installation 페이지의 Default Install Settings 섹션에서 applications.commands 및 bot 스코프를 선택합니다. 이러한 스코프 및 기타 스코프에 대한 자세한 내용은 Discord의 스코프 문서를 참조하세요.
11. Bot > Bot Permissions 페이지에서 권한을 추가합니다. 자세한 내용은 Discord의 권한 문서를 참조하세요. n8n은 Discord 노드에 다음 권한을 선택할 것을 권장합니다:
    • 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
12. 앱을 서버 또는 테스트 서버에 추가합니다:
    1. Installation > Install Link로 이동하여 거기에 나열된 링크를 복사합니다.
    2. 브라우저에 링크를 붙여넣고 Enter를 누릅니다.
    3. 설치 프롬프트에서 Add to server를 선택합니다.
    4. 앱이 서버에 추가되면 멤버 목록에서 확인할 수 있습니다.

이 단계는 n8n 자격 증명을 설정하는 데 필요한 기본 기능을 설명합니다. 앱 생성에 대한 자세한 내용은 Discord 앱 생성하기 가이드를 참조하세요. 특히 다음 항목을 참고하세요:

• 로컬 개발자 환경에 앱의 자격 증명을 가져오기 위한 자격 증명 가져오기.
• 대화형 /slash 명령을 위한 공개 엔드포인트 설정에 대한 정보를 제공하는 상호작용 처리하기.

OAuth2 사용하기#

앱을 설치하는 사용자를 위한 프로세스를 간소화하는 OAuth2 플로우를 사용하여 봇을 Discord 서버에 추가하려면 이 방법을 사용하세요.

이 자격 증명을 구성하려면 다음이 필요합니다:

• Client ID
• Client Secret
• Authentication을 Header에 보낼지 Body에 보낼지 선택
• Bot Token

봇이 있는 애플리케이션을 생성하고 토큰을 생성하는 자세한 내용은 위의 Bot 사용하기와 동일한 단계를 따르세요.

그런 다음:

1. 생성한 Bot Token을 복사하여 n8n 자격 증명에 추가합니다.
2. Discord 애플리케이션에서 OAuth2 페이지를 열어 Client ID에 접근하고 Client Secret을 생성합니다. 이를 n8n 자격 증명에 추가합니다.
3. n8n에서 OAuth Redirect URL을 복사하여 OAuth2 > Redirects의 Discord 애플리케이션에 추가합니다. 변경 사항을 반드시 저장하세요.

Webhook 사용하기#

이 자격 증명을 구성하려면 다음이 필요합니다:

• Webhook URL: 웹훅을 생성하면 한 번 생성됩니다.

Webhook URL을 받으려면 웹훅을 생성하고 생성된 URL을 복사합니다:

1. Discord Server Settings를 열고 Integrations 탭을 엽니다.
2. Create Webhook을 선택하여 새 웹훅을 생성합니다.
3. 의미가 통하는 Name을 웹훅에 부여합니다.
4. Name 옆의 avatar를 선택하여 아바타를 편집하거나 새로 업로드합니다.
5. CHANNEL 드롭다운에서 웹훅이 게시할 채널을 선택합니다.
6. Copy Webhook URL을 선택하여 Webhook URL을 복사합니다. 이 URL을 n8n 자격 증명에 입력합니다.

자세한 내용은 Discord 웹훅 만들기 문서를 참조하세요.

인증 방법 선택#

가장 간단한 설치 방법은 webhook입니다. 단일 Discord 서버 채널에 웹훅을 생성하고 추가합니다. 웹훅은 채널에 메시지를 게시할 수 있습니다. 봇 사용자나 인증이 필요하지 않습니다. 하지만 사용자 요청이나 명령을 수신하거나 응답할 수는 없습니다. 상호작용이나 피드백 없이 채널에 메시지를 보내는 간단한 방법이 필요하다면 웹훅을 사용하세요.

bot은 웹훅보다 한 단계 더 상호작용이 가능합니다. 봇을 Discord 서버(Discord API 문서에서는 guild라고 함)나 사용자 계정에 추가합니다. 서버에 추가된 봇은 서버의 모든 채널에서 사용자와 상호작용할 수 있습니다. 채널을 관리하고, 메시지를 보내고 검색하며, 모든 사용자 목록을 검색하고, 사용자의 역할을 변경할 수 있습니다. 상호작용이 필요하거나 복잡하거나 다단계로 이루어진 워크플로를 구축해야 한다면 봇을 사용하세요.

OAuth2는 기본적으로 봇 토큰만 사용하는 대신 OAuth2 플로우를 사용하는 bot입니다. 봇과 마찬가지로 이를 Discord 서버나 사용자 계정에 추가합니다. 이 자격 증명은 봇과 동일한 기능을 제공하지만, 서버에 봇을 설치하는 과정을 간소화할 수 있습니다.