HubSpot과 Salesforce 연결
마지막 업데이트 날짜: 2026년 5월 12일
HubSpot-Salesforce 연동 기능을 사용하여 HubSpot과 Salesforce 간의 데이터를 동기화하세요. 앱을 연결하면 두 시스템 간에 연락처, 기업, 거래, 티켓 및 활동을 동기화하여 팀 전체에서 데이터의 일관성을 유지할 수 있습니다.
예를 들어, HubSpot에서 연락처를 생성하면 Salesforce의 해당 리드 또는 연락처와 동기화됩니다. 두 시스템 중 한 곳에서 변경 사항이 발생하면 동기화 설정에 따라 다른 시스템에도 반영됩니다.
새로운 Salesforce 프로덕션 조직으로 이전하는 경우, 새로운 프로덕션 조직을 연결하는 방법을 알아보세요.
- HubSpot-Salesforce 통합은 Salesforce Platform API 레거시 버전의 단종에 영향을 받지 않습니다.
- HubSpot의 레거시 Visualforce 모듈이 포함된 Salesforce 내 HubSpot 레거시 관리형 패키지는 더 이상 지원되지 않습니다. 여전히 레거시 Visualforce 모듈을 사용 중이라면, Salesforce에서 해당 패키지를 제거하고 앞으로는 HubSpot Embed를 사용하는 것이 좋습니다.
시작하기 전에
이 기능을 사용하기 전에, 사전에 수행해야 할 단계와 기능의 제한 사항, 그리고 사용 시 발생할 수 있는 결과를 완전히 이해해야 합니다.
요구 사항 이해
HubSpot 계정에서'계정 액세스' 권한이 있어야 하며, 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 인스턴스만 연결할 수 있습니다.
참고: 하나의 Salesforce 환경에 여러 HubSpot 계정을 통합하는 경우, 'HubSpot에서 연락처 생성' 설정에서 'HubSpot 연락처를 자동으로 생성하지 않음'을 선택하는 것이 좋습니다. 다른 옵션 중 하나를 선택하면, 한 HubSpot 계정에서 생성된 Salesforce 리드 또는 연락처가 다른 HubSpot 계정에 연락처를 생성할 수 있습니다.
- Salesforce 통합을 설치하고 설정한 후에도 레코드가 자동으로 동기화되지는 않습니다. Salesforce 레코드를HubSpot으로 가져오거나,자동 동기화 트리거에 따라 점진적으로 동기화되도록 할 수 있습니다.
Salesforce 앱 설치
- HubSpot 계정에서 상단 탐색 모음의 마켓플레이스 아이콘
를 클릭한 다음 HubSpot 마켓플레이스를 선택합니다. - 검색 창을 사용하여 Salesforce를 찾아 선택하십시오.
- 설치를 클릭합니다.
- HubSpot을 Salesforce 샌드박스에 연결하는 경우 '예, 샌드박스에 연결합니다 ' 확인란을 선택합니다.
- 'Salesforce에 로그인'을 클릭합니다.

- 팝업 창에서 Salesforce 자격 증명을 입력하고 로그인을 클릭합니다. 로그인 후 HubSpot의 설치 프로세스로 다시 이동합니다.
- 'Salesforce에 HubSpot의 강력한 기능을 활용하세요' 화면에서 '이 단계를 건너뛰고 나중에 HubSpot 임베드 창을 설치하기'를 클릭합니다. Salesforce 페이지 레이아웃에 HubSpot 임베드 창을 추가하는 방법에 대해 자세히 알아보세요.
- '데이터 동기화 설정 선택' 화면 에서 HubSpot과 Salesforce 간의 데이터 동기화 방식을 선택합니다.
-
- 어떤 설정을 선택하든 HubSpot은 HubSpot 속성과 Salesforce 필드 간의 매핑을 생성합니다.
- Salesforce 필드에 일치하는 HubSpot 속성이 없는 경우, HubSpot에서 'Unknown user'에 의해 새로운 속성이 생성됩니다.
- '권장 설정'을 선택한 경우 '설정 검토'를 클릭합니다.

- '고급 설정'을 선택한 경우 '다음'을 클릭합니다.
-
- 다음 화면에서 연락처 동기화 설정을 구성합니다.
- '동기화할 연락처 선택' 드롭다운 메뉴를 클릭하고 '모든 연락처'를 선택하여 모든 연락처를 Salesforce로 동기화하거나, 포함 세그먼트로 사용할 HubSpot 세그먼트를 선택하여 해당 연락처만 Salesforce로 동기화하십시오.
- '다음'을 클릭합니다.
- 다음 화면에서 활동 및 작업 동기화 설정을 구성합니다:
- 'Salesforce 작업 동기화' 스위치를 클릭하여 켜면, Salesforce에서 작업이 생성될 때 HubSpot에 자동으로 작업이 생성됩니다.
- '타임라인 동기화' 테이블에서 Salesforce에 작업으로 동기화할 HubSpot 이벤트 옆의 '동기화' 확인란을 선택하고, 'Salesforce 작업 유형' 드롭다운 메뉴를 클릭하여 Salesforce에서 생성될 작업 유형을 선택합니다.
- '다음'을 클릭합니다.
- 다음 화면에서 개체 및 속성 동기화 설정을 구성합니다.
- '연락처', '회사' 또는 '거래' 탭을 클릭하여 해당 개체의 표준 속성에 대한 동기화 유형을 구성합니다. '회사' 및 '거래' 탭에서는 필드 매핑을 생성하기 전에 '회사/거래 동기화 활성화' 스위치를 클릭하여 켜야 할 수도 있습니다.
- 표에는 표준 HubSpot 개체 속성과 이에 해당하는 Salesforce 필드가 표시됩니다. 각 속성 동기화에 대해 동기화 유형( Salesforce 우선 (기본값), 항상 Salesforce 사용 또는 양방향)을 선택합니다. Salesforce 필드 매핑의 동기화 유형에 대해 자세히 알아보세요.
- '다음'을 클릭합니다.
- 다음 화면에서 연락처 동기화 설정을 구성합니다.
- 마지막으로, 선택한 데이터 동기화 설정을 검토하십시오. 데이터 동기화 유형의 설정을 변경하려면 '변경'을 클릭하십시오.
- 완료되면 '설정 완료 및 동기화 시작'을 클릭하세요. Salesforce 통합 설정 페이지로 이동하며, HubSpot과 Salesforce 간의 데이터 동기화가 시작됩니다.

새로운 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 계정에 액세스할 수 있도록 허용하십시오.
