HubSpot-Salesforce 통합 설치하기
마지막 업데이트 날짜: 2026년 3월 26일
HubSpot-Salesforce 통합을 통해 HubSpot과 Salesforce 간에 데이터를 원활하게 동기화하여 마케팅 및 영업 팀 전체에 일관성을 보장할 수 있습니다.
- HubSpot-Salesforce 통합은 Salesforce 플랫폼 API 레거시 버전의 종료에 영향을 받지 않습니다.
- HubSpot의 레거시 Visualforce 모듈이 포함된 Salesforce의 레거시 관리형 패키지는 더 이상 사용되지 않습니다. 레거시 Visualforce 모듈을 계속 사용 중인 경우, Salesforce에서 해당 패키지를 제거하고 대신 앞으로 HubSpot Embed를 사용하는 것이 좋습니다.
시작하기 전에
통합 설정 및 설치 프로세스의 일부에서 이 지침과 Salesforce를 왔다 갔다 할 것으로 예상됩니다.
Salesforce 계정에 다음과 같은 구독, 액세스 및 권한과 함께 HubSpot 계정에 계정 액세스 권한이 있어야 합니다:
- API 액세스 권한이 있는 Salesforce 에디션 또는 Salesforce Professional이 있어야 합니다. HubSpot-Salesforce 통합은 Salesforce 정부 클라우드도 지원하며 연결할 수 있습니다. 그러나 Salesforce 그룹 에디션은 지원하지 않습니다.
- Salesforce 시스템 관리자여야 합니다.
- 다음 사용자 프로필 관리 권한이 모두 있어야 합니다:
- API 사용.
- 설정 및 구성 보기가 켜져 있어야 합니다.
- HubSpot에 동기화하려는 모든 개체(계정, 캠페인, 연락처, 리드 또는 기회)에서모두 수정을 클릭합니다.
- 메타데이터 수정 권한 (Salesforce 리드 또는 연락처 레코드의 HubSpot 임베드 창에서 데이터를 보려면)이 있어야 합니다. 이 권한은 HubSpot 임베드 창을 사용하고 거래를 HubSpot에 동기화하려는 경우에만 필요합니다.
- 앱교환 패키지 다운로드 권한이 있어야 합니다.
- 애플리케이션 프로필 사용자 지정 권한이 있어야 합니다. 이 권한은 HubSpot 임 베드 창을 설치하고 HubSpot 임베드 창을 자동으로 업데이트하는 데 필요합니다.
- 사용자 프로필에서 작업 유형 필드를 표시로 설정합니다.
참고: Salesforce 선택적 동기화를 설정하는 경우 특정 설정은 아래에 설명된 표준 요구 사항, 설정 및 동작과 다를 수 있습니다.
HubSpot-Salesforce 통합에 대한 일반적인 기대치
- 연동 서비스에서 하루에 사용할 수 있는 API 호출 수에는 제한이 있습니다. 단일 연락처 동기화에는 레코드당 최대 4개의 API 호출이 필요하지만 이 수는 달라질 수 있습니다.
- 여러 HubSpot 계정을 하나의 Salesforce 인스턴스에 연결하려면 각 HubSpot 계정에서 연동을 설정하고 설치해야 합니다. HubSpot 계정당 하나의 Salesforce 인스턴스만 연결할 수 있습니다.
참고: 여러 개의 HubSpot 계정을 하나의 Salesforce 환경과 통합하는 경우, HubSpot에서 연락처 만들기 설정의 경우 자동으로 HubSpot 연락처를 만들지 않음을 선택하는 것이 좋습니다. 다른 옵션 중 하나를 선택하면 한 HubSpot 계정에서 만든 Salesforce 리드 또는 연락처가 다른 HubSpot 계정에 연락처를 만들 수 있습니다.
- Salesforce 연동 서비스를 설치하고 설정한 후에는 레코드가 자동으로 동기화되지 않습니다. Salesforce 레코드를 HubSpot으로 가져오거나 자동 동기화 트리거에 따라 점진적으로 동기화되도록 허용할 수 있습니다.
HubSpot-Salesforce 연동 서비스 설치하기
- HubSpot 계정에서 상단 탐색 모음의 마켓플레이스 아이콘 마켓플레이스를 클릭한 다음 HubSpot 마켓플레이스를 선택합니다.
- 검색창을 사용하여 Salesforce 연동 서비스를 찾아 선택합니다.
- 설치를 클릭합니다.
- HubSpot을 Salesforce 샌드박스에 연결하는 경우 예, 샌드박스에 연결됩니다 확인란을 선택합니다.
- Salesforce에 로그인을 클릭합니다.

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

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

Salesforce 연동 사용자 변경 또는 다른 Salesforce 계정 연결하기
Salesforce 연동 사용자를 변경하거나 다른 Salesforce 계정을 HubSpot에 연결하려면 연동 설정에서 Salesforce 자격 증명을 업데이트해야 합니다.
참고: 연동 사용자를 변경하기 전에 새 연동 사용자에게 이전 연동 사용자와 같거나 더 높은 Salesforce 권한이있는지 확인하세요 .
- HubSpot 계정에서 상단 탐색 모음에 있는 settings 설정 아이콘을 클릭합니다. 왼쪽 사이드바 메뉴에서 통합 > 연결된 앱으로 이동합니다.
- Salesforce를 클릭합니다.
- 오른쪽 상단에서 작업 드롭다운 메뉴를 클릭하고 다른 프로덕션 사용자 연결을 클릭합니다.
- 새 브라우저 탭에서 Salesforce의 로그인 페이지로 리디렉션됩니다. Salesforce 자격 증명을 입력하고 로그인을 클릭합니다.
- 이전에 이 Salesforce 계정을 HubSpot에 연결한 적이 있는 경우, HubSpot의 Salesforce 연동 설정으로 리디렉션됩니다.
- 이 Salesforce 계정을 HubSpot에 연결한 적이 없는 경우 허용을 클릭하여 HubSpot에 Salesforce 계정에 대한 액세스 권한을 부여합니다.
