콘텐츠로 건너뛰기
주의:: 이 문서는 사용자의 편의를 위해 제공됩니다. 이 문서는 번역 소프트웨어를 사용하여 자동으로 번역되었으며 교정을 거치지 않았을 수 있습니다. 이 문서의 영어 버전이 가장 최신의 정보를 확인할 수 있는 공식 버전으로 간주해야 합니다. 여기에서 액세스할 수 있습니다..

HubSpot 데이터 동기화 연결 및 사용

마지막 업데이트 날짜: 2026년 1월 21일

명시된 경우를 제외하고 다음 구독 중 어느 것에서나 사용할 수 있습니다.

HubSpot 데이터 동기화를 사용하면 HubSpot과 다른 앱 간에 단방향 또는 양방향 동기화를 설정하여 모든 고객 데이터를 하나의 플랫폼에 통합할 수 있습니다. 데이터 동기화를 사용하는 앱을 확인하세요.

데이터 동기화 작동 방식과 앱 연결 방법, 데이터 동기화 활성화, 레코드 재동기화 등을 알아보세요.

데이터 동기화 작동 방식

동기화가 활성화되면 데이터 동기화는 개체 내 모든 레코드의 내부 인덱스를 생성합니다. 이후 해당 인덱스를 활용하여 레코드 변경 사항을 비교 및 모니터링하며, 레코드 속성이 업데이트될 때 상태(동기화 중, 실패, 제외됨)가 어떻게 변경되어야 하는지 확인합니다. 이는 내부 데이터 동기화 인덱스가 지속적으로 자체 데이터베이스(HubSpot 또는 연결된 앱)를 비교하고, 중단되거나 오류가 발생한 API 호출 또는 엔드포인트를 복구할 수 있음을 의미합니다.

레코드가 업데이트되면 동기화 엔진은 보유한 복사본과 전체 레코드를 비교하여 실제 레코드와 일치하도록 복사본을 업데이트합니다. 이를 통해 누락되거나 실패한 업데이트를 복구할 수 있습니다. 데이터 동기화는 시작 시 모든 레코드를 색인화하는 데 시간이 다소 소요될 수 있지만, 보다 원활하고 안정적인 동기화 환경을 보장합니다. 

동기화 원칙

데이터 동기화는 항상 두 앱(한쪽은 HubSpot) 간에 이루어집니다. 모든 동기화는 동기화 대상 객체와 무관하게 두 가지 주요 단계로 진행됩니다:

  • 초기 동기화: 동기화가 활성화되거나 저장될 때시작됩니다 . 양쪽 앱의 모든 기존 레코드가 동기화 엔진을 통과하여 색인화되고, 해당되는 경우 동기화됩니다.
  • 증분 동기화: 모든 레코드가 색인되면 업데이트 및 새 레코드를 스캔합니다. 마지막 확인 이후 변경된 색인 레코드는 동기화 엔진을 통과합니다.

초기

동기화

양방향 동기화의 경우 초기 동기화는 다음과 같이 구성됩니다:

  • HubSpot 색인화: HubSpot 레코드를 스캔하여 레코드 ID와 일치하는 식별자(기본값: 연락처의 이메일, 회사의 이름 또는 도메인)를 저장합니다. 이 색인은 향후 전체 동기화 과정 동안 최신 상태로 유지됩니다. 일치 방식에 대해 자세히 알아보세요
  • 다른 앱 인덱싱 및 동기화: 다른 앱의 레코드를 스캔하여 동기화합니다. 가져온 각 리소스에 대해 HubSpot 인덱스 테이블에 일치하는 식별자(예: 연락처의 이메일 주소)가 있는지 확인합니다. 일치하는 경우 레코드를 매칭하여 두 레코드를 함께 동기화 엔진을 통과시킵니다. 일치하지 않으면 해당 레코드는 단독으로 동기화 엔진을 통과합니다. 동기화 엔진이 레코드를 일치시킬 경우, 보유한 모든 정보(레코드의 필드 값, 필터, 필드 매핑, 동기화 기록 등)를 종합하여 다음 동작(리소스에 대한 변경 요청, 아무 작업 안 함, 오류 기록 등)을 결정합니다.

참고: 앱 API에서 반환된 첫 번째 레코드는 동기화 가능하며, 다음 레코드는 중복으로 간주됩니다.

  • HubSpot 동기화: HubSpot 레코드를 다시 스캔하여 동기화가 필요한지 확인합니다. 이 단계는 다른 앱이 아닌 HubSpot 내 기존 레코드의 동기화를 수행합니다.

