세일즈포스에서 허브스팟으로 — 이관 범위와 순서

설치만으로는 아무것도 넘어오지 않습니다

CRM 교체 검토에서 가장 큰 위험은 데이터입니다. 기능은 비교하면 되지만, 수년간 쌓인 데이터가 제대로 넘어오지 않으면 교체 자체가 실패합니다.

그래서 '이관 가능한가'라는 질문이 먼저 나옵니다. 답은 가능하다는 것이지만, 이 답만으로는 계획을 세울 수 없습니다. 어떤 객체가 어느 방향으로 동기화되고, 무엇이 넘어오지 않고, 어떤 조건에서 관계가 끊기는지가 실제 작업량을 결정합니다.

공식 문서를 확인해 보면 조건이 꽤 많습니다. 설치 후 자동 초기 동기화가 없다는 점부터, 포함 세그먼트 외 연락처의 이후 변경이 동기화되지 않는다는 점, 그리고 세일즈포스 운영 조직 이전 시 일부 관계가 소실된다는 점까지.

이 글은 그 조건들을 정리하고 그 위에서 이관 순서를 제시합니다. 건수 예시는 가상 시나리오이며, 이 글은 허브스팟의 세일즈포스 연동 문서를 기준으로 합니다.

연동 요구 사양을 먼저 확인하십시오

연동을 쓸 수 있는 구독이 정해져 있습니다. 공식 문서 기준으로 Marketing Hub, Sales Hub, Service Hub, Data Hub, Content Hub, Smart CRM의 Professional 또는 Enterprise에서 제공됩니다. 그리고 허브스팟 내 계정 접근 권한이 필요합니다.

즉 Starter 등급으로는 이 연동을 쓸 수 없습니다. 세일즈포스에서 옮기는 것을 전제한다면 Professional 이상이 전제입니다. 앞선 글에서 다룬 필수 온보딩 요금도 함께 발생합니다.

세일즈포스 측 요건도 있습니다. API 접근이 가능한 에디션 또는 Salesforce Professional이 필요하고, Salesforce Government Cloud는 지원되지만 Salesforce Group Edition은 지원되지 않습니다. 작업자는 세일즈포스 시스템 관리자여야 하며 API Enabled와 Modify All 권한이 필요합니다.

> 환경 제약 두 가지

허브스팟 계정 하나에 세일즈포스 인스턴스 하나만 연결할 수 있습니다. 두 개의 세일즈포스 조직을 하나의 허브스팟에 붙이는 구성은 성립하지 않습니다.

그리고 세일즈포스에서 'Enforce IP Restrictions on Every Request'가 활성화되어 있으면 연결이 실패합니다. 허브스팟의 IP가 동적이어서 허용 목록에 넣을 수 없습니다. 보안 정책으로 이 설정을 쓰는 조직이라면 연동 전에 이 지점을 해결해야 합니다.

이 네 가지를 먼저 확인하십시오. 확인하지 않고 일정을 세우면 첫날에 막힙니다.

무엇이 어느 방향으로 동기화되는가

공식 문서가 객체별 동기화를 명시합니다. 문구 그대로 정리하겠습니다.

세일즈포스 리드와 연락처는 허브스팟과 양방향으로 동기화됩니다. 허브스팟 회사는 세일즈포스 계정과 동기화됩니다. 허브스팟 딜은 세일즈포스 기회와 동기화됩니다. 허브스팟 티켓은 세일즈포스 케이스와 동기화됩니다.

허브스팟 활동(폼 제출, 이메일 상호작용, 미팅 등)은 세일즈포스 작업으로 동기화할 수 있습니다. 그리고 커스텀 오브젝트도 양쪽 간 동기화할 수 있습니다.

> 커스텀 오브젝트는 Enterprise 전용입니다

커스텀 오브젝트 동기화는 Marketing·Sales·Service·Data·Content Hub 또는 Smart CRM의 Enterprise 등급에서만 제공됩니다. Professional로는 쓸 수 없습니다.

