CRM 플랫폼인 Salesforce에 앱을 연결하여 Accounts, Contacts, Cases 등의 레코드를 읽고 관리합니다.
Salesforce에 앱 연결하기
CRM 플랫폼인 Salesforce에 앱을 연결하여 Accounts, Contacts, Cases 등의 레코드를 읽고 관리합니다.
Salesforce는 고객 관계, 영업 파이프라인, 지원 케이스를 관리하는 CRM 플랫폼입니다. Salesforce 커넥터를 사용하면 Lovable 앱이 사용자의 Salesforce 조직(org)을 통해 CRM 레코드를 쿼리하고 업데이트할 수 있습니다. Salesforce 데이터에 실시간으로 접근해야 하는 내부 도구, 고객 포털, 지원 대시보드를 위해 설계되었습니다.
Salesforce를 사용하면 앱에서 다음과 같은 작업이 가능합니다:
- SOQL을 사용해 Accounts, Contacts, Leads, Cases 등 표준 오브젝트 쿼리
- 대시보드와 내부 도구에서 CRM 레코드 표시 및 필터링
- Salesforce REST API를 통해 레코드 생성 및 업데이트
- 리포팅과 데이터 내보내기를 위한 커스텀 SOQL 쿼리 실행
영업 운영 도구, 지원 포털, Salesforce 데이터를 팀에 노출해야 하는 앱에 적합합니다.
주요 활용 사례 및 예시 앱
| 예시 앱 | 프롬프트 예시 | 설명 |
|---|---|---|
| 지원 케이스 대시보드 | Salesforce를 사용해서 우선순위와 상태별로 미해결 Cases를 보여주는 대시보드를 만들어줘. | 우선순위별로 정리된 지원 큐의 실시간 뷰. 앱이 Salesforce에서 Cases를 가져와 그룹화하여 상담원이 먼저 처리해야 할 항목을 볼 수 있게 합니다. |
| 어카운트 상태 트래커 | Salesforce를 사용해서 어카운트 상태 점수와 최근 활동을 보여주는 내부 도구를 만들어줘. | 활동 이력과 핵심 필드를 포함한 어카운트별 요약. 앱이 SOQL 쿼리를 실행해 각 어카운트의 컨택트 수, 진행 중인 기회, 최근 케이스 이력을 노출합니다. |
| 리드 파이프라인 뷰어 | Salesforce를 사용해서 단계와 담당자별 Leads를 보여주는 파이프라인 보드를 만들어줘. | 영업 단계별로 정리된 칸반 스타일의 Leads 보드. 앱이 Salesforce Leads를 상태별로 쿼리하고 렌더링해 영업 담당자가 파이프라인 진행 상황을 추적할 수 있게 합니다. |
| 컨택트 디렉토리 | Salesforce를 사용해서 어카운트와 역할이 함께 표시되는 검색 가능한 Contacts 디렉토리를 만들어줘. | Salesforce 조직과 연결된 필터링 가능한 컨택트 목록. 앱이 Contact 레코드를 가져오고 사용자가 도구를 벗어나지 않고 이름, 어카운트, 역할로 검색할 수 있게 합니다. |
| 케이스 상세 뷰 | Salesforce를 사용해서 사용자가 이메일로 자신의 Cases를 조회할 수 있는 지원 포털을 만들어줘. | 고객이 미해결 Cases를 확인할 수 있는 셀프서비스 포털. 앱이 제공된 이메일로 Cases를 쿼리하고 각 케이스의 상태, 제목, 최근 업데이트를 표시합니다. |
| 영업 활동 리포트 | Salesforce를 사용해서 담당자별 마감된 기회의 주간 리포트를 만들어줘. | 담당자별로 그룹화된 성사된 기회의 자동화된 리포트. 앱이 Opportunities에 대해 SOQL 쿼리를 실행하고 주간 영업 리뷰용 요약 테이블을 렌더링합니다. |
Salesforce 연결 방법
워크스페이스 admins와 owners가 Salesforce를 연결할 수 있습니다. 서로 다른 organization 또는 Connected App을 사용해 여러 개의 Salesforce 연결을 생성할 수 있으며, 이는 production과 sandbox 환경을 분리할 때 유용합니다.
연결이 생성되면 Salesforce는 워크스페이스 내 모든 프로젝트에서 사용할 수 있습니다. 프로젝트를 빌드 중인 누구나 채팅으로 Lovable에게 프로젝트를 연결해 달라고 요청할 수 있습니다.
사전 준비 사항
Salesforce를 연결하기 전에 다음을 확인하세요:
- Salesforce 조직(Developer Edition, production 또는 sandbox)
- OAuth가 활성화된 Salesforce Connected App (아래 Step 1 참조)
- Lovable 워크스페이스 owner 또는 admin 역할
이 커넥터를 통한 모든 API 요청은 사용자의 Salesforce organization API 한도에 포함됩니다. 청구 및 할당량은 Lovable이 아닌 Salesforce에서 직접 처리합니다.
Step 1: Salesforce Connected App 만들기
Salesforce는 OAuth를 통한 서드파티 액세스 승인에 Connected Apps를 사용합니다. Lovable용 Client ID와 Client Secret을 얻기 위해 하나 만들어야 합니다.
Salesforce에서 Setup 열기
Salesforce 조직에 로그인합니다. 오른쪽 상단 톱니바퀴 아이콘을 클릭하고 Setup을 선택합니다.
App Manager로 이동
왼쪽 사이드바에서 App Manager를 검색하고 Apps 아래에서 선택합니다.
새 Connected App 생성
오른쪽 상단의 New Connected App을 클릭합니다.
필수 필드를 작성합니다:
- Connected App Name: 예:
Lovable Integration - API Name: 이름에서 자동으로 채워짐
- Contact Email: 본인 이메일 주소
OAuth 설정 활성화
API (Enable OAuth Settings) 아래에서 Enable OAuth Settings를 체크합니다.
Callback URL을 다음으로 설정합니다:
https://lovable.dev/oauth/callbackSelected OAuth Scopes에 다음을 추가합니다:
- Access and manage your data (api)
- Perform requests at any time (refresh_token, offline_access)
다른 설정은 모두 기본값으로 둡니다.
저장하고 자격 증명 가져오기
Save, 그 다음 Continue를 클릭합니다.
Salesforce가 앱을 프로비저닝하는 데 몇 분이 걸릴 수 있습니다. 준비가 되면 Connected App을 열고 Manage Consumer Details를 클릭해 자격 증명을 확인합니다:
- Consumer Key: 이것이 Client ID입니다
- Consumer Secret: 이것이 Client Secret입니다
두 값을 모두 복사해 안전하게 보관하세요.
Client Secret은 비밀번호처럼 동작합니다. 안전하게 보관하고 공개적으로 공유하지 마세요. 다음 단계에서 필요합니다.
자세한 내용은 Salesforce Connected Apps documentation을 참조하세요.
Step 2: Salesforce를 Lovable에 연결
Connectors에서 Salesforce 열기
Connectors → App connectors로 가서 Salesforce를 선택합니다.
연결 추가
Add connection을 클릭합니다.
자격 증명 입력
연결 필드를 채웁니다:
- Display name: 연결 이름. 예:
Salesforce Prod. 이 이름은 Lovable 내부에서 연결을 식별하는 용도로만 사용됩니다. - Environment: production organization과 Developer Edition에는 Production을 선택합니다. 조직이
test.salesforce.comsandbox인 경우에만 Sandbox를 선택합니다. - Account URL: organization의 My Domain URL. 예:
https://acme.my.salesforce.com. Setup → My Domain에서 찾을 수 있습니다. - Client ID: Connected App의 Consumer Key
- Client Secret: Connected App의 Consumer Secret
이 연결에 접근할 수 있는 사람 선택
Who can access this connection에서 워크스페이스 내 누가 연결을 사용할 수 있는지 결정합니다:
- Only you (기본값): 연결을 만든 사람만 연결과 관련 데이터를 사용할 수 있습니다.
- Invite specific people: 본인과 명시적으로 추가한 워크스페이스 멤버만 연결과 관련 데이터를 사용할 수 있습니다.
- Invite entire workspace: Invite entire workspace를 클릭해 Lovable 워크스페이스 모든 사람이 연결을 사용할 수 있도록 합니다.
자세한 내용은 Connection-level access를 참조하세요.
Salesforce에서 승인
Connect를 클릭합니다. Salesforce 승인 창이 열리므로 브라우저가 팝업을 차단하지 않도록 합니다. 차단된다면 Lovable이 대신 리디렉션합니다.
프롬프트가 나오면 Salesforce에 로그인하고, 요청된 권한을 검토한 뒤 Allow를 클릭합니다.
Lovable로 다시 리디렉션되고 확인 메시지가 표시됩니다.
연결되면 프로젝트를 빌드 중인 누구나 채팅으로 Lovable에게 프로젝트를 Salesforce에 연결해 달라고 요청할 수 있습니다(구성된 connection-level access에 따라). 그러면 Lovable 앱이 Salesforce 조직을 통해 CRM 레코드를 쿼리하고 업데이트할 수 있습니다.
제한 사항
Salesforce 커넥터는 다음을 할 수 없습니다:
- end-user별 Salesforce 로그인을 지원하지 않습니다. 각 연결은 해당 연결에 연결된 모든 프로젝트가 공유하는 단일 Salesforce organization을 나타냅니다.
*.salesforce.com도메인 외부의 organization에 접근할 수 없습니다.- Salesforce Bulk API 또는 Streaming API 엔드포인트를 사용할 수 없습니다.
Salesforce 측에서 승인이 취소된 경우(예: Connected App이 삭제되거나 승인된 사용자의 권한이 변경된 경우), API 호출이 다시 성공하려면 Lovable에서 통합을 다시 연결해야 합니다.
Salesforce 연결에서 프로젝트 연결 해제 방법
Editors 이상은 연결 전체를 삭제하지 않고 특정 프로젝트만 연결에서 제거할 수 있습니다. 연결은 다른 프로젝트에 대해 그대로 사용 가능한 상태로 유지됩니다.
프로젝트 연결을 해제하려면:
Connectors 열기
Connectors를 열고 App connectors로 이동한 뒤 **Salesforce**을 선택합니다.
연결 열기
관리할 연결을 엽니다.
프로젝트 선택
Linked projects 아래에서 연결을 해제할 프로젝트를 체크합니다.
확인
Unlink projects를 클릭하고 확인합니다.
연결이 해제되면 해당 프로젝트들은 이 연결을 통한 Salesforce 접근을 더 이상 가지지 않습니다. 프로젝트가 다시 Salesforce을 필요로 한다면 사용 가능한 연결에 다시 연결할 수 있습니다.
Salesforce 연결 삭제 방법
워크스페이스 admins와 owners는 Salesforce 연결을 삭제할 수 있습니다. 다른 멤버는 본인이 만든 연결이거나 명시적으로 접근 권한을 부여받은 연결인 경우 삭제할 수 있습니다.
연결 삭제는 영구적이며 되돌릴 수 없습니다. 모든 연결된 프로젝트에서 자격 증명이 제거되고, 이 연결을 사용하는 앱은 새 연결이 추가될 때까지 작동을 멈춥니다.
삭제하기 전에 Linked projects 섹션을 검토하여 현재 어떤 프로젝트가 이 연결을 사용 중인지 확인하세요.
연결을 삭제하려면:
Connectors 열기
Connectors를 열고 App connectors로 이동한 뒤 **Salesforce**을 선택합니다.
연결 열기
제거할 연결을 엽니다.
연결된 프로젝트 검토
Linked projects 섹션을 검토합니다.
삭제
Delete this connection 아래의 Delete를 클릭하고 확인합니다.