참고:

  • 대규모 데이터베이스의 초기 동기화는 시간이 소요될 수 있습니다. 연결된 앱의 API 속도에 따라 앱마다 다를 수 있습니다. 수백만 개의 레코드가 있는 동기화는 완료까지 며칠이 걸릴 수 있습니다.
  • 동기화를 저장하면 초기 동기화가 다시 시작됩니다.
  • 초기 동기화가 완료되면 HubSpot에서 이메일 알림을 발송합니다.

증분 동기화

증분 동기화는 HubSpot과 다른 앱(동기화 방향에 따라)의 업데이트를 지속적으로 스캔하며 트리거될 때까지 대기합니다. HubSpot은 5분마다 변경 사항이 있는지 확인합니다. 다른 앱 또는 해당 API는 웹훅을 사용하여 변경 사항을 알립니다.

앱 연결

권한 필요 HubSpot 계정에서 슈퍼 관리자 권한이 있거나앱 마켓플레이스 권한이 있어야 합니다. HubSpot 계정에 연결하려는 특정 앱에 따라 추가 권한이 필요할 수 있습니다.

 

앱을 검색하고 연결하는 방법에는 두 가지가 있습니다. 앱 마켓플레이스를 통해 또는 가져오기 페이지를 통해 연결할 수 있습니다. 

  1. HubSpot 계정에서 상단 탐색 모음의 마켓플레이스 아이콘 마켓플레이스를 클릭한 다음 HubSpot 마켓플레이스를 선택합니다.
  2. 검색 창에앱 이름을 입력한 후검색 결과를 클릭하세요. 
  3. 설치를 클릭하세요.
  4. 대화 상자에서 다음을 클릭한 후 앱 계정에 로그인하세요.
  5. 요청된 접근 권한을 검토한 후 허용을 클릭하세요. HubSpot 설정의 앱 페이지로 다시 이동합니다.

가져오기 페이지에서 동기화를 설정하는 경우:

  1. 개체 홈페이지 오른쪽 상단의 가져오기를 클릭하거나 가져오기 설정에 접근하세요:
    • HubSpot 계정의 상단 탐색 모음에서 settings 설정 아이콘을 클릭합니다.
    • 왼쪽 사이드바 메뉴에서'가져오기 및 내보내기'로 이동합니다.
    • 가져오기로 이동을 클릭하세요.
  1. 앱 연결을 클릭하세요. 

Data integration options, highlighting the "sync an app" button to sync data between HubSpot and other apps.

  1. 대화 상자에서 앱 이름을 입력한 후검색 결과를 클릭하세요. 
  2. 설치를 클릭하세요. 
  3. 연결 단계를 계속하려면 앱 목록 페이지로 이동합니다. 

동일한 타사 앱의 여러 인스턴스를 HubSpot에 연결할 수 있습니다. 예를 들어, 두 개의 Microsoft Dynamics 계정을 관리하는 경우 하나의 HubSpot 계정으로 두 계정의 데이터를 연결하고 동기화할 수 있습니다. 추가 계정을 연결하려면:

  1. HubSpot 계정에서 상단 탐색 모음에 있는 settings 설정 아이콘을 클릭합니다. 왼쪽 사이드바 메뉴에서 통합 > 연결된 앱으로 이동합니다.
  2. 이름을 클릭하세요. 
  3. 오른쪽 상단에서 계정 작업 >계정 관리를 클릭합니다. 
  4. 오른쪽 패널에서 다른 계정 연결을 클릭합니다. 
  5. 앱을 HubSpot에 연결하는 단계를 진행하세요. 

데이터 동기화 켜기

앱 연결 후, 두 통합 간 데이터 동기화를 시작하려면 앱 설정을 구성하고 동기화를 켜야 합니다. 

  1. HubSpot 계정에서 상단 탐색 모음에 있는 settings 설정 아이콘을 클릭합니다. 왼쪽 사이드바 메뉴에서 통합 > 연결된 앱으로 이동합니다.
  2. 을 클릭하세요.
  3. '동기화 설정'을 클릭하세요.
  4. '동기화할 데이터 선택' 페이지에서 앱에서 동기화할 대상 또는 원본 개체와 HubSpot에서 동기화할 대상 또는 원본 개체를 선택하세요.
  5. 화살표 드롭다운 메뉴를 클릭하고 앱과 HubSpot 간에 양방향 또는 단방향 동기화를 선택하거나 그 반대로 설정하세요. 

Data sync setup, showing the option to select the data sync direction.

