본문으로 건너뛰기

Discord

최근 업데이트 2026. 10. 07.

1. 사전 조건​

  • Discord 계정이 있고 애플리케이션을 생성할 권한이 있어야 합니다
  • Agentic Engine 플랫폼의 관리자 권한
  • Bot을 추가할 기존 Discord 서버(Server)

2. Discord Bot 생성 및 자격 증명 획득​

Discord Developer Portal로 이동하여 다음 단계에 따라 진행합니다:

  1. New Application을 클릭하고 애플리케이션 이름을 입력한 후 생성합니다.
  2. 애플리케이션 상세 페이지로 이동하여 왼쪽 내비게이션에서 Bot 탭으로 전환합니다.
  3. Bot 페이지에서 Reset Token을 클릭하여 Bot Token을 생성한 후 복사하여 저장합니다(Token은 한 번만 표시되므로 즉시 저장하십시오).
  4. Bot 페이지에서 다음 Privileged Gateway Intents 권한 스위치를 켭니다:
권한 이름필수 여부설명
Message Content Intent필수Bot이 메시지 본문을 읽을 수 있도록 허용
Server Members Intent필요 시서버 멤버 정보 가져오기
Presence Intent필요 시사용자 온라인 상태 가져오기
팁

Message Content Intent는 반드시 켜야 합니다. 그렇지 않으면 Bot이 사용자 메시지 내용을 읽을 수 없어 정상적으로 작동하지 않습니다.

  1. 사용자 OAuth 연동을 지원하려면 왼쪽의 OAuth2 → General 페이지에서 Client ID와 Client Secret을 기록하고, 콜백 주소를 Redirects에 추가합니다:
    https://<your-domain>/api/discord-oauth/callback
팁

Bot Token은 Bot의 모든 작업 권한을 가지므로 코드 저장소에 커밋하거나 다른 사람에게 노출하지 마십시오. Token이 실수로 유출되었다면 즉시 Discord Developer Portal에서 Token을 재설정하고 플랫폼 설정을 업데이트하십시오.

3. 플랫폼에서 Discord 채널 추가​

관리자가 Agentic Engine에 로그인하여 시스템 관리 → 채널 관리로 이동합니다:

  1. 새 채널을 클릭하고 채널 타입으로 Discord를 선택합니다.
  2. 다음 구성 항목을 입력합니다:
구성 항목필수 여부설명
채널 이름필수표시 이름(예: Discord 서버)
Bot Token필수Discord Bot의 액세스 토큰으로, WebSocket Gateway 연결과 메시지 전송에 사용
Client ID선택Discord 애플리케이션의 Client ID로, OAuth 사용자 연동 절차에만 사용
Client Secret선택Discord 애플리케이션의 Client Secret으로, OAuth 사용자 연동 절차에만 사용
기본 모델선택입력하지 않으면 시스템 기본 모델 사용
채널 입력 추가 안내선택매 회차 채널 입력의 추가 안내로 사용되며, Agent 자체의 시스템 프롬프트를 대체하지 않음
경고

주의: 한 기업에서 여러 Discord 채널 인스턴스를 설정할 수 있지만, 같은 Bot 신원을 같은 실행 환경에 중복 설정할 수는 없습니다.

4. 사용자 Discord 계정 연동​

관리자가 채널 설정에 Client ID와 Client Secret을 입력했다면 일반 사용자는 채널 연결에서 자신의 Discord 계정을 연동할 수 있습니다:

  1. 사용자 메뉴를 열고 채널 연결로 이동하여 해당 Discord 채널 인스턴스를 찾은 다음 연동을 클릭합니다.
  2. Discord OAuth 인증 페이지로 이동하면 Discord 계정에 로그인하고 Authorize를 클릭합니다.
  3. 인증에 성공하면 자동으로 플랫폼으로 돌아오며, 연동 상태가 연동됨으로 바뀝니다.

연동이 완료되면 사용자가 Discord에서 Bot에게 보내는 메시지가 플랫폼 계정과 연결됩니다. 연동을 해제하려면 채널 연결에서 해당 인스턴스를 찾아 연결을 해제하면 됩니다.

5. 자주 묻는 질문​

채널 상태 이상 / Bot 연결 불가​

  • Bot Token이 유효한지(재설정되지 않았는지) 확인합니다.
  • Bot이 대상 Discord 서버에 정상적으로 초대되었는지 확인합니다.
  • Developer Portal에서 Message Content Intent가 켜져 있는지 확인합니다.

OAuth 콜백 실패​

  • 콜백 주소가 Discord 애플리케이션의 OAuth2 → Redirects 화이트리스트에 추가되었는지 확인합니다.
  • 콜백 주소는 프로토콜(https)과 경로를 포함하여 플랫폼의 실제 배포 도메인과 완전히 일치해야 합니다.

사용자가 Discord 계정을 연동할 수 없음​

  • 채널 설정에 Client ID와 Client Secret이 입력되어 있는지 확인합니다(둘 중 하나라도 없으면 OAuth 연동을 사용할 수 없음).
  • OAuth 콜백 주소가 올바르게 설정되어 있는지 확인합니다.

Bot이 메시지를 받지 못함​

  • Message Content Intent가 켜져 있는지 확인합니다. 그렇지 않으면 Bot이 메시지 내용을 가져올 수 없습니다.
  • Bot이 대상 채널에서 Read Messages 및 Send Messages 권한을 가지고 있는지 확인합니다.

관련 페이지와 다음 단계

이 문서가 도움이 되었나요?
이 페이지의 내용