Salesforce 통합 API 호출 및 동기화 오류 관리

HubSpot과 Salesforce 간의 연동 과정에서 동기화 오류가 발생하여 데이터가 동기화되지 않을 수 있습니다. Salesforce 연동 설정에서 이러한 동기화 오류를 확인하고 해결할 수 있습니다.

API 호출 제한 조정

1. HubSpot 계정에서 상단 탐색 모음에 있는 설정 아이콘을 클릭합니다. 왼쪽 사이드바 메뉴에서 통합 > 연결된 앱으로 이동합니다.
2. 연결된 앱 목록에서Salesforce를 클릭하세요. 
3. '데이터 동기화' 탭으로 이동합니다. 
4. '동기화 상태' 탭의 'API 호출 사용량' 섹션에서지난 24시간 동안 사용한 API 호출 횟수를 확인하세요.'Salesforce 제한' 수치는 Salesforce 설정에 따라 수행할 수 있는 API 호출 횟수입니다. HubSpot에 할당할 수 있는 호출 횟수를 조정하려면 'HubSpot에 할당됨' 필드를 편집하세요. 

Salesforce 동기화 오류 확인

1. HubSpot 계정에서 상단 탐색 모음에 있는 설정 아이콘을 클릭합니다. 왼쪽 사이드바 메뉴에서 통합 > 연결된 앱으로 이동합니다.
2. 연결된 앱 목록에서Salesforce를 클릭합니다. 
3. '데이터 동기화' 탭으로 이동합니다. 
4. '동기화 상태' 탭의'동기화 오류' 섹션에서 각 오류 유형에 대한 카드를 확인하고, 현재 오류 수와 영향을 받은 레코드 수를 확인하세요. 오류 유형 카드를 클릭하면 오른쪽 패널에 오류 세부 정보가 표시됩니다. 각 오류 유형 및 해결 방법에 대해 자세히 알아보세요. 

