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

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

마지막 업데이트 날짜: 2026년 4월 17일

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

HubSpot 데이터

동기화를

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

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

데이터 동기화 작동 방식

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

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

데이터 동기화는 정규화 을 사용하여 레코드가 고유하지 않은 이름 필드(예: 회사명 또는 제품명)로 매칭될 때 지원되는 데이터 동기화 앱에서 일치 여부를 확인합니다. 즉, HubSpot과 다른 앱 간에 해당 이름 값을 비교할 때 대소문자, 특수 문자 및 구두점은 무시됩니다.

동기화 원칙

데이터 동기화는 항상 두 앱 간에 이루어지며, 그중 하나는 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. [객체] 동기화 항목 위에 마우스를 올리고, '더 보기' 드롭다운 메뉴를 클릭한 다음 '동기화 끄기'를 선택합니다. 
  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과 앱 간에 동기화되지 않은 모든 레코드를 볼 수 있습니다. 
    • '동기화 활동' 열에서오류옆에 있는 오른쪽 화살표 아이콘을 클릭하면 동기화 실패 원인에 대한 자세한 정보를 확인할 수 있습니다.
    • '문제 해결'을 클릭하면 Breeze Assistant가 열리며, 해당 레코드의 동기화 오류를 해결하기 위한 안내 및 문제 해결 단계를 확인할 수 있습니다. 

connected-apps-data-sync-troubleshoot

connected-apps-data-sync-troubleshoot-example

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

일부 레코드의 동기화가 실패하는 경우, 해당 레코드에 대해서만 재동기화를 실행할 수 있습니다.

  1. HubSpot 계정에서 상단 탐색 모음에 있는 settings 설정 아이콘을 클릭합니다. 왼쪽 사이드바 메뉴에서 통합 > 연결된 앱으로 이동합니다.
  2. 을 클릭하세요.
  3. 'CRM 동기화 ' 탭으로 이동합니다. 그런 다음 '레코드 보기 ' 탭을 클릭합니다.
  4. 다시 동기화할 레코드 옆의 확인란 을 클릭합니다.
  5. 그런 다음 [count] 레코드에 대해 동기화 다시 실행을 클릭합니다.
connected-apps-data-sync-rerun-sync-1

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

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

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