뉴스레터 플랫폼 beehiiv에 앱을 연결해 구독자를 추가하고 publication의 게시물을 보여줍니다.
beehiiv에 앱 연결하기
뉴스레터 플랫폼 beehiiv에 앱을 연결해 Lovable 앱에서 구독자를 추가하고 게시물을 보여주세요.
beehiiv는 publication(발행물), 게시물, 구독자를 다루는 뉴스레터 플랫폼입니다. beehiiv 커넥터를 사용하면 Lovable 앱이 공유 연결을 통해 구독자를 추가하고 게시물을 보여줄 수 있습니다. 이미 운영 중인 beehiiv publication을 활용하는 가입 폼, 게시물 목록, 그 밖의 기능을 염두에 두고 설계되었습니다.
beehiiv는 앱 + 채팅 커넥터로 제공됩니다. 하나의 공유 연결이 빌드 중 프로젝트 채팅과 게시된 앱 모두에서 작동합니다.
앱에서 이메일을 발송하려면 Lovable Emails를 사용하세요. beehiiv는 뉴스레터 구독자, 게시물, publication 데이터가 필요할 때 사용합니다.
beehiiv를 연결하면 앱에서 다음 작업을 할 수 있습니다.
- API 키로 접근할 수 있는 publication 목록 조회
- publication의 최근 게시물 표시
- 이메일 주소를 구독자로 추가
- 요청할 경우 기존 구독자를 재활성화
- 초안 게시물 저장
구독자를 추가해도 따로 요청하지 않으면 환영 이메일은 발송되지 않습니다. 새 게시물은 발행이나 예약을 요청하지 않으면 초안 상태로 남습니다.
주요 활용 사례 및 예시 앱
다음 예시는 beehiiv로 만들 수 있는 기능을 보여주며, 각 항목에는 시작점으로 쓸 프롬프트가 함께 있습니다.
| 예시 앱 | 예시 프롬프트 | 설명 |
|---|---|---|
| 뉴스레터 가입 | beehiiv를 사용해 이메일 주소를 우리 뉴스레터에 추가하는 가입 폼을 만들어줘. | 사이트에서 구독자를 모읍니다. 앱이 beehiiv publication에 주소를 추가하며, 따로 요청하지 않으면 환영 이메일은 보내지 않습니다. |
| 최신 게시물 | beehiiv를 사용해 우리 publication의 최신 게시물을 나열하는 페이지를 만들어줘. | 사이트에 최근 뉴스레터 호를 보여줍니다. 앱이 publication의 게시물을 나열하고 각 항목을 제목에 연결합니다. |
| 출시 대기 명단 | beehiiv를 사용해 가입자를 우리 beehiiv publication에 추가하는 대기 명단 페이지를 만들어줘. | 출시 관심을 뉴스레터로 모읍니다. 앱이 각 가입을 선택한 publication의 구독자로 저장합니다. |
| 여러 publication 선택기 | beehiiv를 사용해 우리 publication 목록을 보여주고 방문자가 고른 publication을 구독할 수 있는 페이지를 만들어줘. | 어떤 뉴스레터에 참여할지 직접 고르게 합니다. 앱이 API 키로 접근할 수 있는 publication을 나열하고 선택된 publication에 주소를 추가합니다. |
| 게시물 아카이브 | beehiiv를 사용해 우리 publication의 지난 게시물을 제목과 상태와 함께 보여주는 아카이브를 만들어줘. | 발행된 게시물과 초안을 앱에서 둘러봅니다. 앱이 게시물을 나열하고 beehiiv가 반환하는 제목과 상태를 보여줍니다. |
| 구독자 관리 창구 | beehiiv를 사용해 우리 팀이 독자를 뉴스레터에 추가할 때 쓰는 내부 폼을 만들어줘. | 앱을 벗어나지 않고 구독자를 추가합니다. 앱이 이메일 주소를 beehiiv로 보내고 구독이 저장되면 확인해 줍니다. |
beehiiv 연결 방법
beehiiv 연결을 만들 수 있는 사용자는 플랜과 워크스페이스 설정에 따라 달라집니다. 앱 + 채팅 커넥터는 Free, Pro, Business 플랜에서 기본적으로 사용할 수 있습니다. Enterprise 플랜에서는 처음에 사실상 비활성화되어 있습니다. admin이 Connectors → Admin settings → App + chat connectors에서 변경하기 전까지 연결 및 클라이언트를 만들 수 있는 사용자가 No one으로 설정됩니다.
서로 다른 API 키로 여러 beehiiv 연결을 만들 수 있습니다. 환경을 분리하거나(예: development와 production) 사용량 제한을 관리할 때 유용합니다.
연결을 만든 후 사용할 프로젝트에 연결을 연결할 수 있습니다. 프로젝트에서 빌드하는 사용자는 누구나 채팅에서 Lovable에 프로젝트를 연결해 달라고 요청할 수 있습니다.
사전 준비
beehiiv를 연결하기 전에 다음을 준비하세요.
- Owner 또는 Admin 권한을 가진 beehiiv 워크스페이스
- beehiiv API 키
- Lovable 워크스페이스에서 연결 만들기 권한(연결 및 클라이언트를 만들 수 있는 사용자 참고)
이 커넥터를 통한 API 호출은 beehiiv 플랜에 포함됩니다. 청구와 할당량은 Lovable이 아닌 beehiiv에서 직접 처리합니다.
1단계: beehiiv API 키 발급받기
beehiiv API 키를 사용하면 Lovable 앱이 beehiiv에 인증할 수 있습니다. beehiiv에서는 워크스페이스 Owner 또는 Admin만 키를 만들 수 있습니다.
beehiiv API 키를 만들려면 다음 단계를 따르세요.
API 설정 열기
beehiiv에 로그인합니다. Settings를 열고 Workspace Settings 아래 API로 이동해도 됩니다.
키 만들기
Create New API Key를 클릭합니다. 키 이름을 지정한 뒤(예: Lovable integration) Create New Key를 클릭합니다. beehiiv가 키를 만들기 전에 본인 확인을 요구할 수 있습니다.
기본적으로 키는 워크스페이스의 모든 publication에 접근할 수 있습니다. 특정 publication으로 제한할 수도 있습니다. 제한된 키는 해당 publication만 나열하며 다른 publication에 대한 요청은 실패합니다.
키 복사하기
키를 복사해 안전하게 보관합니다. beehiiv는 키를 한 번만 표시합니다. 저장한 뒤 I've saved the key를 클릭합니다.
API 키는 비밀번호처럼 작동합니다. 안전하게 보관하고 절대 공개적으로 공유하지 마세요. 다음 단계에서 필요합니다.
자세한 내용은 beehiiv 문서의 Create an API key를 참고하세요.
2단계: beehiiv를 Lovable에 연결하기
beehiiv에서 발급받은 API 키를 연결 양식에 붙여넣습니다.
Connectors에서 beehiiv 열기
Connectors를 열고 beehiiv를 선택합니다. 카탈로그를 열 수 있는 다른 위치는 커넥터를 찾을 수 있는 곳을 참고하세요.
연결 추가하기
Add connection을 클릭하고 App + chat connector를 선택합니다. 양식은 Details, Configure connection, Sharing 세 개의 접을 수 있는 섹션으로 나뉩니다.
연결 이름 지정하기
Details에서 Lovable이 연결 이름을 채워 주며 직접 바꿀 수 있습니다. 이 이름은 Lovable 안에서 연결을 식별할 때만 사용됩니다.
연결 구성하기
Configure connection에서 키를 API key에 붙여넣습니다. 필드 아래 힌트에는 "Your beehiiv API key"가 표시됩니다. 필드 옆의 Get API key를 누르면 beehiiv의 API 설정이 열립니다.
이 연결을 사용할 사용자 선택하기
Sharing에서 연결은 기본적으로 본인만 사용할 수 있으며 Private 라벨이 표시됩니다. 공유하려면 Share with others를 클릭합니다. 그다음 이메일로 워크스페이스 멤버를 추가하거나, Invite entire workspace를 클릭해 Lovable 워크스페이스의 모든 사용자가 연결을 사용할 수 있게 합니다.
자세한 내용은 연결 및 클라이언트를 사용할 수 있는 사용자를 참고하세요.
연결하기
Connect를 클릭합니다. Lovable은 연결을 저장하기 전에 beehiiv API로 API 키를 확인합니다.
연결되면 프로젝트에서 빌드하는 사용자는 누구나 구성된 연결 수준 접근 권한에 따라 채팅에서 Lovable에 프로젝트를 beehiiv에 연결해 달라고 요청할 수 있습니다. 이후 Lovable 앱은 해당 키로 접근할 수 있는 publication에 구독자를 추가하고 게시물을 보여줄 수 있습니다.
제한 사항
beehiiv 커넥터는 다음을 하지 못합니다.
- beehiiv가 해당 워크스페이스에 Send API를 활성화하지 않았다면 게시물을 발행하거나 예약하지 못합니다. beehiiv는 Send API를 Enterprise 기능으로 문서화합니다. 커넥터는 초안 저장까지는 할 수 있습니다.
- publication에 아직 없는 구독자 custom field를 설정하지 못합니다.
- beehiiv의 조직 단위 한도인 분당 180회 요청을 넘지 못합니다.
- 관리형 웹훅으로 구독이나 게시물 이벤트를 수신하지 못합니다. Lovable에 이런 이벤트를 받도록 요청한다면, 앱은 무언가를 변경하기 전에 beehiiv의 웹훅 서명을 검증해야 합니다.
- 최종 사용자별 beehiiv 로그인을 지원하지 못합니다. 각 연결은 연결된 모든 프로젝트가 공유하는 하나의 beehiiv 계정을 나타냅니다.
beehiiv에서 API 키가 취소되거나 교체되어 요청이 실패한다면, 새 키를 만들어 Lovable 연결을 업데이트하세요.
beehiiv 연결 관리
연결은 Connectors에서 관리합니다. **beehiiv**을 선택한 다음 연결을 여세요.
- Unlink projects를 사용하면 다른 프로젝트에서 연결을 계속 사용할 수 있도록 유지하면서 특정 프로젝트의 beehiiv 접근 권한만 제거할 수 있습니다. 단계별 절차는 연결에서 프로젝트 연결 해제를 참고하세요.
- Delete the connection을 사용하면 워크스페이스에서 연결을 완전히 제거할 수 있습니다. 삭제는 영구적이며 연결된 모든 프로젝트에서 자격 증명이 제거되고, beehiiv을 사용하는 앱 기능은 새 연결을 추가할 때까지 작동하지 않습니다. 단계와 삭제 권한은 연결 삭제를 참고하세요.