커스텀 오브젝트의 필드 매핑 방향은 세 가지 중에서 고릅니다. 양방향, 항상 세일즈포스 우선, 항상 허브스팟 우선. 연관 관계의 방향도 양방향, 세일즈포스에서 허브스팟으로만, 허브스팟에서 세일즈포스로만 중에서 선택합니다.

방향 선택이 중요합니다. 양방향으로 두면 양쪽에서 수정이 가능해지고, 그러면 어느 쪽 수정이 이겼는지 추적이 어려워집니다. 이관 기간에는 한쪽을 우선으로 고정해 두는 편이 안전합니다.

동기화되지 않는 것과 조건

공식 문서에 명시된 제약을 정리하겠습니다. 이 목록이 이관 계획의 핵심입니다.

첫째, 삭제가 전파되지 않습니다. 허브스팟 연락처를 삭제해도 세일즈포스의 연락처와 리드는 삭제되지 않습니다. 양쪽에 정리 작업이 따로 필요합니다.

둘째, 포함 세그먼트 조건이 있습니다. 허브스팟에서 세일즈포스로는 포함 세그먼트에 속한 연락처만 동기화됩니다. 그리고 세그먼트 외 연락처의 경우 이후 양쪽의 변경이 서로 동기화되지 않습니다. 즉 한 번 제외되면 그 레코드는 양쪽에서 따로 흘러갑니다.

셋째, 라이프사이클 단계 처리입니다. 허브스팟 연락처의 라이프사이클 단계는 세일즈포스의 해당 레코드에 영향을 주지 않습니다.

넷째, 트리거되지 않는 변경이 있습니다. 세일즈포스 수식(formula) 필드의 업데이트는 동기화를 트리거하지 않습니다. 다만 수식 안에 매핑된 소스 필드가 바뀌면 트리거됩니다. 그리고 세일즈포스 캠페인에서 리드나 연락처를 제거하는 것도 동기화를 트리거하지 않습니다.

> 커스텀 오브젝트의 추가 제약

세일즈포스 커스텀 오브젝트의 lookup 필드를 포함하는 필드 매핑은 만들 수 없습니다. 그리고 하나의 커스텀 오브젝트를 세일즈포스 연락처와 리드 양쪽에 동기화하는 것은 불가능합니다. 세일즈포스 표준 오브젝트 전체가 지원되는 것도 아니며, 공식 문서가 지원 목록을 별도로 열거합니다.

이 제약들이 의미하는 바는 분명합니다. 커스텀 오브젝트를 많이 쓰는 세일즈포스 조직에서는 이관 범위를 사전에 항목별로 검증해야 합니다.

임포트 — 실제 이관 경로

동기화와 임포트는 다릅니다. 동기화는 연결을 유지하며 양쪽을 맞추는 것이고, 임포트는 세일즈포스의 기존 레코드를 허브스팟으로 가져오는 작업입니다.

공식 문서 기준으로 임포트할 수 있는 것은 리드, 연락처, 계정, 기회, 작업, 캠페인 하나, 케이스, 이벤트입니다. 커스텀 오브젝트도 선택할 수 있습니다.

임포트에도 등급 요건이 있습니다. Marketing·Sales·Service·Data·Content Hub 또는 Smart CRM의 Professional 또는 Enterprise가 필요하고, 세그먼트를 세일즈포스로 수동 동기화하려면 Marketing Hub Professional 이상이 필요합니다.

캠페인에는 조건이 하나 더 있습니다. 임포트하려면 해당 캠페인이 세일즈포스에서 활성(Active) 상태여야 합니다.

> 초기 임포트의 중요한 제약

리드와 연락처의 초기 임포트 시 이메일 주소만 이관됩니다. 그리고 포함 세그먼트 외 연락처는 '초기 임포트 후 다른 모든 연락처 속성이 비어 있는 상태로 남는다'고 공식 문서가 적고 있습니다.

이 제약이 이관 계획을 크게 바꿉니다. 속성을 함께 가져오려면 포함 세그먼트 설계를 먼저 해야 합니다. 세그먼트를 좁게 잡으면 그 밖의 연락처는 이메일만 있는 껍데기로 들어옵니다.