5. 오류에 대한 자세한 내용을 보려면 오류 유형 열의 정보 아이콘을 클릭하세요.
6. 개별 레코드에 대해 조치를 취하려면 '영향을 받는 레코드' 열에서 [#] 레코드를 클릭한 다음, '작업' > 'HubSpot 레코드의 임시 보기 생성'을 클릭하여 영향을 받는 레코드의 필터링된 보기를 만드십시오 . 
7. 오류를 해결한 후에는 오류 목록으로 돌아갑니다. 해결된 오류 왼쪽의확인란을 선택한 다음 '다시 동기화'를 클릭합니다.
8. 오류를 내보내려면 오류 목록의 왼쪽 상단에 있는 오류 내보내기(CSV)를 클릭하세요.

Salesforce 동기화 오류 유형

연관 관계

연관 관계 오류 예시 

• 연결 제한에 도달함
• 계정 동기화 대기 중

오류 의미

레코드가 HubSpot 회사와 아직 동기화되지 않은 Salesforce 계정과 연결되어 있거나, HubSpot의 레코드 연결 제한에 도달한 레코드와 연결되어 있어 동기화되지 않습니다. 

오류 해결 방법 

'연관 제한에 도달함' 오류를해결하려면, 연관된 레코드 중 일부를 제거하거나 다른 Salesforce 레코드와 연관시킨 후 동기화를 진행하십시오.

'계정 동기화 대기 중' 오류를 해결하려면 Salesforce 계정을 가져오기를 실행하는 것이 좋습니다. 

사용자 지정 코드

사용자 정의 코드 오류 예시 

• Salesforce 자동화
• 연락처 ID가 없습니다
• 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 사용자의 '사용자 유형'이 '표준', '파워 파트너' 또는 '게스트'로 설정되어 있는지 확인하십시오. 

'옵션 제한 초과' 오류를 해결하려면, 팀에서 사용하지 않는 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 ID 누락' 오류는 HubSpot이 기존 Salesforce ID가 아닌 다른 값을 Salesforce의 참조/조회 필드에 동기화하려고 시도했을 때 발생합니다. 

'잘못된 Salesforce ID' 오류를 해결하려면 Salesforce에서 설정한 사용자 지정 유효성 검사 규칙을 확인하는 것이 좋습니다. 

속성 값

속성 값 오류 예시

• 문자열이 너무 깁니다
• 잘못된 이메일
• 필수 국가 정보가 누락되었습니다
• 잘못된 값
• 소유자 할당
• 고유 값 제한
• 필수 값이 누락되었습니다

오류 의미

유효하지 않은 속성 값이 포함되어 있어 HubSpot과 Salesforce 간에 레코드가 동기화되지 않습니다. 이러한 오류는 일반적으로 오류를 수정하기 위해 해당 레코드를 개별적으로 업데이트해야 합니다.

오류 해결 방법

'문자열이 너무 깁니다' 오류를 해결하려면 Salesforce 또는 HubSpot에서 필드 값을 줄이거나, Salesforce에서 해당 필드의 문자 수 제한을 늘리십시오. 

'무효한 이메일' 오류를 해결하려면 HubSpot과 동기화하려는 Salesforce 레코드의 이메일 주소 형식을 수정하십시오.

'필수 국가 정보 누락' 오류를 해결하려면 다음 요구 사항이 충족되는지 확인하는 것이 좋습니다:

• HubSpot의 '국가' 속성 옵션의 내부 값은 Salesforce의 '주 및 국가/지역' 선택 목록 설정 에 있는 기존 '국가' 옵션과 일치해야 합니다. 
• 주(State) 값은 Salesforce에서 해당 레코드의 국가(Country ) 값에 대해 사용 가능한 주/도(State/Province) 옵션으로존재해야 합니다. 또한 HubSpot의 State 속성 옵션의 내부 값은 Salesforce의 기존 State 옵션과 일치해야 합니다. 

'잘못된 값' 오류를 해결하려면, HubSpot의 속성 값 요구 사항을 충족하도록 Salesforce 레코드의 속성 값을 업데이트하는 것이 좋습니다. 

대부분의 경우, '소유자 할당' 오류는 HubSpot 활동이 Salesforce 작업으로 Salesforce에 동기화되고 HubSpot이 해당 작업을 Salesforce 큐 소유자에게 할당하려고 할 때 발생합니다.

'제한된 고유 값' 오류를 해결하려면 Salesforce에서 설정한 중복 제거를 위한 매칭 규칙을 확인하는 것이 좋습니다. 

'필수 값 누락' 오류를 해결하려면 HubSpot에서 필수로 표시된 모든 속성에 대해 Salesforce 레코드에 값을 추가하십시오. 

기타

알 수 없는 오류로 인해 레코드가 동기화되지 않습니다. 이 오류에 대한 추가 지원이 필요하시면 HubSpot 지원팀에 문의해 주십시오.

참고: 한 번에 최대 100개의 Salesforce 오류를 일괄 재동기화할 수 있습니다. 100개 이상의 오류를 동기화하려면 Salesforce에서 레코드를 가져오거나 매핑된 속성을 업데이트하십시오.

동기화 오류 알림 설정

1. HubSpot 계정에서 상단 탐색 모음에 있는 설정 아이콘을 클릭합니다. 왼쪽 사이드바 메뉴에서 통합 > 연결된 앱으로 이동합니다.
2. 연결된 앱 목록에서Salesforce를 클릭합니다. 
3. '데이터 동기화' 탭으로 이동합니다. 
4. '동기화 상태' 탭의 '동기화 오류' 섹션 에서'알림 관리'를 클릭합니다. 
5. 대화 상자에서알림 켜기 스위치를 켭니다. 
6. '즉시','매일' 또는'매주' 옆의 라디오 버튼을 선택하여 알림 빈도를 설정합니다. 
7. 저장을 클릭합니다.