이메일·SMS 플랫폼인 Klaviyo에 앱을 연결해 프로필, 리스트, 이벤트를 동기화하고 캠페인과 플로를 읽습니다.
Klaviyo에 앱 연결하기
이메일·SMS 플랫폼인 Klaviyo에 앱을 연결해 프로필, 리스트, 이벤트를 동기화하고 캠페인과 플로를 읽으세요.
Klaviyo는 고객 프로필, 리스트, 캠페인, 플로(flow)를 다루는 이메일·SMS 마케팅 플랫폼입니다. Klaviyo 커넥터를 사용하면 Lovable 앱이 공유 연결을 통해 Klaviyo 계정의 데이터를 읽고 업데이트할 수 있습니다. 이미 운영 중인 Klaviyo 계정을 기반으로 한 가입 양식, 프로필 조회, 캠페인 화면에 맞게 설계되었습니다.
Klaviyo는 앱 + 채팅 커넥터로 제공됩니다. 하나의 공유 연결이 빌드 중 프로젝트 채팅과 게시된 앱 모두에서 작동합니다.
회원가입 확인, 비밀번호 재설정, 영수증, 내부 알림 같은 일반적인 트랜잭션 이메일에는 내장된 Lovable Emails를 사용하세요. Klaviyo 프로필, 플로, 캠페인, SMS가 필요하거나 이미 Klaviyo에서 관리하는 계정을 써야 할 때 Klaviyo 커넥터를 사용하세요.
Klaviyo를 사용하면 앱에서 다음 작업을 할 수 있습니다.
- 프로필 조회, 그리고 구독 처리 없이 프로필 생성·업데이트
- 이메일 또는 SMS 수신에 동의한 프로필을 리스트에 구독 처리
- 가입이나 구매 같은 이벤트 추적
- 계정의 캠페인과 플로 읽기
- Klaviyo 플로에서 보내는 웹훅을 앱에서 수신
앱이 프로필만 생성하면 Klaviyo는 그 사람을 마케팅 수신자로 구독 처리하지 않습니다. 이메일이나 SMS를 받아야 하는 가입이라면 구독 호출에서 수신 동의를 기록해야 합니다.
주요 활용 사례 및 예시 앱
다음 예시는 Klaviyo로 만들 수 있는 앱과, 각 앱을 시작할 때 쓸 수 있는 프롬프트입니다.
| 예시 앱 | 프롬프트 예시 | 설명 |
|---|---|---|
| 뉴스레터 가입 | Klaviyo를 사용해 방문자가 동의 체크박스를 선택하면 이메일 주소를 우리 리스트에 구독 처리하는 가입 양식을 만들어줘. | 동의를 받아 뉴스레터 구독자를 모읍니다. 방문자가 이메일 마케팅 수신에 동의한 경우에만 앱이 주소를 Klaviyo로 보냅니다. |
| 프로필 조회 | Klaviyo를 사용해 이메일로 고객을 찾아 프로필을 보여 주는 내부 페이지를 만들어줘. | 앱을 벗어나지 않고 고객을 찾습니다. 앱이 일치하는 Klaviyo 프로필을 읽고 Klaviyo가 반환하는 필드를 보여 줍니다. |
| 구매 이벤트 | Klaviyo를 사용해 구매가 완료되면 Klaviyo에 Placed Order 이벤트를 기록하는 결제 화면을 만들어줘. | 주문 활동을 Klaviyo로 보냅니다. 결제가 완료되면 앱이 고객 프로필에 이벤트를 생성합니다. |
| 캠페인 리포트 | Klaviyo를 사용해 최근 이메일 캠페인과 상태를 나열하는 페이지를 만들어줘. | 앱에서 캠페인 상태를 확인합니다. 앱이 연결된 Klaviyo 계정에서 캠페인을 읽어 하나씩 나열합니다. |
| 플로 목록 | Klaviyo를 사용해 우리 Klaviyo 플로를 이름과 상태별로 나열하는 관리자 페이지를 만들어줘. | 앱에서 자동화를 검토합니다. 앱이 계정의 플로를 읽고 Klaviyo가 반환하는 이름과 상태를 보여 줍니다. |
| SMS 수신 동의 | Klaviyo를 사용해 방문자가 동의를 확인하면 전화번호를 SMS에 구독 처리하는 양식을 만들어줘. | 수신에 동의한 SMS 구독자를 추가합니다. 앱이 SMS 마케팅 동의를 기록하고 선택한 리스트에 프로필을 구독 처리합니다. |
Klaviyo 연결 방법
Klaviyo 연결을 만들 수 있는 사람은 플랜과 워크스페이스 설정에 따라 달라집니다. 앱 + 채팅 커넥터는 Free, Pro, Business 플랜에서 기본적으로 사용할 수 있습니다. Enterprise 플랜에서는 처음에 사실상 비활성화되어 있습니다. 관리자가 Connectors → Admin settings → App + chat connectors에서 바꾸기 전까지 연결 및 클라이언트를 만들 수 있는 사용자 설정의 기본값이 No one이기 때문입니다.
서로 다른 비공개 API 키로 Klaviyo 연결을 여러 개 만들 수 있습니다. 환경을 분리하거나(예: 개발과 프로덕션) 요청 한도(rate limit)를 관리할 때 유용합니다.
연결을 만든 뒤에는 연결을 사용할 프로젝트에 링크할 수 있습니다. 프로젝트에서 빌드하는 사람은 누구나 채팅에서 Lovable에게 자신의 프로젝트를 이 연결에 링크해 달라고 요청할 수 있습니다.
사전 요구 사항
Klaviyo를 연결하기 전에 다음을 준비하세요.
- Owner 또는 Admin 권한이 있는 Klaviyo 계정
- Klaviyo 비공개 API 키
- Lovable 워크스페이스의 연결 생성 권한(연결 및 클라이언트를 만들 수 있는 사용자 참고)
이 커넥터를 통한 API 호출은 Klaviyo 계정을 사용합니다. 청구와 요청 한도는 Lovable이 아닌 Klaviyo가 직접 관리합니다.
1단계: Klaviyo 비공개 API 키 발급하기
Klaviyo 비공개 API 키(private API key)는 Lovable 앱이 Klaviyo에 인증할 때 사용합니다. Klaviyo에서는 Owner나 Admin만 이 키를 만들 수 있습니다. 비공개 키는 pk_로 시작합니다. 짧은 사이트 ID 형태인 공개 API 키를 붙여 넣지 않도록 주의하세요.
Klaviyo 비공개 API 키는 다음 순서로 만듭니다.
API keys 열기
왼쪽 아래의 조직 이름을 클릭하고 Settings, API keys를 차례로 엽니다. API keys 페이지를 바로 열 수도 있습니다.
비공개 API 키 만들기
Create Private API Key를 클릭합니다. 키 이름을 정하고(예: Lovable integration) Full, Read-only, Custom 중에서 스코프를 고른 다음 Create를 선택합니다.
Lovable이 연결을 확인하려면 키에 accounts:read가 있어야 합니다. Full과 Read-only에는 이 스코프가 포함되어 있습니다. Custom 키에는 이 스코프를 직접 포함해야 하며, 그렇지 않으면 Connect가 실패합니다.
누군가를 구독 처리하는 가입 기능에는 lists:write, profiles:write, subscriptions:write가 필요합니다. Read-only 키로는 프로필, 캠페인, 플로를 나열할 수 있지만 구독 처리는 할 수 없습니다. 프로필을 나열하는 키에는 profiles:read가 필요합니다. 캠페인과 플로를 읽는 키에는 campaigns:read와 flows:read가 필요합니다.
키 복사
키를 복사해 안전하게 보관합니다. Klaviyo는 비공개 API 키를 한 번만 보여 주며, 나중에 키의 스코프를 바꿀 수 없습니다. 다른 스코프를 쓰려면 Klaviyo에서 키를 삭제하고 새 키를 만든 다음 Lovable 연결을 업데이트하세요.
비공개 API 키는 비밀번호와 같은 역할을 합니다. 안전하게 보관하고 절대 공개적으로 공유하지 마세요. 다음 단계에서 필요합니다.
자세한 내용은 Klaviyo 문서의 Create a private API key를 참고하세요.
2단계: Klaviyo를 Lovable에 연결하기
Klaviyo에서 받은 비공개 API 키를 연결 양식에 붙여 넣습니다.
Connectors에서 Klaviyo 열기
Connectors를 열고 Klaviyo를 선택합니다. 카탈로그를 열 수 있는 다른 위치는 커넥터를 찾을 수 있는 위치를 참고하세요.
연결 추가
Add connection을 클릭하고 App + chat connector를 선택합니다. 양식은 Details, Configure connection, Sharing의 접을 수 있는 섹션으로 나뉩니다.
연결 이름 지정
Details에서 Lovable이 연결 이름을 자동으로 채우며, 이 이름은 바꿀 수 있습니다. 이름은 Lovable 안에서 연결을 식별하는 데만 쓰입니다.
연결 구성
Configure connection에서 Private API key에 키를 붙여 넣습니다. 필드 아래에는 "Your private API key from Klaviyo"라는 안내가 표시됩니다. 필드 옆의 Get value를 클릭하면 Klaviyo의 API 키 페이지가 열립니다.
이 연결을 사용할 수 있는 사람 선택
Sharing에서 연결은 기본적으로 본인만 사용할 수 있으며 Private 라벨이 표시됩니다. 공유하려면 Share with others를 클릭하세요. 그런 다음 이메일로 워크스페이스 멤버를 추가하거나, Invite entire workspace를 클릭해 Lovable 워크스페이스의 모든 사람이 연결을 사용할 수 있게 합니다.
자세한 내용은 연결 및 클라이언트를 사용할 수 있는 사용자를 참고하세요.
연결
Connect를 클릭합니다. Lovable은 연결을 저장하기 전에 Klaviyo API로 비공개 API 키를 검증합니다.
연결되면 프로젝트에서 빌드하는 누구나 채팅에서 Lovable에게 자신의 프로젝트를 Klaviyo에 링크해 달라고 요청할 수 있습니다(구성된 연결 단위 접근 권한 기준). 그러면 Lovable 앱이 프로필을 동기화하고, 동의한 사람을 구독 처리하고, 이벤트를 추적하고, 캠페인과 플로를 읽을 수 있습니다.
제한 사항
Klaviyo 커넥터로는 다음 작업을 할 수 없습니다.
- 최종 사용자별 Klaviyo 로그인 지원. 각 연결은 링크된 모든 프로젝트가 공유하는 단일 Klaviyo 계정을 나타냅니다.
Klaviyo에서 비공개 API 키가 취소되거나 삭제되어 요청이 실패하면 새 키를 만들고 Lovable 연결을 업데이트하세요.
Klaviyo 연결 관리
연결은 Connectors에서 관리합니다. **Klaviyo**를 선택한 다음 연결을 여세요.
- Unlink projects를 사용하면 다른 프로젝트에서 연결을 계속 사용할 수 있도록 유지하면서 특정 프로젝트의 Klaviyo 접근 권한만 제거할 수 있습니다. 단계별 절차는 연결에서 프로젝트 연결 해제를 참고하세요.
- Delete the connection을 사용하면 워크스페이스에서 연결을 완전히 제거할 수 있습니다. 삭제는 영구적이며 링크된 모든 프로젝트에서 자격 증명이 제거되고, Klaviyo를 사용하는 앱 기능은 새 연결을 추가할 때까지 작동하지 않습니다. 단계와 삭제 권한은 연결 삭제를 참고하세요.