그리고 대량 임포트는 시간이 걸립니다. 공식 문서가 '세일즈포스 API 호출 사용을 최적화하기 위해 대량 임포트는 몇 시간이 걸릴 수 있다'고 적고 있습니다.

API 호출을 계산하십시오

이관에서 간과되는 비용이 세일즈포스 API 호출입니다. 세일즈포스는 일일 API 호출 한도가 있고, 이관이 그 한도를 소모합니다.

공식 문서 기준으로 연락처 한 건을 동기화하는 데 세일즈포스 API 호출이 최대 4회 소요됩니다. 연락처 20,000건이면 최대 80,000회입니다.

허브스팟 쪽 설정에서 배분을 조절할 수 있습니다. 공식 문서가 '허브스팟의 API 호출 한도는 세일즈포스 API 호출 한도를 기준으로 설정해야 한다'고 안내하고, 허브스팟에 배분할 호출 수를 입력하는 항목과 세일즈포스 한도를 반영하는 표시, 최근 24시간 사용량 조회 기능을 제공합니다.

> 그래서 순서를 나누십시오

하루에 전부 이관하려 하면 세일즈포스 API 한도를 소모해 다른 연동이나 업무가 영향을 받습니다. 영업 업무에 쓰는 다른 연동이 멈추면 이관이 아니라 장애가 됩니다.

권하는 방법은 둘입니다. 첫째, 객체별로 날짜를 나눕니다. 하루에 한 객체씩 임포트하고 다음 날 사용량을 확인합니다. 둘째, 업무가 적은 시간대나 주말에 대량 임포트를 돌립니다.

그리고 이관 전에 세일즈포스의 현재 일일 API 사용량을 확인하십시오. 평상시 사용량이 한도의 70%를 넘고 있다면 이관에 쓸 여유가 적으므로 기간을 더 나눠야 합니다.

허브스팟 쪽 API 한도도 확인하십시오

세일즈포스 호출만 보면 안 됩니다. 허브스팟 쪽에도 일일 호출 한도가 있고, 이관 이후 다른 연동을 붙일 때 영향을 줍니다.

공식 개발자 문서 기준으로 프라이빗 앱의 일일 호출 한도가 등급별로 나뉩니다. Free와 Starter는 계정당 250,000회, 그다음 구간이 625,000회, 그다음이 1,000,000회입니다. 10초당 한도는 각각 100회, 190회, 190회입니다.

다만 이 표에서 주의할 점이 있습니다. 문서의 HTML에서 행 레이블이 평탄화되어 Professional과 Enterprise의 행 레이블을 직접 확인하지 못했습니다. 값의 순서로 보아 Professional이 625,000회, Enterprise가 1,000,000회로 추정되지만 레이블 확인은 하지 못했습니다. 추정임을 밝혀 둡니다.

API Limit Increase 애드온이 있습니다. 적용하면 프라이빗 앱당 10초 250회, 계정당 일 1,000,000회가 기존 구독에 더해집니다. 그리고 최대 두 개까지 구매할 수 있습니다.

> 공개 앱과 검색 API

공개 OAuth 앱은 설치 계정당 10초에 110 요청이며 Search API는 제외됩니다. Search API 엔드포인트는 인증 토큰당 초당 5 요청입니다.

이관 자체보다 이관 이후가 문제인 경우가 많습니다. 세일즈포스와 양방향 동기화를 유지하면서 다른 시스템 연동까지 붙이면 호출이 누적됩니다. 그래서 이관 계획을 세울 때 '이관 후 상시 운영에서 하루 몇 회를 쓸 것인가'를 함께 추산하십시오.

운영 조직 이전 시 관계가 소실됩니다

이 항목은 사전에 알지 못하면 복구가 어렵습니다.

공식 문서가 명시합니다. 세일즈포스 운영(production) 조직을 이전하는 경우 연동이 약 1시간 중단되어야 하고, 회사와 계정의 관계, 그리고 딜과 기회의 관계가 소실됩니다. 연락처 관계는 유지됩니다.

즉 세일즈포스 조직을 옮기는 작업과 허브스팟 이관을 같은 기간에 하면 관계 데이터를 다시 만들어야 합니다. 거래처 수천 건과 딜 수천 건의 연결을 수동으로 복구하는 작업은 현실적으로 어렵습니다.

