Lovable 앱에서 트랜잭션 이메일을 보내고, 발신 도메인을 관리하고, 전송 이벤트를 추적할 수 있도록 Mailgun을 연결하세요.
Mailgun은 Lovable 앱이 Mailgun API를 통해 프로그래밍 방식으로 이메일을 보낼 수 있게 해주는 트랜잭션 이메일 서비스입니다. 영수증, 알림, 비밀번호 재설정, 경보, 리포트 같이 안정적인 전송이 필요한 앱에 적합하며, 바운스·불만 신고·구독 해지를 상세히 추적할 수 있습니다.
Mailgun을 사용하면 앱에서 다음을 할 수 있습니다.
- Mailgun API를 통해 트랜잭션 이메일 전송
- Mailgun에서 관리하는 검증된 발신 도메인으로 발송
- 바운스, 불만 신고, 구독 해지 등 전송 이벤트 추적
- 감사 또는 앱 내 상태 확인용으로 메시지·이벤트 메타데이터 읽기
- Mailgun 계정의 도메인·라우트 정보 읽기
자신의 도메인에서 발송하고, 발신자 평판을 직접 관리하고 싶거나, 이미 Mailgun에서 발송을 관리하고 있을 때 적합합니다.
표준 트랜잭션 이메일(가입 확인, 비밀번호 재설정, 영수증, 내부 알림)은 내장된 Lovable Emails를 사용하세요.
자체 검증 도메인에서 발송하고 싶거나, Lovable Emails보다 더 크게 확장하고 싶거나, 이미 Mailgun에서 발송을 관리한다면 Mailgun 커넥터를 선택하세요.
일반적인 사용 사례와 예시 앱
| 예시 앱 | 예시 프롬프트 | 설명 |
|---|---|---|
| 주문 확인 및 영수증 | Use Mailgun to send order confirmation and receipt emails after checkout. | 앱 이벤트로 트랜잭션 알림 발송. 사용자가 결제를 완료하거나 상태가 바뀔 때마다 앱이 Mailgun 이메일 발송을 트리거합니다. |
| 계정 라이프사이클 이메일 | Use Mailgun to send password reset and email-verification messages from noreply@mydomain.com. | 자체 도메인에서 계정 라이프사이클 이메일 발송. 앱이 보안 링크를 생성하고 검증된 발신 도메인으로 Mailgun을 통해 전송합니다. |
| 폼-투-이메일 앱 | Use Mailgun and build a contact form that emails submissions to our support inbox. | 폼 제출을 라우팅된 이메일로 변환. 앱이 제출 내용을 검증·정렬·포맷팅하고 Mailgun을 통해 적절한 수신자에게 전송합니다. |
| 예약 리포트와 다이제스트 | Use Mailgun to email a weekly KPI digest every Monday at 9am. | 반복 리포트를 이메일로 전송. 앱이 데이터를 모아 이메일로 렌더링하고 스케줄에 따라 발송합니다. |
| 알림과 모니터링 | Use Mailgun to email me whenever an order over $1,000 is placed. | 고-신호 이벤트를 이메일 경보로 전달. 앱이 일치하는 이벤트를 감시하고 적절한 사람들에게 즉시 이메일을 보내 빠르게 대응할 수 있게 합니다. |
| 바운스 및 전송 가능성 대시보드 | Use Mailgun and build a dashboard showing bounces, complaints, and unsubscribes from the last 30 days. | Mailgun 이벤트 데이터로 전송 가능성 모니터링. 앱이 Mailgun 이벤트를 읽고 앱 내에 표시해 리스트 정리와 발신자 평판 보호에 활용할 수 있게 합니다. |
| 도메인 상태 어드민 페이지 | Use Mailgun and build an admin page that lists our sending domains and their verification status. | Mailgun 계정 상태를 앱 안에 표시. 앱이 Mailgun에서 도메인 정보를 읽어, 운영자가 제품을 벗어나지 않고 발송을 관리할 수 있게 합니다. |
Mailgun 연결 방법
워크스페이스 admin 과 owner 가 Mailgun을 연결할 수 있습니다.
서로 다른 API 키로 여러 Mailgun 연결을 만들 수 있습니다. 환경 분리(예: 개발/프로덕션), 서로 다른 Mailgun 계정 사용, 속도 제한이 다른 키 사용 등에 유용합니다.
연결이 생성되면 Mailgun이 워크스페이스의 모든 프로젝트에서 사용 가능합니다.
사전 요구 사항
Mailgun을 연결하기 전에 다음이 필요합니다.
- Mailgun 계정
- 해당 Mailgun 계정에 검증된 발신 도메인
- Mailgun Private API 키
- Mailgun 계정이 호스팅된 지역(EU 또는 US)
- Lovable 워크스페이스 owner 또는 admin 역할
이 커넥터를 통해 발송되는 모든 이메일은 Mailgun 요금제에 따라 계산되며, Lovable이 아닌 Mailgun이 청구합니다.
1단계: Mailgun Private API 키 발급
Private API 키는 Lovable 앱이 Mailgun API에 인증하는 데 사용됩니다. 환경이나 앱별로 별도의 키를 만들 수 있습니다.
Mailgun Private API 키 생성:
Mailgun 계정 열기
발신 도메인을 소유한 계정으로 Mailgun 앱에 로그인합니다.
API keys 열기
Account → Security → API keys 로 이동합니다.
Private API 키 생성 또는 복사
새 Private API 키를 만들거나(설명적인 이름, 예: Lovable integration) 기존 키를 복사합니다.
계정 지역 확인
Mailgun 계정이 EU 또는 US 지역 중 어디에 호스팅되어 있는지 확인합니다. Lovable에서 해당 지역을 선택해야 합니다.
Private API 키는 비밀번호와 같습니다. 안전하게 보관하고 절대 공개적으로 공유하지 마세요. 다음 단계에서 필요합니다.
자세한 안내는 Mailgun 문서를 참고하세요: Mailgun API reference.
2단계: Lovable에 Mailgun 연결
서로 다른 API 키로 여러 연결을 만들 수 있습니다.
Connectors에서 Mailgun 열기
Connectors → App connectors 로 이동해 Mailgun 을 선택합니다.
연결 추가
Add connection 을 클릭합니다.
연결 구성
- Display name: 연결 이름을 지정합니다(예:
Mailgun Prod). - API region: Mailgun 계정이 호스팅된 지역(European Union 또는 United States)을 선택합니다. 기본값은 European Union 입니다. 지역은 API 키가 속한 계정과 일치해야 합니다. US 키는 EU API에 인증되지 않습니다.
- Private API key: Mailgun Private API 키를 붙여넣습니다.
- Who can access this connection: 특정 사람으로 제한하거나 워크스페이스 전체를 초대합니다. 자세한 내용은 연결 단위 접근을 참고하세요.
Connect
Connect 를 클릭합니다.
연결되면 Lovable 앱이 Mailgun을 통해 이메일을 보내고 계정 데이터를 읽을 수 있게 됩니다.
자체 도메인에서 발송
Mailgun은 Mailgun 계정에서 검증된 도메인으로 이메일을 보냅니다. 커넥터는 DNS 구성이나 도메인 검증을 대신 수행하지 않습니다.
발송 전에 Mailgun 앱에서 발신 도메인이 설정되고 검증된 상태인지, DNS 공급자에 필요한 DKIM·SPF 레코드가 추가되어 있는지 확인하세요.
Lovable에 프롬프트를 줄 때 발송 도메인(예: noreply@mydomain.com)을 언급해, 생성된 앱이 일관되게 그 도메인을 사용하도록 하세요.
제한사항
Mailgun 커넥터로 할 수 없는 것:
- 발신 도메인 검증·등록(먼저 Mailgun 앱에서 구성하세요)
- 커넥터를 통한 Mailgun 이벤트 웹훅 직접 수신(대안: Mailgun events API 폴링, 또는 Lovable 외부의 Mailgun 측 엔드포인트로 웹훅 구성)
- API 키 자동 갱신·로테이션(Mailgun에서 새 키를 만들고 Lovable 연결을 업데이트하세요)
- 최종 사용자별 Mailgun 인증(각 연결은 워크스페이스에 한정된 단일 공유 API 키를 사용)
- 연결당 두 개 이상 지역 사용(단일 연결은 EU 또는 US Mailgun API 중 하나에만 인증)
Mailgun 연결에서 프로젝트 연결 해제
Editor 이상은 연결 자체를 삭제하지 않고 특정 프로젝트만 연결에서 제거할 수 있습니다. 연결은 다른 프로젝트에서 계속 사용 가능합니다.
프로젝트 연결 해제:
Connectors 열기
Connectors 를 열고 App connectors 로 이동한 뒤 Mailgun 을 선택합니다.
연결 열기
관리할 연결을 엽니다.
프로젝트 선택
Linked projects 에서 해제할 프로젝트를 체크합니다.
확인
Unlink projects 를 클릭하고 확인합니다.
해제되면 해당 프로젝트는 이 연결을 통해 Mailgun에 접근할 수 없게 됩니다. 프로젝트에 Mailgun이 다시 필요하면 사용 가능한 연결에 다시 연결할 수 있습니다.
Mailgun 연결 삭제
워크스페이스 admin과 owner가 Mailgun 연결을 삭제할 수 있습니다.
연결을 삭제하는 것은 영구적이며 되돌릴 수 없습니다. 연결된 모든 프로젝트에서 자격 증명이 제거되며, 이 연결을 사용하는 앱은 새 연결을 추가할 때까지 작동을 멈춥니다.
삭제 전 Linked projects 섹션에서 현재 이 연결을 사용 중인 프로젝트를 확인하세요.
연결 삭제:
Connectors 열기
Connectors 를 열고 App connectors 로 이동한 뒤 Mailgun 을 선택합니다.
연결 열기
제거할 연결을 엽니다.
연결된 프로젝트 검토
Linked projects 섹션을 확인합니다.
삭제
Delete this connection 에서 Delete 를 클릭하고 확인합니다.