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

HubSpot-Salesforce 통합에 동기화 오류가 발생하여 데이터가 동기화되지 않을 수 있습니다. Salesforce 연동 설정에서 이러한 동기화 오류를 식별하고 해결할 수 있습니다.

API 호출 제한 조정

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

Salesforce 동기화 오류 보기

• HubSpot 계정에서 상단 탐색 모음에 있는 settings 설정 아이콘을 클릭합니다. 왼쪽 사이드바 메뉴에서 통합 > 연결된 앱으로 이동합니다.
• 연결된 앱 목록에서 Salesforce를 클릭합니다.
• 상태 동기화 탭의 오류 동기화 아래에서 각 오류 유형에 대한 카드와 현재 오류 수 및 영향을 받는 레코드를 확인합니다. 오류 유형 카드를 클릭하면 오른쪽 패널에서 오류에 대한 자세한 내용을 볼 수 있습니다. 각 오류 유형 및 해결 권장 사항에 대해 자세히 알아보세요.

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

Salesforce 동기화 오류 유형

연결

연결 오류의 예

• 연결 한도에 도달했습니다
• 계정 동기화 대기 중

오류의 의미

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

오류 해결 방법

연결 제한에 도달했습니다 오류를 해결하려면 연결된 레코드 중 일부를 제거하거나 다른 Salesforce 레코드와 연결한 다음 동기화를 계속 진행하면 됩니다.

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

사용자 지정 코드

사용자 지정 코드 오류의 예

• Salesforce 자동화
• 누락된 연락처 ID
• Salesforce 사용자 지정 필드 유효성 검사 규칙
• Salesforce 흐름

오류의 의미

Salesforce 계정의 자동화, 흐름 또는 유효성 검사 규칙으로 인해 발생한 문제로 인해 레코드가 동기화되지 않습니다.

오류 해결 방법

중복

중복 오류의 예

• 이미 사용 중인 이메일
• Salesforce 중복 규칙

오류의 의미

이메일 주소가 이미 HubSpot 연락처 레코드에 존재하거나 Salesforce의 중복 제거 규칙으로 인해 Salesforce 리드 또는 연락처를 HubSpot에 동기화할 수 없습니다.

오류 해결 방법

이미 사용 중인 이메일 오류를 해결하려면 기존 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 사용자의 사용자 유형이 Salesforce에서 표준, 파워 파트너 또는 게스트로 설정되어 있는지 확인하세요.

옵션 한도 초과 오류를 해결하려면 팀에서 사용하지 않는 추가 속성 옵션을 HubSpot 및 Salesforce에서 삭제하는 것이 좋습니다. 또한 매핑된 모든 속성에 해당 필드 유형이 있는지 확인하세요.

대부분의 경우, 기본 영업 프로세스를 사용할 수 없음 오류는 Salesforce 기회가 누락된 레코드 유형으로 HubSpot에 동기화하려고 할 때 발생합니다. Salesforce에서 레코드 유형을 설정했지만 사용하지 않거나 레코드 유형이 없는 Salesforce 기회가 있는 경우 Salesforce와 협력하여 모든 레코드 유형을 비활성화하거나 새 레코드 유형을 생성하는 것이 좋습니다.

누락되었거나 유효하지 않은 기회 단계 오류를 해결하려면 Salesforce 기회 단계 값이 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의 주 및 국가/지역 선택 목록 설정에 있는 기존 국가 옵션과 일치해야 합니다.
• 주 값은 Salesforce에서 레코드의 국가 값에 대해 사용 가능한 주/시/도 옵션으로 존재해야 합니다. 또한 HubSpot의 주 속성 옵션의 내부 값은 Salesforce의 기존 주 옵션과 일치해야 합니다.

유효하지 않은 값 오류를 해결하려면 Salesforce 레코드에서 속성 값에 대한 HubSpot의 요구 사항을 충족하도록 속성 값을 업데이트하는 것이 좋습니다.

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

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

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

기타

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

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

동기화 오류 알림 설정

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