Salesforce 통합 일시 중단 오류 해결
마지막 업데이트 날짜: 2025년 12월 17일
여러 가지 이유로 인해 HubSpot-Salesforce 연동 이 일시 중단될 수 있습니다. HubSpot-Salesforce 연동이 일시 중단될 때마다 이메일 알림을 받도록 선택할 수 있습니다.
Salesforce 조직 API 한도 초과
Salesforce 조직의 API 호출 한도가 초과되었습니다. Salesforce API 호출 한도를 초과하지 않도록 HubSpot에서 Salesforce API 호출 할당을 설정하는 것이 좋습니다. 마이그레이션을 수행하는 경우 Salesforce 지원팀에 문의하여 일시적으로 API 호출 한도를 늘려달라고 요청할 수 있습니다.
Salesforce 조직 API 액세스 비활성화
통합 사용자에게 API 활성화된 사용자 프로필 관리 권한이 있는지 확인한 다음 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 지원팀에 문의하세요.