다른 앱으로 연락처 및 리드 동기화하기에 대해 자세히 알아보세요. 동기화 방향 구성

동기화 방향 구성

구성 화면에서 동기화 방향을 선택하고 타사 앱의 필드를 HubSpot 속성에 매핑하세요.

동기화 방향 선택 섹션에서 HubSpot에서 타사 앱으로, 또는 그 반대로 데이터를 동기화할 방식을 결정하세요. 세 가지 옵션이 있습니다: 

  • 앱 간 데이터 동기화: 모든 신규 및 업데이트된 개체 정보가 두 앱 간에 동기화됩니다. 양쪽 플랫폼에 이미 존재하는 레코드의 속성은 병합됩니다. 
  • 데이터는 HubSpot으로만 동기화: 데이터는 타사 앱에서 HubSpot으로만 동기화됩니다.
  • 데이터를 타사 앱으로만 동기화: 데이터는 HubSpot에서 타사 앱으로만 동기화됩니다. 

연결하려는 타사 앱이 이벤트 동기화를 지원하는 경우, 이메일 열람 및 클릭과 같은 지원되는 이벤트를 타사 앱에서 HubSpot으로 동기화할 수 있습니다.

이벤트 동기화를 활성화하기 전에 다음 사항을 유의하십시오: 

  • 이벤트 동기화는 타사 앱에서 HubSpot으로의 단방향 동기화입니다.
  • 이벤트 동기화는 연락처 레코드와 연결된 이벤트만 동기화합니다.
  • 연락처 레코드 동기화가 실패하더라도, 연관된 이벤트는 여전히 HubSpot으로 동기화될 수 있습니다.
  • 이벤트는 HubSpot에 이미 존재하는 연락처와 연결된 경우에만 동기화됩니다.

이벤트 동기화를 켜려면 [원하는 타사 앱] 이벤트를 HubSpot으로 일방향 동기화 확인란을 선택하세요. 

Data sync configuration settings, showing the option to sync events one-way into HubSpot.

데이터 충돌 해결 섹션에서 드롭다운 메뉴를 클릭하고 데이터 불일치가 발생할 때 다른 앱을 덮어쓸 기본 앱을 선택하세요. 기본 앱에 필드 값이 없는 경우 타사 앱의 데이터는 변경되지 않습니다. 이 설정은 동기화 방향 선택 섹션에서 선택한 동기화 방향을 무시하지 않습니다.

Data sync configuration, displaying the option to set data conflict resolution settings.

필드 매핑 검토

'필드 매핑' 섹션에서 기본 속성 매핑과 HubSpot과 타사 앱 간 정보 동기화 방식을 검토하세요. 유료 Data Hub 구독이 있는 경우 속성에 대한 사용자 지정 매핑을 설정할 수 있습니다. 유료 Data Hub 구독이 없는 경우,사용자 지정 매핑 시험 사용을 클릭하여 기능을 테스트하십시오. 

필수 필드는 필드 매핑 테이블에 별표(*)로 표시됩니다. 

매핑을 해제하려면 토글을 클릭하여끄십시오. 

Data sync configuration page, showing field mapping settings.

사용자 지정 필드 매핑 설정 방법:

  1. 매핑 추가를 클릭하세요. 
  2. 드롭다운 메뉴를 사용하여 매핑할 타사 앱과 HubSpot 속성을 선택하세요.
  3. 성공적으로 업데이트를 클릭하세요.
Data sync configuration settings, displaying the creation of a custom field mapping.
  1. 사용자 지정 매핑을 해제하려면스위치를 끄도록토글하세요. 

데이터 동기화 필드 매핑에 대한 구체적인 규칙 및 고려 사항에 대해 자세히 알아보세요.

동기화 규칙 설정

제한 화면에서 HubSpot과 타사 앱 간 레코드 동기화 방식을 구성하세요.

거래 동기화를 구성하는 경우 HubSpot과 타사 앱 간의 거래 파이프라인 및 단계를 매핑하라는 메시지가 표시됩니다. 매핑된 거래 단계에 있는 거래만 동기화됩니다. 

  1. '거래 파이프라인 및 단계 매핑' 섹션에서 'HubSpot 파이프라인 선택' 드롭다운 메뉴를 클릭하여 타사 앱과 동기화할 HubSpot 거래 파이프라인을 선택하세요.
  2. '자동 매핑'을 클릭하면 HubSpot 거래 단계가 타사 앱의 거래 단계와 자동으로 매핑됩니다. 동기화는 간단한 텍스트 검색을 수행하여 유사하게 들리는 단계를 매핑하려고 시도합니다.
  3. 추가 파이프라인을 매핑하려면 '다른 파이프라인 매핑'을 클릭하세요.