> 그래서 순서를 분리하십시오

세일즈포스 조직 이전이 예정되어 있다면 그 작업을 먼저 끝내고 안정화한 뒤 허브스팟 이관을 시작하십시오. 또는 반대로 허브스팟 이관을 완료하고 운영을 전환한 뒤 세일즈포스 조직을 정리하십시오. 두 작업을 겹치지 마십시오.

그리고 레거시 패키지 문제도 있습니다. 공식 문서가 레거시 Visualforce 패키지의 사용 중단이 진행 중이며 허브스팟 Embed 사용을 권고한다고 적고 있습니다. 세일즈포스 화면에 허브스팟 정보를 표시하는 구성을 쓰고 있다면 이관 전에 전환 계획을 확인하십시오.

이관 순서와 검증

앞의 제약을 반영한 순서입니다. 각 단계마다 소량 시험을 먼저 하십시오.

1단계는 요건 확인입니다. 허브스팟 구독 등급(Professional 이상), 세일즈포스 에디션과 권한(API Enabled·Modify All), IP 제한 설정 해제, 그리고 세일즈포스 현재 일일 API 사용량.

2단계는 포함 세그먼트 설계입니다. 어느 연락처를 동기화 대상으로 둘지 정합니다. 세그먼트 외 연락처는 초기 임포트 후 속성이 비어 있는 상태로 남으므로, 속성이 필요한 연락처는 반드시 세그먼트에 포함시켜야 합니다.

3단계는 소량 시험 임포트입니다. 연락처 20~50건을 임포트해 필드 매핑과 속성 이관 상태를 확인합니다. 이 단계에서 문제를 발견하면 수정 비용이 작습니다.

4단계는 객체별 본 임포트입니다. 계정 → 연락처·리드 → 기회 → 케이스·작업·이벤트 순서로, 하루에 한 객체씩 진행하며 API 사용량을 확인합니다.

> 5단계와 검증 항목

5단계는 커스텀 오브젝트입니다. Enterprise 등급이어야 하고, lookup 필드 매핑 불가와 연락처·리드 동시 동기화 불가 제약을 적용해 범위를 먼저 확정합니다.

각 단계 후 확인할 것은 셋입니다. 건수가 세일즈포스 측 건수와 일치하는가. 회사에 연결되지 않은 연락처가 0건인가. 속성이 비어 있는 레코드 비율이 예상 범위인가. 세 번째가 포함 세그먼트 설계의 결과를 검증합니다.

요약 — 다섯 가지

설치만으로는 아무것도 넘어오지 않습니다. 자동 초기 동기화가 없으므로 임포트나 동기화 트리거를 직접 실행해야 합니다.

연동은 Professional 또는 Enterprise 구독이 필요하고 커스텀 오브젝트 동기화는 Enterprise 전용입니다. 세일즈포스 측은 API 접근 가능 에디션과 시스템 관리자 권한이 필요하며 Group Edition은 지원되지 않습니다. IP 제한 설정이 켜져 있으면 연결이 실패합니다.

양방향은 리드·연락처입니다. 회사-계정, 딜-기회, 티켓-케이스가 동기화되고 활동은 작업으로 보낼 수 있습니다. 삭제는 전파되지 않고, 포함 세그먼트 외 연락처는 이후 변경도 동기화되지 않습니다.

초기 임포트에서 리드·연락처는 이메일 주소만 이관되며, 세그먼트 외 연락처는 다른 속성이 비어 있는 상태로 남습니다. 그래서 포함 세그먼트 설계가 이관 품질을 결정합니다.

API 호출을 계산하십시오. 연락처 한 건에 세일즈포스 API 최대 4회입니다. 그리고 세일즈포스 운영 조직 이전과 허브스팟 이관을 겹치지 마십시오. 회사-계정과 딜-기회 관계가 소실됩니다.

동기화되는 것과 되지 않는 것

