소규모 비즈니스용 회계·인보이스 플랫폼인 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 연결하기
Wave 연결을 만들 수 있는 사용자는 플랜과 워크스페이스 설정에 따라 다릅니다. 앱 + 채팅 커넥터는 Free, Pro, Business 플랜에서 기본으로 제공됩니다. Enterprise 플랜에서는 처음에 사실상 비활성화되어 있습니다. admin이 변경하기 전까지 연결 및 클라이언트를 만들 수 있는 사용자의 기본값이 No one이기 때문입니다.
서로 다른 Wave 계정을 사용해 여러 Wave 연결을 만들 수 있으며, 비즈니스, 환경, 클라이언트 계정을 분리할 때 유용합니다.
연결이 생성되면 Wave는 workspace의 모든 프로젝트에서 사용 가능합니다. 프로젝트에서 빌드하는 사람은 누구나 채팅에서 Lovable에게 프로젝트를 링크해 달라고 요청할 수 있습니다.
사전 준비
Wave를 연결하기 전에 다음을 준비하세요.
- 앱에 필요한 비즈니스에 접근할 수 있는 Wave 계정
- Lovable workspace에서 연결을 만들 수 있는 권한(연결 및 클라이언트를 만들 수 있는 사용자 참조)
이 connector를 통한 모든 API 요청은 Wave 계정의 한도와 가용성에 따라 처리됩니다. 청구와 할당량은 Lovable이 아닌 Wave에서 직접 관리됩니다.
Wave 연결 설정
Connectors에서 Wave 열기
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 전체에 연결을 공개합니다.
자세한 내용은 연결 및 클라이언트를 사용할 수 있는 사용자를 참고하세요.
Wave에 연결하고 권한 승인
Connect를 클릭합니다. Wave 인증 창이 열리므로 브라우저에서 팝업을 차단하지 않도록 하세요. 차단되어 있다면 Lovable이 대신 리다이렉트합니다.
메시지가 표시되면 Wave에 로그인하고 요청된 권한을 검토한 뒤 Allow를 클릭합니다.
확인 메시지와 함께 Lovable로 다시 리다이렉트됩니다.
연결이 완료되면 프로젝트에서 작업하는 누구든(구성된 connection-level access 기준) Lovable 채팅에서 프로젝트를 Wave에 연결해 달라고 요청할 수 있습니다. Lovable 앱은 이후 connector 게이트웨이를 통해 Wave를 호출하고 선택된 scope에서 허용된 Wave 리소스를 활용할 수 있습니다.
제한 사항
Wave connector는 다음을 수행할 수 없습니다.
- Wave 웹훅 또는 이벤트 알림 수신
- 엔드 유저별 Wave 로그인 지원. 각 연결은 연결된 모든 프로젝트에서 공유되는 단일 Wave 계정을 나타냅니다.
Wave 측에서 인증이 취소된 경우 API 호출이 성공하려면 Lovable에서 연동을 다시 연결해야 합니다.
Wave 연결 관리
연결은 Connectors에서 관리합니다. **Wave**을 선택한 다음 연결을 여세요.
- Unlink projects를 사용하면 다른 프로젝트에서 연결을 계속 사용할 수 있도록 유지하면서 특정 프로젝트의 Wave 접근 권한만 제거할 수 있습니다. 단계별 절차는 연결에서 프로젝트 연결 해제를 참고하세요.
- Delete the connection을 사용하면 워크스페이스에서 연결을 완전히 제거할 수 있습니다. 삭제는 영구적이며 연결된 모든 프로젝트에서 자격 증명이 제거되고, Wave을 사용하는 앱 기능은 새 연결을 추가할 때까지 작동하지 않습니다. 단계와 삭제 권한은 연결 삭제를 참고하세요.