Data sync settings, displaying pipeline field mappings and the option to map another pipeline.

HubSpot에서 다른 앱의 거래 단계를 볼 수 없는 경우 다음 이유 때문입니다:

  • 연결된 사용자 계정에 거래 단계를 볼 수 있는 적절한 권한이 없습니다.
  • 데이터 동기화는 HubSpot 거래 단계를 다른 앱의 파이프라인 단계와 매핑합니다. 거래/기회 단계에 의존하지 않는 비표준 영업 프로세스를 사용하는 경우 HubSpot 데이터 동기화를 통해 데이터를 동기화할 수 없습니다.

연락처 동기화를 구성하는 경우, 기본적으로 HubSpot은 유효한 이메일 주소를 가진 연락처만 동기화합니다. 이메일 주소가 없는 연락처도 동기화하려면 중복 제거섹션에서 이메일 주소가 있는 연락처만 동기화 확인란을 선택 해제하세요.

레코드 매칭에 대해 자세히 알아보세요.

참고: 앱에 회사명과 회사 도메인 필드가 모두 있는 경우, HubSpot은 회사명은 같지만 도메인이 다른 레코드, 또는

그 반대의 경우를

일치시킵니다.

필터 섹션에서 HubSpot과 타사 앱 간 동기화 대상 레코드를 제한할 기준을 선택하세요:

  1. 편집을 클릭합니다.
  2. 오른쪽 패널에서 HubSpot과 타사 앱 간 동기화할 레코드를 제한할 속성을 선택합니다.
  3. 완료를 클릭합니다. 
Data sync settings, showing the option to filter records that will sync.

참고: 필터섹션은 HubSpot과 타사 앱 간에 초기 동기화되는 레코드만 제한합니다. 레코드가 동기화된 후에는 설정된 속성 매핑에 따라 데이터가 계속 양방향으로 동기화됩니다.


레코드 연결

HubSpot은 가능한 경우 연결한 원본 앱과 동기화할 때 레코드 간 동일한 연결 관계(예: 연락처와 연결된 회사, 회사와 연결된 거래)를 유지하려고 합니다. 데이터 동기화와 연결 매핑에 대해 자세히 알아보세요.

참고: 대부분의 경우 데이터 동기화는 인보이스와 연락처만 자동으로 연결할 수 있습니다. 인보이스는 HubSpot에서 회사 레코드에 수동으로 연결해야 합니다. 

규칙 검토 및 동기화 시작

검토 화면에서 구성한 규칙을 확인한 후 '저장 및 동기화'를 클릭하세요. 초기 동기화가 처리되기 시작합니다

.

초기 동기화가 완료된 후에는 레코드가 변경된 지 10분 이내에 동기화됩니다.

삭제된 레코드 재동기화

HubSpot 또는 타사 앱에서 레코드를 삭제한 경우, 삭제된 레코드를 재동기화하여 양쪽 앱에 다시 생성할 수 있습니다:

  1. HubSpot 계정에서 상단 탐색 모음에 있는 settings 설정 아이콘을 클릭합니다. 왼쪽 사이드바 메뉴에서 통합 > 연결된 앱으로 이동합니다.
  2. 을 클릭하세요.
  3. CRM 동기화 탭으로 이동합니다. 
  4. 객체 보기 탭의 실패 열에서 동기화에 실패한 레코드수를클릭하세요. 
  5. 오른쪽 패널에서작업을 클릭하세요.
  6. HubSpot에서 삭제된 레코드 재동기화 또는[타사 앱]에서 삭제된 레코드 재동기화 중 하나를 선택하세요.
  7. 모두 다시 동기화를 클릭하세요. 

다음 방법도 사용 가능합니다:

  1. 레코드 보기 탭에서더보기 >삭제된 레코드 모두 복원을 클릭합니다. 
  2. 사이드 패널에서레코드 유형 드롭다운 메뉴를 클릭하고 레코드 유형을 선택한 다음대상 앱 드롭다운 메뉴에서 연락처를 재생성할 앱을 선택합니다. 
  3. 복원 전 검토를 클릭합니다. 
  4. 복원될 모든 레코드를 검토한 후 [숫자]개 모두 복원을 클릭합니다. 
Data sync record overview, highlighting the option to restore all deleted records for select sync failures.

데이터 동기화 끄기

