소규모 비즈니스용 회계·인보이스 플랫폼인 Wave에 앱을 연결해 고객, 상품, 인보이스, 견적서, 비즈니스 회계 데이터를 활용합니다.
Wave에 앱 연결하기
회계·인보이스 플랫폼인 Wave에 앱을 연결해 고객, 상품, 인보이스, 견적서, 비즈니스 회계 데이터를 활용하는 앱을 구축하세요.
Wave는 소규모 비즈니스를 위한 회계·인보이스 플랫폼입니다. Wave connector를 통해 Lovable 앱이 Wave의 GraphQL API로 비즈니스, 고객, 상품, 인보이스, 견적서, 공급업체, 계정, 판매세, 거래 데이터를 읽고 관리할 수 있습니다.
Wave를 연결하면 앱은 다음 작업이 가능합니다.
- 비즈니스 목록 조회 및 회계 메타데이터 읽기
- 고객, 상품, 인보이스, 견적서 생성 및 수정
- 계정, 판매세, 공급업체, 거래 데이터 쿼리
- Wave 데이터를 기반으로 소규모 비즈니스 재무 워크플로우 구축
Wave connector는 OAuth를 통해 단일 Wave 계정에 연결됩니다. 연결된 Wave 비즈니스와 연동된 소규모 비즈니스 대시보드, 인보이스 워크플로우, 고객 관리 도구, 재무 운영 앱에 적합합니다.
주요 활용 사례 및 예시 앱
| 예시 앱 | 프롬프트 예시 | 설명 |
|---|---|---|
| 소규모 비즈니스 재무 대시보드 | Use Wave and build a dashboard that shows my businesses, customers, unpaid invoices, and recent transactions. | Wave 비즈니스 활동을 하나의 워크스페이스에서 추적합니다. 앱이 회계 메타데이터, 인보이스, 고객, 거래를 읽어 비즈니스 오너가 Wave를 열지 않고도 업무를 모니터링할 수 있습니다. |
| 인보이스 관리 앱 | Use Wave and build an app where I can list invoices, filter by customer, and create draft invoices for new work. | 맞춤 인터페이스에서 인보이스 워크플로우를 관리합니다. 앱이 Wave 인보이스·고객 데이터를 처리하고 내부 워크플로우 메모는 Lovable 앱에 별도로 저장합니다. |
| 고객 계정 포털 | Use Wave and build a customer portal that shows invoice history and customer details for each account manager. | 팀에게 고객 청구 데이터를 집중적으로 보여줍니다. 앱이 Wave 고객과 인보이스를 읽고 내부 계정 관리 워크플로우에 맞게 구성합니다. |
| 상품·서비스 카탈로그 | Use Wave and build a catalog manager that lists my products and services and lets me update descriptions and prices. | Wave 상품·서비스를 더 쉽게 검토할 수 있게 합니다. 앱이 상품 레코드를 읽고 업데이트해 팀이 맞춤형 인터페이스에서 청구 항목을 관리할 수 있습니다. |
| 견적서 추적 도구 | Use Wave and build an estimate tracker that lists estimates, groups them by status, and helps me follow up with customers. | Wave 견적서를 영업 후속 조치 워크플로우로 전환합니다. 앱이 견적서·고객 데이터를 읽고 리마인더, 필터, 내부 상태 추적을 추가합니다. |
| 공급업체·비용 개요 | Use Wave and build an app that shows vendors, accounts, and recent transactions for my finance team. | 재무팀 검토를 위한 Wave 회계 데이터를 표시합니다. 앱이 공급업체, 계정, 거래 데이터를 쿼리해 재무팀이 목적에 맞는 뷰에서 활동을 검토할 수 있습니다. |
Wave 연결하기
Workspace admin과 owner는 connector가 workspace에서 사용 가능한 경우 Wave를 연결할 수 있습니다. Connector 가용성은 workspace app connector 설정을 따릅니다. Free, Pro, Business 플랜에서는 기본적으로 활성화되어 있고 Enterprise 플랜에서는 admin이 활성화하지 않는 한 기본적으로 비활성화되어 있습니다.
서로 다른 Wave 계정을 사용해 여러 Wave 연결을 만들 수 있으며, 비즈니스, 환경, 클라이언트 계정을 분리할 때 유용합니다.
연결이 생성되면 Wave는 workspace의 모든 프로젝트에서 사용 가능합니다. 프로젝트에서 작업하는 누구든 Lovable 채팅에서 프로젝트를 연결해 달라고 요청할 수 있습니다.
사전 준비
Wave를 연결하기 전에 다음을 준비하세요.
- 연결할 Wave 계정
- 앱에 필요한 Wave 비즈니스 데이터 접근 권한
- Lovable workspace owner 또는 admin 역할
이 connector를 통한 모든 API 요청은 Wave 계정의 한도와 가용성에 따라 처리됩니다. 청구와 할당량은 Lovable이 아닌 Wave에서 직접 관리됩니다.
Wave 연결 설정
Connectors에서 Wave 열기
Connectors → App connectors로 이동해 Wave를 선택합니다.
연결 추가
Add connection을 클릭합니다.
연결 이름 입력
Display name에 연결 이름을 입력합니다. 예: Wave Main Business. 이 이름은 Lovable 내에서 연결을 식별하는 데만 사용됩니다.
scope 검토 (선택 사항)
Advanced settings를 펼쳐 앱이 요청하는 권한을 확인합니다. 일반적인 Wave 활용 사례에 맞는 기본 scope가 미리 선택되어 있습니다.
| Scope | 허용 작업 | 기본값 |
|---|---|---|
User: read (user:read) | 인증된 Wave 사용자 프로필 읽기 | 필수 |
Business: read (business:read) | 사용자가 접근 가능한 Wave 비즈니스 목록 및 읽기 | 필수 |
Accounts: full access (account:*) | 회계 계정 읽기 및 관리 | 켜짐 |
Customers: full access (customer:*) | 고객 생성·읽기·수정 | 켜짐 |
Estimates: full access (estimate:*) | 견적서 생성·읽기·수정·발송 | 켜짐 |
Invoices: full access (invoice:*) | 인보이스 생성·읽기·수정·발송 | 켜짐 |
Products: full access (product:*) | 상품·서비스 생성·읽기·수정 | 켜짐 |
Sales taxes: full access (sales_tax:*) | 판매세 생성·읽기·수정 | 켜짐 |
Transactions: full access (transaction:*) | 거래 작성 및 관리 | 켜짐 |
Vendors: full access (vendor:*) | 공급업체 생성·읽기·수정 | 켜짐 |
전체 API 문서는 Wave API 레퍼런스를 참고하세요.
접근 권한 설정
Who can access this connection 아래에서 workspace 내 연결 사용 권한을 결정합니다.
- Only you (기본값): 연결을 만든 사람만 사용 가능합니다.
- Invite specific people: 본인과 명시적으로 추가된 workspace 멤버만 사용 가능합니다.
- Invite entire workspace: Invite entire workspace를 클릭해 Lovable workspace 전체에 연결을 공개합니다.
자세한 내용은 Who can manage connections를 참고하세요.
Wave에 연결하고 권한 승인
Connect를 클릭합니다. Wave 인증 창이 열리므로 브라우저에서 팝업을 차단하지 않도록 하세요. 차단되어 있다면 Lovable이 대신 리다이렉트합니다.
메시지가 표시되면 Wave에 로그인하고 요청된 권한을 검토한 뒤 Allow를 클릭합니다.
확인 메시지와 함께 Lovable로 다시 리다이렉트됩니다.
연결이 완료되면 프로젝트에서 작업하는 누구든(구성된 connection-level access 기준) Lovable 채팅에서 프로젝트를 Wave에 연결해 달라고 요청할 수 있습니다. Lovable 앱은 이후 connector 게이트웨이를 통해 Wave를 호출하고 선택된 scope에서 허용된 Wave 리소스를 활용할 수 있습니다.
제한 사항
Wave connector는 다음을 수행할 수 없습니다.
- 선택된 OAuth scope 범위 밖의 Wave 리소스 접근
- 연결된 Wave 계정이 접근할 수 없는 Wave 비즈니스 접근
- Wave 웹훅 또는 이벤트 알림 수신
- Wave API 한도, 계정 가용성, 플랜 제한 우회
- 엔드 유저별 Wave 로그인 지원. 각 연결은 연결된 모든 프로젝트에서 공유되는 단일 Wave 계정을 나타냅니다.
Wave 측에서 인증이 취소된 경우 API 호출이 성공하려면 Lovable에서 연동을 다시 연결해야 합니다.
Wave 연결에서 프로젝트 연결 해제하기
Editor 이상의 권한을 가진 멤버는 연결 자체를 삭제하지 않고 특정 프로젝트의 연결을 해제할 수 있습니다. 다른 프로젝트는 연결을 계속 사용할 수 있습니다.
프로젝트 연결을 해제하는 방법은 다음과 같습니다.
Connectors 열기
Connectors를 열고 App connectors로 이동해 **Wave**를 선택합니다.
연결 열기
관리할 연결을 엽니다.
프로젝트 선택
Linked projects 아래에서 연결 해제할 프로젝트를 선택합니다.
확인
Unlink projects를 클릭하고 확인합니다.
연결이 해제되면 해당 프로젝트는 이 연결을 통해 Wave에 접근할 수 없습니다. 프로젝트에 다시 Wave가 필요하다면 사용 가능한 연결에 다시 연결하면 됩니다.
Wave 연결 삭제하기
Workspace admin과 owner는 Wave 연결을 삭제할 수 있습니다. 연결을 생성했거나 명시적으로 접근 권한을 부여받은 멤버도 삭제할 수 있습니다.
연결 삭제는 영구적이며 되돌릴 수 없습니다. 연결된 모든 프로젝트에서 자격 증명이 제거되며 이 연결을 사용하는 앱은 새 연결이 추가될 때까지 작동을 멈춥니다.
삭제 전에 Linked projects 섹션에서 현재 연결을 사용 중인 프로젝트를 확인하세요.
연결을 삭제하는 방법은 다음과 같습니다.
Connectors 열기
Connectors를 열고 App connectors로 이동해 **Wave**를 선택합니다.
연결 열기
제거할 연결을 엽니다.
연결된 프로젝트 확인
Linked projects 섹션을 확인합니다.
삭제
Delete this connection 아래에서 Delete를 클릭하고 확인합니다.