HubSpot과 Salesforce 연결하기
마지막 업데이트 날짜: 2026년 6월 18일
HubSpot과 Salesforce를 연동하여 마케팅, 영업, 고객 대응 팀 간의 데이터를 동기화하세요. HubSpot-Salesforce 연동을 통해 연락처, 기업, 거래, 활동 및 기타 지원되는 데이터를 두 플랫폼 간에 동기화할 수 있어, 팀원들이 시스템 전반에 걸쳐 일관된 정보를 바탕으로 업무를 수행할 수 있습니다.
HubSpot과 Salesforce를 연결하면 수동 데이터 입력을 줄이고, 고객 기록을 일관되게 유지하며, 리드 인계, 활동 추적, 보고와 같은 프로세스를 지원할 수 있습니다. 예를 들어, 한 플랫폼에서 연락처 정보가 업데이트되면 통합 설정에 따라 해당 변경 사항이 다른 플랫폼으로 동기화됩니다.
새로운 Salesforce 프로덕션 조직으로 이전하는 경우, 새로운 프로덕션 조직을 연결하는 방법을 확인하세요.
- HubSpot-Salesforce 연동은 Salesforce 플랫폼 API 레거시 버전의 단종에 영향을 받지 않습니다.
- HubSpot의 레거시 Visualforce 모듈이 포함된 Salesforce 내 HubSpot 레거시 관리형 패키지는 더 이상 지원되지 않습니다. 여전히 레거시 Visualforce 모듈을 사용 중이라면, Salesforce에서 해당 패키지를 제거하고 앞으로는 HubSpot Embed를 사용하는 것이 좋습니다.
시작하기 전에
이 기능을 사용하기 전에, 사전에 수행해야 할 단계와 기능의 제한 사항, 그리고 사용 시 발생할 수 있는 결과를 충분히 숙지하시기 바랍니다.
요구 사항 확인
권한 필요 HubSpot 계정에서‘계정 액세스(Account Access)’ 권한을 보유하고 있어야 하며, Salesforce 계정에서는 다음 구독, 액세스 및 권한이 필요합니다:
- API 액세스 권한이 있는 Salesforce 에디션 또는 Salesforce Professional을 보유하고 있어야 합니다. HubSpot-Salesforce 통합은Salesforce Government Cloud도 지원하며 연결할 수 있습니다. 단, Salesforce Group Edition은 지원하지 않습니다.
- Salesforce 시스템 관리자여야 합니다.
- 다음의 모든 사용자 프로필 관리 권한을 보유해야 합니다:
- API 사용 가능.
- '설정 및 구성 보기'가 활성화되어 있어야 합니다.
- HubSpot과 동기화하려는 모든 개체(계정, 캠페인, 연락처, 리드 또는 기회)에 대해 '모두 수정' 권한이 있어야 합니다.
- '메타데이터 수정' 권한이있어야 합니다(Salesforce 리드 또는 연락처 레코드의 HubSpot 임베드 창에서 데이터를 보기 위함). 이 권한은 HubSpot 임베드 창을 사용하고 거래를 HubSpot으로 동기화하려는 경우에만 필요합니다.
- 'AppExchange 패키지 다운로드' 권한이 있어야 합니다.
- '애플리케이션 프로필 사용자 지정' 권한이 있어야 합니다. 이 권한은 HubSpot 임베드 창을 설치하고 HubSpot 임베드 창을 자동으로 업데이트하는 데 필요합니다.
- 사용자 프로필에서 ‘작업 유형’ 필드가 ‘표시’로 설정되어 있어야 합니다.
참고: Salesforce 선택적 동기화를 설정하는경우 , 구체적인 설정은 아래에 설명된 표준 요구 사항, 설정 및 동작과 다를 수 있습니다.
제한 사항 및 고려 사항 이해
- 통합 기능에서 하루에 사용할 수 있는 API 호출 횟수에는 제한이 있습니다. 단일 연락처 동기화는 레코드당 최대 4회의 API 호출이 필요할 수 있지만, 이 수치는 달라질 수 있습니다.
- 하나의 Salesforce 인스턴스에 여러 HubSpot 계정을 연결하려면 각 HubSpot 계정에서 통합을 설정하고 설치해야 합니다. HubSpot 계정당하나의 Salesforce 인스턴스만 연결할 수 있습니다.
- 여러 HubSpot 계정을 하나의 Salesforce 환경과 연동하는 경우, 'HubSpot에서 연락처 생성' 설정에서 ‘HubSpot 연락처를 자동으로 생성하지 않음’을 선택하는 것이 좋습니다. 다른 옵션 중 하나를 선택하면, 한 HubSpot 계정에서 생성된 Salesforce 리드나 연락처가 다른 HubSpot 계정에 연락처로 생성될 수 있습니다.
- Salesforce 연동을 설치하고 설정한 후에도 레코드는 자동으로 동기화되지 않습니다. Salesforce 레코드를HubSpot으로 직접 가져오거나,자동 동기화 트리거에 따라 점진적으로 동기화되도록 할 수 있습니다.
-
Salesforce 계정에서 로그인 IP 제한을 사용하는 경우, HubSpot이 Salesforce에 연결되지 않을 수 있습니다. HubSpot은 동적 IP 주소를 사용하므로 HubSpot IP 주소를 허용 목록에 추가할 수 없습니다. Salesforce에서 ‘모든 요청에 대해 IP 제한 적용’ 설정이 선택된 경우, 연동 기능이 연결되지 않습니다. 연동 기능을 정상적으로 작동시키면서 Salesforce 액세스를 제한하려면 Salesforce에서 네트워크 IP 범위를 구성하는 것이 좋습니다.
연결된 사용자 이해하기
연결된 사용자 또는 통합 사용자는 통합을 연결하는 데 사용하는 Salesforce 사용자입니다.
연결된 사용자의 Salesforce 권한에 따라 HubSpot이 동기화를 통해 Salesforce에서 수행할 수 있는 작업이 결정됩니다. HubSpot이 Salesforce에서 레코드를 생성, 업데이트 또는 동기화할 때, 이러한 작업은 연결된 사용자의 권한에 따라 수행됩니다.
예를 들어, 연결된 사용자에게 리드 개체를 볼 수 있는 권한이 없는 경우, 리드는 HubSpot으로 동기화되지 않습니다. 또한 HubSpot은 동기화를 통해 Salesforce에서 리드 레코드를 생성하거나 업데이트할 수 없습니다.
Salesforce 앱 설치
- HubSpot 계정에서 상단 탐색 모음의 마켓플레이스 아이콘
를 클릭한 다음 HubSpot 마켓플레이스를 선택합니다. - 검색 창에서 Salesforce 앱을 검색하여 선택합니다.
- '설치'를 클릭합니다.
- HubSpot을 Salesforce 샌드박스에 연결하는 경우, ‘예, 샌드박스에 연결합니다 ’ 확인란을 선택합니다.
- '설치'를 클릭합니다.
- 팝업 창에서 Salesforce 자격 증명을 입력하고 '로그인'을 클릭하세요. 로그인 후 HubSpot으로 다시 이동하게 됩니다.
새로운 Salesforce 프로덕션 조직을 HubSpot에 연결하기
HubSpot 통합 패키지가 설치된 기존 Salesforce 프로덕션 조직에서 새로운 Salesforce 프로덕션 조직으로 마이그레이션하는 경우, 새로운 Salesforce 프로덕션 조직을 HubSpot에 연결해야 합니다.
- 이 과정은 프로덕션 조직에서 샌드박스로, 또는 그 반대로 마이그레이션하는 경우에는 적용되지 않습니다. Salesforce 샌드박스를 HubSpot에 연결하는 방법을 알아보세요.
- 새로운 Salesforce 프로덕션 조직을 HubSpot과 통합하려면 약 1시간 동안 HubSpot-Salesforce 연동을 비활성화해야 합니다.
- 현재, 새로운 Salesforce 프로덕션 조직을 HubSpot에 통합할 때 기존 HubSpot 연락처와 Salesforce 리드 또는 연락처 간의 동기화 및 관계만 유지될 수 있습니다. 기존 HubSpot 기업과 Salesforce 계정 간의 동기화 및 관계, 그리고 HubSpot 거래와 Salesforce 기회 간의 동기화 및 관계는 손실됩니다.
- HubSpot 계정에서 상단 탐색 모음에 있는
설정 아이콘을 클릭합니다. 왼쪽 사이드바 메뉴에서 통합 > 연결된 앱으로 이동합니다. - 'Salesforce'를 클릭합니다.
- 오른쪽 상단에서 스위치를 클릭하여 비활성화하십시오.
- 새로운 Salesforce 프로덕션 조직에 통합 패키지를 설치하십시오.
- 새로운 Salesforce 프로덕션 조직과 계속 동기화할HubSpot 연락처를 내보내세요.
- 내보낸 HubSpot 연락처를새로운 Salesforce 프로덕션 조직으로가져옵니다.
- 이전 Salesforce 프로덕션 조직과 HubSpot 간에 매핑되었던사용자 정의 필드 매핑을 생성하거나 편집하십시오.
참고:HubSpot 속성이 새프로덕션 조직에도 존재하는 Salesforce 필드에 매핑된 경우, 기존 사용자 정의 필드 매핑을 유지할 수 있습니다. 또한 새 프로덕션 조직의 Salesforce 필드 내부 이름이 기존 프로덕션 조직의 Salesforce 필드 내부 이름과 일치해야 합니다. 일치하지 않는 경우, 동기화 오류를 방지하기 위해 새 필드 매핑을 생성하고 기존 필드 매핑을 삭제하십시오.
- 1시간이 지난 후, 새로운 Salesforce 프로덕션 조직을 HubSpot에 연결하십시오.
- 오른쪽 상단에서스위치를클릭하여 통합 기능을 켜십시오.
- Salesforce 리드/연락처를 HubSpot으로 다시 가져오세요. 가져오기 과정에서 기존 HubSpot 연락처와 중복되는 Salesforce 리드 및 연락처가 제거됩니다. 또한 기존 HubSpot 연락처의 Salesforce 레코드 ID가갱신되어 새로운 프로덕션 조직의 Salesforce 리드 및 연락처와 연결됩니다.
Salesforce 연결 사용자 변경
Salesforce 연결 사용자를 변경하려면 통합 설정에서 Salesforce 자격 증명을 업데이트해야 합니다.
참고:통합 사용자를 변경하기 전에, 새 통합 사용자가이전 통합 사용자와 동일하거나 더 높은 수준의 Salesforce 권한을가지고 있는지 확인하십시오.
- HubSpot 계정에서 상단 탐색 모음에 있는
설정 아이콘을 클릭합니다. 왼쪽 사이드바 메뉴에서 통합 > 연결된 앱으로 이동합니다. - 'Salesforce'를 클릭하십시오.
- 오른쪽 상단의 ‘작업’ 드롭다운 메뉴를 클릭한 다음 ‘다른 프로덕션 사용자 연결’을 클릭하십시오.
- 새 브라우저 탭에서 Salesforce 로그인 페이지로 이동합니다. Salesforce 자격 증명을 입력하고'로그인'을 클릭합니다.
- 이 Salesforce 계정을 이전에 HubSpot에 연결한 적이 있다면, HubSpot의 Salesforce 통합 설정 페이지로 이동하게 됩니다.
- 이 Salesforce 계정을 HubSpot에 연결한 적이 없다면,‘허용’을 클릭하여 HubSpot이 Salesforce 계정에 액세스할 수 있도록 허용하십시오.