주의:: 이 문서는 사용자의 편의를 위해 제공됩니다. 이 문서는 번역 소프트웨어를 사용하여 자동으로 번역되었으며 교정을 거치지 않았을 수 있습니다. 이 문서의 영어 버전이 가장 최신의 정보를 확인할 수 있는 공식 버전으로 간주해야 합니다. 여기에서 액세스할 수 있습니다..
HubSpot-Salesforce 연동 시 데이터 동기화가 이루어지지 않는 동기화 오류가 발생할 수 있습니다. Salesforce 연동 설정에서 이러한 동기화 오류를 확인하고 해결할 수 있습니다.
API 호출 제한 조정
HubSpot 계정에서 상단 탐색 모음에 있는 설정 아이콘을 클릭합니다. 왼쪽 사이드바 메뉴에서 통합 > 연결된 앱으로 이동합니다.
연결된 앱 목록에서Salesforce를 클릭하세요.
'데이터 동기화' 탭으로 이동합니다.
'동기화 상태' 탭의 'API 호출 사용량' 섹션에서지난 24시간 동안 사용한 API 호출 횟수를 확인하세요.'Salesforce 제한' 수치는 Salesforce 설정에 따라 수행할 수 있는 API 호출 횟수입니다. HubSpot에 할당할 수 있는 호출 횟수를 조정하려면 'HubSpot에 할당됨' 필드를 편집하세요.
Salesforce 동기화 오류 확인
HubSpot 계정에서 상단 탐색 모음에 있는 설정 아이콘을 클릭합니다. 왼쪽 사이드바 메뉴에서 통합 > 연결된 앱으로 이동합니다.
연결된 앱 목록에서Salesforce를 클릭합니다.
'데이터 동기화' 탭으로 이동합니다.
'동기화 상태' 탭의'동기화 오류' 섹션에서 각 오류 유형별 카드를 확인하면 현재 오류 수와 영향을 받은 레코드 수를 확인할 수 있습니다. 오류 유형 카드를 클릭하면 오른쪽 패널에 오류 세부 정보가 표시됩니다. 각 오류 유형 및 해결 방법에 대한 권장 사항에 대해 자세히 알아보세요.
오류에 대한 자세한 내용을 보려면 '오류 유형' 열의 정보 아이콘을 클릭하세요.
개별 레코드에 대해 조치를 취하려면 ‘영향을 받은 레코드’ 열에서 [#] 레코드를 클릭한 다음, ‘작업’ > ‘HubSpot 레코드의 임시 보기 생성’을 클릭하여 영향을 받은 레코드의 필터링된 보기를 생성하세요 .
오류를 해결한 후에는 오류 목록으로 돌아가세요. 해결된 오류 왼쪽의확인란을 선택한 다음 '재동기화'를 클릭하세요.
오류를 내보내려면 오류 목록의 왼쪽 상단에 있는 오류 내보내기(CSV)를 클릭하세요.
Salesforce 동기화 오류 유형
연관 관계
연관 관계 오류 예시
연결 한도 도달
계정 동기화 대기 중
연관성 카디널리티 불일치
오류의 의미
레코드가 HubSpot 기업 정보로 아직 동기화되지 않은 Salesforce 계정과 연결되어 있거나, HubSpot의 레코드 연결 한도에 도달한 레코드와 연결되어 있어 동기화되지 않습니다.
HubSpot에서 여러 연락처와 연관된 활동이 Salesforce로 동기화되려고 할 때 ‘연관 관계 카디널리티 불일치’ 오류가 발생합니다. 이 통합 기능은 활동당 하나의 연락처 연관 관계만 동기화할 수 있습니다.
오류 해결 방법
'연관 제한에 도달함' 오류를해결하려면, 연관된 레코드 중 일부를 제거하거나 다른 Salesforce 레코드와 연관시킨 후 동기화를 진행하십시오.
'연관성 카디널리티 불일치' 오류를 해결하려면, 해당 활동과 연관된 연락처가 하나만 남도록 나머지 연락처 연관성을 제거하십시오.
사용자 정의 코드
사용자 정의 코드 오류의 예
Salesforce 자동화
연락처 ID가 없습니다
Salesforce 사용자 정의 필드 유효성 검사 규칙
Salesforce 플로우
오류의 의미
Salesforce 계정의 자동화, 플로우 또는 유효성 검사 규칙으로 인한 문제로 레코드가 동기화되지 않습니다.
오류 해결 방법
이러한 오류는 Salesforce에서 발생하는 것이므로, Salesforce 관리자와 협력하여 Salesforce의 사용자 정의 코드에서 문제를 해결하는 것이 좋습니다.
중복
중복 오류 예시
이메일 주소가 이미 사용 중입니다
Salesforce 중복 규칙
오류의 의미
이메일 주소가 HubSpot 연락처 레코드에 이미 존재하거나 Salesforce의 중복 제거 규칙으로 인해 Salesforce 리드 또는 연락처가 HubSpot과 동기화되지 않습니다.
오류 해결 방법
'이메일 주소가 이미 사용 중입니다' 오류를 해결하려면 기존 HubSpot 연락처에서 해당 이메일 주소를 삭제하십시오.
Salesforce 중복 규칙 오류를 해결하려면 Salesforce 관리자가 Salesforce에 설정된 중복 제거를 위한 일치 규칙을 검토하는 것이 좋습니다. 그런 다음, HubSpot에서 다시 동기화를 시도하기 전에 충돌하는 Salesforce 레코드를 병합, 업데이트 또는 삭제하거나 Salesforce의 중복 제거 규칙을 조정하십시오.
권한
권한 오류 예시
Salesforce 레코드에 대한 액세스 권한 부족 또는 레코드 없음
Salesforce 필드 권한
Salesforce 액세스 권한 부족
오류의 의미
연결된 사용자가 Salesforce의 필요한 필드나 개체에 대한 액세스 권한이 없기 때문에 HubSpot에서 변경한 내용이 Salesforce로 동기화되지 않습니다.
오류 해결 방법
대부분의 경우, '접근 권한 부족' 또는 'Salesforce 레코드 없음' 오류는 통합 기능이 잘못된 값으로 Salesforce 필드를 업데이트하거나 잘못된 연관 관계를 생성하려고 할 때 발생합니다.
Salesforce 필드 권한 오류를 해결하려면 Salesforce 통합 사용자가 해당 Salesforce 필드에 대한 '읽기' 및 '편집' 권한을 가지고 있는지 확인하십시오.
'Salesforce 액세스 권한 부족' 오류는 Salesforce 통합 사용자가 Salesforce 내 사용자 권한 문제로 인해 Salesforce에서 해당 작업을 수행할 수 없을 때 발생합니다. Salesforce에서 Salesforce 통합 사용자의 권한을 확인하는 것이 좋습니다.
픽리스트
픽리스트 오류 예시
Salesforce 선택 목록 옵션이 없음
주 또는 국가 값이 일치하지 않음
옵션 불일치
비활성 Salesforce 소유자
제한된 픽리스트 값
비활성 기회 단계
Salesforce 소유자가 동기화되지 않음
옵션 한도 초과
기본 영업 프로세스를 사용할 수 없음
기회 단계가 없거나 유효하지 않음
오류의 의미
HubSpot과 Salesforce의 픽리스트 필드 값 간에 불일치가 있어 레코드가 동기화되지 않습니다. 이는 한 시스템의 픽리스트 값이 다른 시스템의 현재 값과 일치하지 않거나, 픽리스트의 값 제한에 도달했거나, 전달된 값이 유효하지 않은 경우에 발생할 수 있습니다.
오류 해결 방법
'상태 또는 국가 값 불일치' 오류를 해결하려면 다음 요구 사항이 충족되는지 확인하는 것이 좋습니다.
HubSpot의 ‘국가’ 속성 옵션의 내부 값은 Salesforce의 ‘주 및 국가/지역’ 선택 목록 설정 에 있는 기존 ‘국가’ 옵션과 일치해야 합니다.
'주' 값은 Salesforce에서 해당 레코드의 '국가' 값에 대해 사용 가능한 '주/도' 옵션으로존재해야 합니다. 또한, HubSpot의 '주' 속성 옵션의 내부 값은 Salesforce의 기존 '주' 옵션과 일치해야 합니다.
'옵션 불일치' 오류를 해결하려면, Salesforce 필드 옵션의 내부/API 이름을 HubSpot 속성 옵션의 내부 값과 일치하도록 업데이트하는 것이 좋습니다.
'비활성 Salesforce 소유자' 오류를 해결하려면 HubSpot 레코드를 Salesforce에서 활성 상태인 사용자에게 다시 할당하십시오.
'제한된 픽리스트 값' 오류는Salesforce에서 해당 필드에 대해 '픽리스트를 값 집합에 정의된 값으로 제한' 설정이 켜져 있을 때발생합니다. Salesforce에서 이 설정이 켜져 있는 경우, HubSpot에서 Salesforce로 동기화하려는 값은 Salesforce 픽리스트의 옵션으로 존재해야 합니다. HubSpot에서 Salesforce로 모든 값을 동기화할 수 있도록, Salesforce의 '픽리스트를 값 세트에 정의된 값으로 제한' 설정을 비활성화하는 것이 좋습니다.
'비활성 기회 단계' 오류는 비활성 기회 단계를 가진 Salesforce 기회가 HubSpot으로 동기화되려고 할 때발생합니다 . 이 오류를 해결하려면 Salesforce에서 기회 단계를 '활성'으로변경하거나 기회를 활성 단계로 이동하십시오.
'Salesforce 소유자 동기화 실패' 오류를 해결하려면, 해당 Salesforce 사용자의 '사용자 유형'이'표준(Standard)', '파워 파트너( Power Partner)' 또는 '게스트 ( Guest )'로 설정되어 있는지 확인하십시오.
'옵션 한도 초과' 오류를 해결하려면, 팀에서 사용하지 않는 HubSpot 및 Salesforce의 불필요한 속성 옵션을 삭제하는 것이 좋습니다. 또한, 매핑된 모든 속성에 해당하는 필드 유형이 있는지 확인하십시오.
대부분의 경우, '기본 영업 프로세스를 사용할 수 없음' 오류는 Salesforce 영업 기회에서 레코드 유형이 누락된 상태로 HubSpot과 동기화를 시도할 때 발생합니다. Salesforce에서 레코드 유형을 활성화했지만 사용하지 않거나, 레코드 유형이 없는 Salesforce 영업 기회가 있는 경우, Salesforce 담당자와 협력하여 모든 레코드 유형을 비활성화하거나 새로운 레코드 유형을 생성하는 것이 좋습니다.
'기회 단계가 없거나 유효하지 않음 ' 오류를 해결하려면, Salesforce 기회 단계 값이 HubSpot 파이프라인에 존재하는지 확인하십시오.
Salesforce 작업 필드 오류의 경우, Salesforce의 ‘작업 우선순위’, ‘상태’ 또는 ‘유형’ 값을 HubSpot의 해당 작업 속성 옵션과 비교하십시오. ‘작업 우선순위’는‘높음’, ‘중간’, ‘낮음’ 및 ‘없음’만 지원합니다. ‘상태’ 및 ‘유형’의 경우, Salesforce 값을 HubSpot에서 사용할 수 있는 옵션과 정확히 일치하도록 업데이트하거나 HubSpot에 일치하는 옵션을 추가하십시오.
속성 매핑
속성 매핑 오류 예시
유형 불일치
Salesforce ID가 누락되었습니다
잘못된 Salesforce ID
오류의 의미
HubSpot 속성과 Salesforce 필드 간의 매핑 불일치로 인해 레코드가 동기화되지 않습니다. 이는 속성과 필드 유형이 호환되지 않거나, 속성 또는 필드가 더 이상 존재하지 않거나, Salesforce 참조 필드 매핑을 생성해야 함을 의미할 수 있습니다.
레코드에 유효하지 않은 속성 값이 포함되어 있어 HubSpot과 Salesforce 간에 레코드가 동기화되지 않습니다. 이러한 오류를 해결하려면 일반적으로 해당 오류가 발생한 개별 레코드를 업데이트하여 오류를 수정해야 합니다.
오류 해결 방법
'문자열이 너무 깁니다' 오류를 해결하려면 Salesforce 또는 HubSpot에서 필드 값을 줄이거나, Salesforce에서 해당 필드의 문자 수 제한을 늘리십시오.
'무효한 이메일' 오류를 해결하려면 HubSpot과 동기화하려는 Salesforce 레코드의 이메일 주소 형식을 수정하십시오.
'필수 국가 정보 누락' 오류를 해결하려면 다음 요구 사항이 충족되는지 확인하는 것이 좋습니다.
HubSpot의 '국가' 속성 옵션의 내부 값은 Salesforce의 '주 및 국가/지역' 선택 목록 설정 에 있는 기존 '국가' 옵션과 일치해야 합니다.
'주(State) ' 값은 Salesforce에서 해당 레코드의 '국가(Country) ' 값에 대해 '사용 가능한 주/도(State/Province)' 옵션으로존재해야 합니다. 또한, HubSpot의 '주(State)' 속성 옵션의 내부 값은 Salesforce의 기존 '주(State) ' 옵션과 일치해야 합니다.
'잘못된 값' 오류를 해결하려면, Salesforce 레코드의 속성 값을 HubSpot의 속성 값 요구 사항을 충족하도록 업데이트하는 것이 좋습니다.
대부분의 경우, ‘담당자 할당’ 오류는 HubSpot 활동이 Salesforce 작업으로 Salesforce에 동기화될 때 HubSpot이 해당 작업을 Salesforce 대기열 담당자에게 할당하려고 시도할 때 발생합니다.