전제와 기준: HubSpot 공식 도움말(Install the HubSpot-Salesforce integration, Manage your Salesforce integration settings, Import Salesforce records, Set up and use Salesforce custom object sync) 2026년 10월 8일 확인. 세일즈포스 표준 오브젝트 전체가 지원되는 것은 아니며 공식 문서가 지원 목록을 별도로 열거합니다. 허브스팟 계정 하나에 세일즈포스 인스턴스 하나만 연결할 수 있습니다.

API 호출 한도 — 양쪽을 함께 보십시오

전제와 기준: HubSpot 공식 개발자 문서(API usage details) 및 세일즈포스 연동 문서 2026년 10월 8일 확인. 허브스팟 프라이빗 앱 한도 표는 문서 HTML에서 행 레이블이 평탄화되어 Professional·Enterprise의 레이블을 직접 확인하지 못했습니다. 값의 순서로 추정했으며 추정임을 밝혀 둡니다. 허브스팟 설정에서 세일즈포스 API 호출 중 허브스팟에 배분할 수를 입력할 수 있고 최근 24시간 사용량을 조회할 수 있습니다. 이관 전에 세일즈포스의 평상시 일일 사용량을 확인하십시오.

독자가 자주 묻는 질문

Q. 연동을 설치하면 데이터가 자동으로 넘어오는가

아닙니다. 공식 문서가 설치 후 자동 초기 동기화가 없으며 임포트 또는 동기화 트리거가 필요하다고 적고 있습니다. 그래서 이관은 '설치'와 '임포트'라는 두 작업으로 나뉩니다. 임포트할 수 있는 것은 리드, 연락처, 계정, 기회, 작업, 캠페인 하나, 케이스, 이벤트이며 커스텀 오브젝트도 선택할 수 있습니다.

Q. 속성이 비어 있는 연락처가 생기는 이유는 무엇인가

포함 세그먼트 설계 때문입니다. 공식 문서 기준으로 리드·연락처의 초기 임포트 시 이메일 주소만 이관되며, 포함 세그먼트 외 연락처는 초기 임포트 후 다른 모든 속성이 비어 있는 상태로 남습니다. 그러므로 속성이 필요한 연락처는 반드시 포함 세그먼트에 넣어야 합니다. 세그먼트 설계가 이관 품질을 결정합니다.

Q. 세일즈포스를 완전히 끊어도 되는가

이 글은 연동을 통한 이관을 다루므로 세일즈포스 해지 시점의 처리는 별도 판단이 필요합니다. 다만 두 가지를 기억하십시오. 삭제가 전파되지 않으므로 양쪽 정리가 따로 필요하고, 포함 세그먼트 외 연락처는 양쪽에서 따로 흘러갑니다. 해지 전에 허브스팟 쪽 데이터가 완전한지 건수와 속성 채움률로 검증하십시오.

Q. 세일즈포스 조직 이전과 함께 진행하면 안 되는가

겹치지 마십시오. 공식 문서가 세일즈포스 운영 조직을 이전하면 연동이 약 1시간 중단되어야 하고 회사-계정 관계와 딜-기회 관계가 소실된다고 명시합니다. 연락처 관계는 유지됩니다. 거래처와 딜 수천 건의 연결을 수동 복구하는 것은 현실적으로 어렵습니다. 한 작업을 끝내고 안정화한 뒤 다른 작업을 시작하십시오.

이 글이 다루지 않는 것

이 글은 허브스팟의 세일즈포스 연동 문서를 기준으로 동기화 범위와 이관 순서를 다룹니다. 세일즈포스 해지 절차와 데이터 반출 요건, 제3자 이관 도구의 사용, 그리고 세일즈포스 측 에디션별 API 일일 한도는 다루지 않습니다. 허브스팟 프라이빗 앱 한도 표의 Professional·Enterprise 행 레이블은 직접 확인하지 못해 추정으로 표기했습니다. 또한 일부 연동 도움말 페이지는 접근 제약으로 확인하지 못했습니다.

출처와 확인일

가격·에디션·정책은 공급사가 예고 없이 변경할 수 있습니다. 계약 전 위 공식 페이지에서 직접 재확인하십시오. 원화 환산은 1 USD = 1,380원, 기준일 2026년 10월 5일을 적용했습니다.

함께 읽으면 좋은 솔바인드9 글