HubSpot에 앱 연결하기
CRM 플랫폼인 HubSpot에 앱을 연결하여 연락처 관리, 거래 추적, 영업 및 마케팅 워크플로우 자동화를 수행하세요.
HubSpot은 연락처, 회사, 거래, 지원 티켓을 관리하기 위한 고객 관계 관리(CRM) 플랫폼입니다. 연결하면 Lovable 앱에서 CRM 데이터를 읽고 쓰고, 워크플로우를 자동화하고, HubSpot 계정 위에서 내부 도구와 대시보드를 구축할 수 있습니다.
HubSpot를 연결하면 앱은 다음 작업이 가능합니다:
- CRM 연락처, 회사, 거래에 접근하고 관리
- 영업 파이프라인 및 거래 단계 생성/추적
- CRM 워크플로우 및 영업 프로세스 자동화
- 분석 및 리포팅 데이터 조회
- 티켓 및 고객 서비스 상호작용 관리
HubSpot은 앱이 HubSpot에 저장된 CRM 데이터, 영업 파이프라인, 고객 기록에 의존하는 경우에 적합합니다.
주요 활용 사례 및 예시 앱
| 예시 앱 | 프롬프트 예시 | 설명 |
|---|---|---|
| 리드 캡처 폼 | 리드 캡처 폼을 만들어줘. 누군가 이름, 이메일, 회사를 제출하면 HubSpot에서 연락처를 생성하거나 업데이트해줘. | 리드를 CRM에 직접 캡처하여 새 연락처가 HubSpot에 즉시 나타나도록 합니다. 사용자가 폼을 제출하면 앱이 입력받은 정보로 HubSpot 연락처 레코드를 생성하거나 업데이트해 영업팀이 후속 조치를 취할 수 있게 합니다. |
| 영업 파이프라인 대시보드 | 영업 파이프라인 대시보드를 만들어줘. HubSpot을 사용해 오픈 거래를 가져오고 단계별로 그룹화하고, 담당자 및 종료일 필터를 추가해줘. | HubSpot 데이터를 사용해 영업 파이프라인 활동을 시각화합니다. 앱이 HubSpot에서 거래 레코드를 가져와 파이프라인 단계별로 그룹화하고, 사용자가 결과를 필터링하여 파이프라인 상태와 진행 상황을 파악할 수 있게 합니다. |
| CRM 관리 도구 | CRM 관리 도구를 만들어줘. HubSpot을 사용해 연락처와 거래를 표시하고 주요 필드를 앱에서 직접 편집할 수 있게 해줘. | 단순화된 내부 인터페이스를 통해 CRM 레코드를 관리합니다. 앱이 HubSpot에서 연락처와 거래를 가져와 편집 가능한 테이블이나 폼에 표시하고, 업데이트를 CRM에 다시 기록합니다. |
| 지원 티켓 추적기 | 지원 티켓 추적기를 만들어줘. HubSpot을 사용해 오픈 티켓을 가져오고 상담원이 상태 업데이트와 메모 추가를 할 수 있게 해줘. | 단순화된 인터페이스를 통해 고객 지원 티켓을 관리합니다. 앱이 HubSpot에서 티켓 레코드를 가져와 필터링 가능한 목록으로 표시하고, 상담원이 티켓 속성을 업데이트하면 변경 사항을 CRM으로 다시 동기화합니다. |
| 연락처 보강 도구 | 연락처 보강 도구를 만들어줘. HubSpot을 사용해 추가 회사 정보나 속성으로 연락처를 업데이트해줘. | CRM 연락처 레코드를 추가 회사 정보로 보강합니다. 사용자가 연락처를 선택하거나 회사 도메인을 입력하면, 앱이 HubSpot 연락처 레코드를 회사 규모, 업종, 웹사이트 세부 정보 등의 속성으로 업데이트합니다. |
| CRM 기반 클라이언트 포털 | 클라이언트 포털을 만들어줘. HubSpot을 사용해 로그인한 각 고객에 대한 회사 정보, 거래 상태, 티켓 이력을 가져와줘. | 고객이 자신의 프로젝트와 지원 활동을 확인할 수 있도록 제공합니다. 사용자가 포털에 로그인하면 앱이 HubSpot에서 회사, 거래, 티켓 레코드를 가져와 안전한 대시보드에 표시합니다. |
| 거래 알림 (HubSpot + Slack) | 거래 알림 워크플로우를 만들어줘. HubSpot을 사용해 거래가 "Closed Won"으로 이동할 때 감지하고 Slack 채널에 메시지를 보내줘. | 중요한 파이프라인 이벤트를 팀에게 자동으로 알립니다. 앱이 HubSpot의 거래 단계 변경을 모니터링하고 Slack에 형식화된 알림을 게시해 팀이 새로운 거래와 마일스톤 소식을 받을 수 있게 합니다. |
HubSpot 연결하기
워크스페이스 admin 또는 owner가 HubSpot을 연결할 수 있습니다.
여러 개의 service key를 사용해 여러 HubSpot 연결을 만들 수 있습니다. 이는 환경 분리(예: 개발과 프로덕션)나 scope 권한을 통한 접근 제한에 유용합니다.
연결이 생성되면 워크스페이스의 모든 프로젝트에서 HubSpot을 사용할 수 있습니다.
사전 준비
HubSpot을 연결하기 전에 다음을 준비하세요:
- super admin access 또는 developer tools permissions를 가진 HubSpot 계정 (service key 생성에 필요)
- HubSpot service key
- Lovable 워크스페이스 owner 또는 admin 권한
이 커넥터를 통해 발생하는 모든 API 요청은 HubSpot API 사용량 제한에 포함됩니다. 제한은 HubSpot 구독에 따라 다르며 Lovable이 아니라 HubSpot에서 관리합니다.
Step 1: HubSpot service key 생성
service key를 사용하면 Lovable이 HubSpot API를 통해 HubSpot 계정에 안전하게 접근할 수 있습니다.
HubSpot service key를 생성하려면:
- HubSpot으로 이동하여 계정을 설정합니다.
- Development → Keys → Service keys로 이동합니다.
- Create service key를 클릭합니다.
- 설명이 포함된 이름을 입력합니다. 예:
Lovable integration. - Add new scope를 클릭하고 앱에 필요한 scope를 선택합니다. 예:
crm.objects.contacts.read와crm.objects.contacts.writecrm.objects.deals.read와crm.objects.deals.write
- scope를 선택한 후 Update를 클릭하고 선택한 scope를 검토합니다.
- Create를 클릭한 뒤 대화 상자에서 확인합니다.
- 생성한 service key를 열고 Show를 클릭하여 키를 표시합니다.
- Copy를 클릭하여 클립보드로 복사합니다.
service key는 비밀번호처럼 기능합니다. 안전하게 보관하고 절대 공개적으로 공유하지 마세요. 다음 단계에서 필요합니다.
자세한 지침은 HubSpot 문서를 참고하세요: Service keys.
Step 2: HubSpot을 Lovable에 연결
서로 다른 service key로 여러 연결을 생성할 수 있습니다.
HubSpot을 연결하려면:
- Connectors → App connectors로 이동하여 HubSpot을 선택합니다.
- Add connection을 클릭합니다.
- Display name: 연결 이름을 지정합니다. 예:
HubSpot Prod. - Service key: HubSpot service key (
pat-xxxx…)를 입력합니다. - Who can access this connection: 특정 사용자로 접근을 제한하거나 전체 워크스페이스를 초대합니다. 자세한 내용은 Connection-level access를 참고하세요.
- Connect를 클릭합니다.
연결이 완료되면 Lovable 앱에서 CRM 데이터를 다루고 연락처, 거래 및 기타 HubSpot 객체를 관리할 수 있습니다.
제한 사항
HubSpot 커넥터는 인증에 service key를 사용하며, REST API 요청만 지원합니다.
service key는 다음 작업을 수행할 수 없습니다:
- HubSpot 웹훅 또는 이벤트 구독 수신
- HubSpot UI 확장 내부 호출 인증
HubSpot 연결에서 프로젝트 연결 해제
Editor 이상 권한을 가진 사용자는 연결 자체를 삭제하지 않고 특정 프로젝트만 연결 해제할 수 있습니다. 연결은 다른 프로젝트에서 계속 사용할 수 있습니다.
연결 해제 방법:
Connectors 열기
Connectors를 열고 App connectors로 이동한 뒤 **HubSpot**를 선택합니다.
연결 열기
관리할 연결을 엽니다.
프로젝트 선택
Linked projects에서 연결 해제할 프로젝트를 선택합니다.
확인
Unlink projects를 클릭하고 확인합니다.
연결 해제 후 해당 프로젝트는 이 연결을 통해 HubSpot에 접근할 수 없습니다. 필요하면 다른 연결로 다시 연결할 수 있습니다.
HubSpot 연결 삭제
워크스페이스 admin 또는 owner가 HubSpot 연결을 삭제할 수 있습니다.
연결 삭제는 영구적이며 되돌릴 수 없습니다. 연결된 모든 프로젝트에서 인증 정보가 제거되며, 새 연결을 만들기 전까지 이 연결을 사용하던 앱은 동작을 멈춥니다.
삭제 전에 Linked projects 섹션에서 현재 이 연결을 사용 중인 프로젝트를 먼저 확인하세요.
삭제 방법:
Connectors 열기
Connectors를 열고 App connectors로 이동한 뒤 **HubSpot**를 선택합니다.
연결 열기
삭제할 연결을 엽니다.
연결된 프로젝트 확인
Linked projects 섹션을 확인합니다.
삭제
Delete this connection에서 Delete를 클릭하고 확인합니다.