앱의 레코드가 HubSpot에서 동기화되지 않도록, 또는 그 반대의 경우를 방지하려면 데이터 동기화를 끌 수 있습니다. 
  1. HubSpot 계정에서 상단 탐색 모음에 있는 settings 설정 아이콘을 클릭합니다. 왼쪽 사이드바 메뉴에서 통합 > 연결된 앱으로 이동합니다.
  2. 을 클릭하세요.
  3. CRM 동기화 탭으로 이동합니다. 
  4. [object] 동기화 위에 마우스를 올려 놓고, [ 더 보기 ] 드롭다운 메뉴를 클릭한 다음 [동기화 끄기]를 선택하세요. 
  5. 팝업 상자에서 동기화 끄기를 클릭하세요.

동기화가 꺼진 후에는'동기화 설정 편집'을 클릭하여 다시 켤 수 있거나 동기화를 삭제할 수 있습니다.

동기화 상태 확인

앱을 연결한 후 HubSpot과 타사 앱 간에 동기화되는 레코드 개요를 확인하세요. 

  1. HubSpot 계정에서 상단 탐색 모음에 있는 settings 설정 아이콘을 클릭합니다. 왼쪽 사이드바 메뉴에서 통합 > 연결된 앱으로 이동합니다.
  2. 을 클릭하세요.
  3. CRM 동기화 탭으로 이동합니다. 
  4. 객체별 동기화 상태를 보려면 객체 보기를 클릭하세요.
    • 초기 동기화의 일환으로 처리 중인 레코드 옆에는 회전하는 원이 표시됩니다.
    • 동일한 데이터에 대한 업데이트가 동시에 발생하지 않도록 다른 동기화가 진행 중인 경우 레코드의 상태는 대기 중으로 표시됩니다.
    • 각 개체의 동기화 상태 위에 마우스를 올려 놓으면 동기화 진행 상황에 대한 자세한 내용을 확인할 수 있습니다. 동기화 상태 추적기는 스캔, 동기화, 동기화 완료 및 변경 사항 수신 대기 등 통합의 현재 동기화 단계를 표시합니다. 
Screenshot showing the sync status tracker for an integration using data sync in HubSpot.
  1. '동기화 중'열에서 레코드 수를클릭하면 HubSpot과 앱 간에 동기화되는 모든 레코드를 검토할 수 있습니다.
  2. '실패' 열에서레코드 수를클릭하면 HubSpot과 앱 간 동기화에 실패한 모든 레코드를 확인할 수 있습니다. 
    • '동기화 활동' 열에서오류옆에 있는 오른쪽 화살표 아이콘을 클릭하면 동기화 실패 원인에 대한 자세한 정보를 볼 수 있습니다.
    • 인공지능 아이콘 ( artificialIntelligenceIcon )의 문제 해결(Troubleshoot )을 클릭하면 Breeze Assistant가 열리고 레코드의 동기화 오류를 해결하기 위한 안내 및 문제 해결 단계를 받을 수 있습니다. 

connected-apps-data-sync-troubleshoot

connected-apps-data-sync-troubleshoot-example

  1. 제외됨 열에서 레코드 수를 클릭하면 동기화에서 제외된 모든 레코드를 볼 수 있습니다. 이는 동기화 설정의 필터와 일치하지 않거나 고유 식별자가 할당되지 않았기 때문일 수 있으며, 이는 일치 키가 정의되어 있기 때문일 수 있습니다. 

데이터 동기화 앱에서 레코드 내보내기

데이터 동기화 앱에서 레코드를 내보내려면:

  1. HubSpot 계정에서 상단 탐색 모음에 있는 settings 설정 아이콘을 클릭합니다. 왼쪽 사이드바 메뉴에서 통합 > 연결된 앱으로 이동합니다.
  2. 을 클릭하세요.
  3. CRM 동기화 탭으로 이동합니다. 
  4. '동기화 중', '실패', '제외됨' 열에서 내보내려는 레코드가 있는 개체 옆의 숫자를 클릭하세요.
  5. 오른쪽 상단에서 '더보기'를 클릭한 후 '내보내기'를 선택하세요.
  6. 파일 형식 드롭다운 메뉴를 클릭하고 형식을 선택하세요.
  7. 내보내기를 클릭하세요. 내보내기가 처리되면 이메일과 알림 센터를 통해 다운로드 링크를 받게 됩니다. 
이 문서가 도움이 되었나요?
이 양식은 문서 피드백에만 사용됩니다. HubSpot으로 도움을 받는 방법 알아보기.