직접 소유한 봇으로 앱을 Discord에 연결해 채널에 메시지를 게시하고, 봇이 참여한 서버를 나열하고, 최근 채널 기록을 읽습니다.
Discord에 앱 연결하기
채널에 메시지를 게시하고, 봇이 참여한 서버를 나열하고, 최근 채널 기록을 읽도록 앱을 Discord에 연결합니다.
Discord는 서버와 채널로 구성된 메시징 플랫폼입니다. Discord 커넥터를 사용하면 Lovable 앱이 직접 소유한 봇을 통해 메시지를 게시하고, 봇이 참여한 서버를 나열하고, 최근 채널 기록을 읽을 수 있습니다.
Discord는 앱 + 채팅 커넥터로 제공됩니다. 하나의 공유 연결이 빌드 중 채팅과 게시된 앱 양쪽에서 동작합니다.
Discord를 연결하면 앱은 다음 작업이 가능합니다.
- 봇이 접근할 수 있는 채널에 텍스트 메시지 게시
- 봇이 참여한 서버 나열
- 채널의 최근 메시지 읽기
- 봇에 등록한 공개 URL로 슬래시 명령 상호작용 수신
봇은 초대받은 서버만 볼 수 있고, 해당 채널이 Send Messages를 허용할 때만 메시지를 게시할 수 있습니다. 앱이 서버에 알림을 보내거나 서버 활동을 보여주거나 슬래시 명령에 답해야 할 때 Discord가 잘 맞습니다.
주요 활용 사례 및 예시 앱
다음 예시는 Discord로 무엇을 만들 수 있는지 보여줍니다. 각 항목에는 시작용 프롬프트가 포함되어 있습니다.
| 예시 앱 | 예시 프롬프트 | 설명 |
|---|---|---|
| 주문 알림 | Discord를 사용해 고객이 결제를 마치면 orders 채널에 메시지를 게시하는 스토어 페이지를 만들어줘. | 앱에서 어떤 일이 생기면 채널에 알립니다. 앱이 봇이 접근할 수 있는 Discord 채널에 주문 요약을 게시합니다. |
| 서버 디렉터리 | Discord를 사용해 이 봇이 참여한 Discord 서버를 나열하는 페이지를 만들어줘. | 봇이 참여한 서버를 보여줍니다. 앱이 서버 이름을 하나씩 나열해 앱 사용자에게 보여줍니다. |
| 공지 게시판 | Discord를 사용해 announcements 채널의 최신 메시지를 보여주는 페이지를 만들어줘. | 최근 채널 메시지를 앱에 표시합니다. 앱이 한 채널의 최근 메시지를 읽어 페이지에 보여줍니다. |
| 지원 인계 | Discord를 사용해 제출 내용을 support 채널에 게시하는 문의 양식을 만들어줘. | 양식 제출 내용을 Discord 채널로 보냅니다. 앱이 양식 내용을 채널 메시지로 게시합니다. |
| 슬래시 명령 응답 | Discord를 사용해 슬래시 명령에 짧은 상태 메시지로 답하는 공개 엔드포인트를 만들어줘. | 게시된 앱에서 슬래시 명령에 답합니다. 앱이 상호작용을 받아 Discord에서 응답합니다. |
Discord 연결 방법
Discord 연결을 만들 수 있는 사람은 플랜과 워크스페이스 설정에 따라 달라집니다. 앱 + 채팅 커넥터는 Free, Pro, Business 플랜에서 기본으로 제공됩니다. Enterprise 플랜에서는 처음에 사실상 비활성화되어 있습니다. admin이 Connectors → Admin settings → App + chat connectors에서 바꾸기 전까지 연결과 클라이언트를 만들 수 있는 사람의 기본값은 No one입니다.
서로 다른 봇 토큰으로 Discord 연결을 여러 개 만들 수 있습니다. 개발·프로덕션처럼 환경을 분리하거나 봇을 여러 개 운영할 때 유용합니다.
연결을 만들면 사용하려는 프로젝트에 연결을 링크할 수 있습니다. 프로젝트에서 빌드하는 사람은 채팅에서 Lovable에 자기 프로젝트를 이 연결에 링크해 달라고 요청할 수 있습니다.
사전 준비
Discord를 연결하기 전에 다음을 확인하세요.
- Discord 계정
- 봇이 포함된 Discord application과 그 봇의 토큰
- Lovable 워크스페이스에서 연결을 만들 권한(연결과 클라이언트를 만들 수 있는 사람 참조)
Discord 봇 HTTP API는 이런 요청에 비용을 청구하지 않습니다. 다만 Discord의 rate limit은 그대로 적용되며, Lovable이 아니라 Discord가 이를 집행합니다.
1단계: 봇 만들고 토큰 복사하기
토큰은 Discord 봇 하나에 대한 자격 증명입니다. application은 Discord Developer Portal에서 만듭니다.
봇을 만들고 토큰을 복사하려면 다음을 진행합니다.
Developer Portal 열기
Discord Developer Portal에 로그인합니다.
application 만들기
New Application을 클릭하고 이름을 지정한 뒤 생성합니다.
봇 토큰 복사
Bot을 열고 Reset Token을 클릭합니다. 토큰을 복사해 안전하게 보관합니다. Lovable의 양식 필드 라벨은 Bot token이고, 힌트에는 "Bot token from the Discord Developer Portal (Bot page)."라고 표시됩니다.
봇을 서버에 초대
OAuth2를 열고 URL Generator로 이동합니다. bot 스코프를 선택하고 봇에 필요한 권한을 고른 뒤(앱이 메시지를 게시한다면 Send Messages를 포함), 생성된 링크를 열어 봇을 서버에 추가합니다.
봇 토큰은 비밀번호처럼 동작합니다. 안전하게 보관하고 공개적으로 공유하지 마세요. 다음 단계에서 필요합니다.
슬래시 명령을 수신하려면 General Information에서 application의 public key도 복사하세요. 이 키는 봇 토큰과 다릅니다. 앱의 공개 interactions URL을 Developer Portal에 등록하세요. 연결이 만들어진 뒤 Lovable이 프로젝트에서 이 설정을 처리할 수 있습니다.
더 자세한 내용은 Discord 문서를 참조하세요. Discord Developer Portal
2단계: Discord를 Lovable에 연결하기
연결 양식은 1단계에서 복사한 봇 토큰을 요구합니다.
Connectors에서 Discord 열기
Connectors를 열고 Discord를 선택합니다. 카탈로그를 여는 다른 위치는 커넥터를 찾을 수 있는 곳을 참조하세요.
연결 추가
Add connection을 클릭하고 App + chat connector를 선택합니다. 양식은 접을 수 있는 Details, Configure connection, Sharing 세 섹션으로 나뉩니다.
연결 이름 지정
Details 아래에서 Lovable이 연결 이름을 채워 주며 원하는 대로 바꿀 수 있습니다. 이 이름은 Lovable 안에서 연결을 식별하는 데만 사용됩니다.
연결 구성
Configure connection 아래에서 다음을 입력합니다.
- Bot token: Developer Portal Bot 페이지에서 복사한 토큰을 붙여 넣습니다.
이 연결을 사용할 수 있는 사람 선택
Sharing 아래에서 연결은 기본적으로 나에게만 비공개이며 Private label이 표시됩니다. 공유하려면 Share with others를 클릭합니다. 그런 다음 이메일로 워크스페이스 멤버를 추가하거나 Invite entire workspace를 클릭해 Lovable 워크스페이스의 모든 사람이 사용할 수 있게 합니다.
자세한 내용은 연결과 클라이언트를 사용할 수 있는 사람을 참조하세요.
연결
Connect를 클릭합니다. Lovable은 연결을 저장하기 전에 Discord API에 대해 봇 토큰을 검증합니다.
연결되면 프로젝트에서 빌드하는 사람은 채팅에서 Lovable에 프로젝트를 Discord에 링크해 달라고 요청할 수 있습니다(구성된 연결 수준 접근 권한 기준). 그러면 Lovable 앱이 채널 메시지를 게시하고, 봇의 서버를 나열하고, 최근 채널 기록을 읽을 수 있습니다.
제한 사항
Discord 커넥터는 다음을 할 수 없습니다.
- Discord application을 만들거나 봇을 대신 초대하기. 이 작업은 Developer Portal에서 직접 하세요.
- 각 사람을 자기 Discord 계정으로 로그인시키기. 각 연결은 봇 하나이며, 연결된 모든 프로젝트가 이를 공유합니다.
- 음성 채널에 참여하거나 라이브 게이트웨이 연결을 유지하기. 커넥터는 메시지, 서버 목록, 채널 기록, 슬래시 명령 HTTP 콜백 같은 HTTP 호출만 지원합니다.
Discord 연결 관리
연결은 Connectors에서 관리합니다. **Discord**를 선택한 뒤 연결을 엽니다.
- Unlink projects를 사용하면 다른 프로젝트에서는 연결을 계속 쓸 수 있게 두면서 특정 프로젝트에서 Discord 접근만 제거할 수 있습니다. 단계는 연결에서 프로젝트 링크 해제를 참조하세요.
- Delete the connection은 워크스페이스에서 연결을 완전히 제거합니다. 삭제는 영구적입니다. 연결된 모든 프로젝트에서 자격 증명이 제거되고, Discord를 사용하는 앱 기능은 새 연결을 추가할 때까지 동작을 멈춥니다. 단계와 삭제 권한은 연결 삭제를 참조하세요.