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

Salesforce 연동 중단 오류 해결

마지막 업데이트 날짜: 2026년 8월 27일

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

HubSpot-Salesforce 연동이 일시 중지되면 두 시스템 간의 레코드 동기화가 중단될 수 있습니다. 일시 중지 오류 메시지를 확인하여 원인을 파악한 후, 권장되는 단계를 따라 동기화를 복원하십시오. HubSpot-Salesforce 연동이 일시 중지될 때마다 이메일 알림을 받도록 설정할 수 있습니다.

Salesforce 조직 API 한도 초과

Salesforce 조직의 API 호출 한도를 초과했습니다. Salesforce API 호출 한도 초과를 방지하려면 HubSpot에서 Salesforce API 호출 할당량을 설정하는 것이 좋습니다. 마이그레이션을 진행 중인 경우, Salesforce 지원팀에 문의하여 API 호출 한도를 일시적으로 늘려달라고 요청할 수 있습니다.

API 한도를 초과하면 Salesforce는 추가 API 요청을 더 이상 수락하지 않습니다. 이로 인해 HubSpot과 Salesforce 간의 동기화 및 레코드 업데이트에 문제가 발생할 수 있습니다. 통합 상태가 여전히 연결된 것으로 표시될 수 있지만, HubSpot에서 Salesforce 데이터를 가져오지 못할 수 있습니다. 이로 인해 Salesforce 필드가 로드되지 않거나, 필드 매핑에 문제가 발생하거나, 워크플로 또는 동기화 오류가 발생하거나, 동기화된 연락처 및 리드에 대한 Salesforce 캠페인 멤버십 데이터가 누락되거나 오래된 상태로 표시되거나, 리드와 같은 레코드가 생성되지 않을 수 있습니다.

일반적으로 API 한도가 재설정되거나 추가 API 용량이 확보되면 동기화가 자동으로 재개됩니다.

Salesforce 조직 API 액세스 비활성화됨

통합 사용자에게 ‘API 활성화( Enabled)’ 사용자 프로필 관리 권한이 있는지 확인한 후, Salesforce 사용자 자격 증명을 다시 입력하여 일시 정지 메시지를 해제하십시오.

알 수 없는 오류

Salesforce에서 전송된 오류 내용이 명확하지 않거나 알려지지 않았습니다. 이러한 유형의 사용 정지 현상은 드물며 대개 저절로 해결됩니다. 그러나 ‘사용 정지 해제’를 클릭한 후에도 오류가 지속되면 HubSpot 지원팀에 문의하십시오.

Salesforce 개체 권한 누락

이 오류의 가장 흔한 두 가지 원인은 다음과 같습니다.

  • 통합 사용자에게 Salesforce의 ‘사용 가능한 권한 세트’ 섹션에 있는 HubSpot 통합 권한 세트가 할당되어 있지 않은 경우.
  • 동기화를 시도하는 객체 중 하나에 Salesforce에서 올바른 권한이 부여되어 있지 않습니다.
이 오류를 해결하려면:
  • 연동 사용자가 동기화하려는 개체에 대해 ‘읽기’ 및 ‘수정’ 권한을 가지고 있는지 확인하십시오.
  • 통합 사용자에게 '읽기' 및 '편집' 권한이 있는 경우, 오류는 상호 연관된 개체와 관련될 수 있습니다. 통합 사용자가 모든 관련 개체(예: 조회 관계에 의한 개체)에 대해 '읽기' 및 '편집' 권한을 가지고 있는지 확인하십시오. 통합에는 일반적으로 다음 개체에 대한 액세스 권한이 필요합니다:
    • 리드
    • 연락처
    • 계정
    • 영업 기회
    • 캠페인
    • 작업
    • 사용자

Salesforce 필드 권한 누락

통합 사용자에게는 동기화 대상 객체의 필드 또는 조회 관계를 통해 연결된 관련 객체의 필드에 대한 읽기 및 편집 권한이 없습니다.

Salesforce 조직이 잠겨 있음

다른 업데이트가 진행되기 전에 반드시 완료되어야 하는 작업이 있을 때 일시적인 오류가 발생합니다. 예를 들어, HubSpot이 개체를 업데이트하는 동시에 다른 통합 기능이 해당 개체를 업데이트하고 있을 수 있습니다. '정지 해제'를 클릭한 후에도 오류가 지속되면 Salesforce 시스템 관리자에게 문의하여 조직의 잠금을 해제하십시오.

Salesforce 조직 저장 용량 한도 초과

Salesforce 조직의 저장 용량 한도를 초과했습니다. Salesforce에서 HubSpot 레코드를 일괄 삭제하는 방법을 알아보세요.

Salesforce 조직을 사용할 수 없음

현재 Salesforce에서 서비스 중단이 발생하고 있습니다. 서비스 가용성 및 성능에 대한 최신 정보는 Salesforce 상태 페이지 에서 확인하세요.

Salesforce.com 서버 오류

Salesforce에서 알 수 없는 오류가 발생했습니다. ‘중지 해제’를 클릭한 후에도 오류가 지속되면 Salesforce 상태를 확인하거나 Salesforce 지원팀에 문의하십시오.

HubSpot API 한도 초과

HubSpot에서 설정된 API 호출 할당량을 초과했습니다. Salesforce API 호출 할당량을 확인하고, 이에 따라 HubSpot에서 API 호출 한도를 늘리십시오. 사용 가능한 API 호출 수가 늘어나면 정지 상태가 자동으로 해제됩니다.

Salesforce 동기화 화면에 표시되는 API 사용량은 지난 24시간 동안의 누적 사용량을 기준으로 합니다. API 한도는 가장 최근 24시간 기간에 적용됩니다.

누락된 필드 매핑

HubSpot 속성과 Salesforce 필드 간에 매핑이 없습니다. ‘정지 해제’를 클릭한 후에도 오류가 지속되거나, 통합 설정에 표준 필드 매핑이 없는 경우 HubSpot 지원팀에 문의하십시오.

이 문서가 도움이 되었나요?
이 양식은 문서 피드백에만 사용됩니다. HubSpot으로 도움을 받는 방법 알아보기.