Salesforce 통합 API 호출 및 동기화 오류 관리
마지막 업데이트 날짜: 2월 12, 2025
명시된 경우를 제외하고 다음 구독 중 어느 것에서나 사용할 수 있습니다.
|
|
|
|
|
HubSpot-Salesforce 연동에서 데이터가 동기화되지 않는 동기화 오류가 발생할 수 있습니다. Salesforce 연동 설정에서 이러한 동기화 오류를 식별하고 해결할 수 있습니다.
API 호출 제한 조정
- HubSpot 계정에서 상단 탐색 모음에 있는 settings 설정 아이콘을 클릭합니다. 왼쪽 사이드바 메뉴에서 통합 > 연결된 앱으로 이동합니다.
- 연결된 앱 목록에서 Salesforce를 클릭합니다.
- 동기화 상태 탭을 클릭합니다.
- API 호출 사용 섹션에서 지난 24시간 동안 사용한 API 호출 수를 확인할 수 있습니다. Salesforce에 의해 제한됨 숫자는 Salesforce 설정에 따라 수행할 수 있는 API 호출의 양입니다. 이러한 호출 중 얼마나 많은 호출을 HubSpot에 할당할 수 있는지 조정하려면 HubSpot에 할당됨 필드를 편집합니다.
동기화 오류 해결
- HubSpot 계정에서 상단 탐색 모음에 있는 settings 설정 아이콘을 클릭합니다. 왼쪽 사이드바 메뉴에서 통합 > 연결된 앱으로 이동합니다.
- 연결된 앱 목록에서 Salesforce를 클릭합니다.
- 동기화 상태 탭을 클릭합니다.
- 동기화 오류 아래에 각 오류 유형에 대한 카드와 함께 현재 오류 수 및 영향을 받는 레코드가 표시됩니다. 오류 유형 카드를 클릭하면 오른쪽 패널에서 오류에 대한 자세한 내용을 볼 수 있습니다. 각 오류 유형에 대한 자세한 내용과 해결 단계는 아래를 참조하세요.
연결
레코드가 아직 HubSpot에 동기화되지 않은 레코드와 연결되어 있거나 HubSpot의 레코드 연결 제한에 도달한 레코드와 연결되어 있기 때문에 동기화되지 않습니다. 영향을 받는 레코드 열에서 왼쪽의 레코드 열에 있는 레코드와의 연결로 인해 동기화에 실패한 모든 레코드를 찾을 수 있습니다.
- 오류에 대한 자세한 내용과 해결 단계를 보려면 오류 유형 열에서 정보 아이콘 ( info )을 클릭합니다.
- 개별 레코드에 대해 조치를 취하려면 영향을 받는 레코드 열에서 [#] 레코드를 클릭한 다음 보기 만들기를 클릭하여 영향을 받는 레코드에 대한 필터링된 보기를 만듭니다.
- 오류를 해결했으면 연결 오류 목록으로 돌아갑니다. 해결된 오류의 왼쪽에 있는 확인란을 선택하고 다시 동기화를 클릭합니다.
- 오류를 내보내려면 오른쪽 상단의 오류 내보내기를 클릭합니다.
사용자 지정 코드
Salesforce 계정의 자동화, 플로우 또는 유효성 검사 규칙으로 인해 발생한 문제로 인해 레코드가 동기화되지 않습니다. 오류의 원인에 대한 정보가 오류 세부 정보 열에 표시됩니다.
- 오류에 대한 세부 정보 및 해결 단계를 보려면 오류 유형 열에서 정보 아이콘 ( info )을 클릭합니다.
- 오류의 세부 사항에 따라 영향을 받는 레코드를 업데이트하거나 Salesforce 설정을 변경해야 할 수도 있습니다. 영향을 받는 레코드 열에서 [#] 레코드를 클릭한 다음 보기 만들기를 클릭하여 영향을 받는 레코드의 필터링된 보기를 만들려면 HubSpot에서 개별 레코드에 대한 조치를 취합니다.
- 오류를 해결했으면 사용자 지정 코드 오류 목록으로 돌아갑니다. 해결된 오류의 왼쪽에 있는 확인란을 선택하고 다시 동기화를 클릭합니다.
- 오류를 내보내려면 오른쪽 상단의 오류 내보내기를 클릭합니다.
중복
중복된 레코드 또는 값이 이미 존재하므로 레코드를 만들 수 없습니다. 중복된 값과 함께 오류의 영향을 받는 HubSpot 및 Salesforce 레코드가 표시됩니다.
- 오류에 대한 세부 정보 및 해결 단계를 보려면 오류 유형 열에서 정보 아이콘 ( info )을 클릭합니다.
- 레코드 보기 열에서 HubSpot 또는 Salesforce를 클릭하여 레코드에 액세스하고 변경합니다.
- 오류를 해결했으면 중복 오류 목록으로 돌아갑니다. 해결된 오류의 왼쪽에 있는 확인란을 선택하고 다시 동기화를 클릭합니다.
- 오류를 내보내려면 오른쪽 상단의 오류 내보내기를 클릭합니다.
권한
연결된 사용자에게 Salesforce의 필요한 필드 또는 개체에 대한 액세스 권한이 없기 때문에 HubSpot에서 변경한 내용을 Salesforce에 동기화할 수 없습니다.
- 오류에 대한 구체적인 세부 정보 및 해결 단계를 보려면 오류 유형 열에서 정보 아이콘 info 을 클릭합니다.
- Salesforce 설정에서 연결된 사용자의 권한을 검토하고 업데이트합니다.
- 오류를 해결했으면 권한 오류 목록으로 돌아갑니다. 해결된 오류의 왼쪽에 있는 확인란을 선택하고 다시 동기화를 클릭합니다.
- 오류를 내보내려면 오른쪽 상단의 오류 내 보내기를 클릭합니다.
선택 목록
HubSpot과 Salesforce의 선택 목록 필드 값 간의 불일치로 인해 레코드가 동기화되지 않습니다. 이는 한 시스템의 선택 목록 값이 다른 시스템의 현재 값과 일치하지 않거나, 선택 목록이 값 제한에 도달했거나, 전달된 값이 유효하지 않은 경우에 발생할 수 있습니다. 각 오류에 대해 영향을 받는 레코드 수와 함께 오류의 원인이 되는 HubSpot 속성 및 Salesforce 필드가 표시됩니다.
- 오류에 대한 세부 정보 및 해결 단계를 보려면 오류 유형 열에서 정보 아이콘 ( info )을 클릭합니다.
- 오류의 세부 사항에 따라 영향을 받는 레코드의 값을 업데이트하거나 속성 또는 필드를 변경해야 할 수도 있습니다. 영향을 받는 레코드 열에서 [#] 레코드를 클릭한 다음 보기 만들기를 클릭하여 영향을 받는 레코드의 필터링된 보기를 만들려면 HubSpot에서 개별 레코드에 대한 조치를 취합니다.
- 오류를 해결했으면 선택 목록 오류 목록으로 돌아갑니다. 해결된 오류의 왼쪽에 있는 확인란을 선택하고 다시 동기화를 클릭합니다.
- 오류를 내보내려면 오른쪽 상단의 오류 내보내기를 클릭합니다.
속성 매핑
HubSpot 속성과 Salesforce 필드 간의 매핑이 일치하지 않아 레코드가 동기화되지 않습니다. 이는 속성 및 필드 유형이 호환되지 않거나, 속성 또는 필드가 더 이상 존재하지 않거나, Salesforce 참조 필드 매핑을 만들어야 함을 의미할 수 있습니다.
- 오류에 대한 자세한 내용과 해결 단계를 보려면 오류 유형 열에서 정보 아이콘 ( info )을 클릭하세요.
- 속성 매핑을 업데이트합니다.
- 오류를 해결했으면 속성 매핑 오류 목록으로 돌아갑니다. 해결된 오류의 왼쪽에 있는 확인란을 선택하고 다시 동기화를 클릭합니다.
- 오류를 내보내려면 오른쪽 상단의 오류 내보내기를 클릭합니다.
속성 값
레코드에 유효하지 않은 속성 값이 포함되어 있기 때문에 HubSpot과 Salesforce 간에 레코드가 동기화되지 않습니다. 이러한 오류는 일반적으로 영향을 받는 개별 레코드를 업데이트하여 오류를 수정해야 합니다.
- 추가 정보 및 해결 단계를 보려면 오류 유형 열에서 정보 아이콘 ( info )을 클릭하세요.
- HubSpot 또는 Salesforce에서 레코드의 유효하지 않은 값을 업데이트합니다. 영향을 받는 레코드 열에서 영향을 받는 레코드 목록을 보려면 영향을 받는 레코드 열에서 [#] 레코드를 클릭한 다음 보기 만들기를 클릭하여 필터링된 보기를 만듭니다.
- 오류를 해결했으면 속성 값 오류 목록으로 돌아갑니다. 해결된 오류의 왼쪽에 있는 확인란을 선택하고 다시 동기화를 클릭합니다.
- 오류를 내보내려면 오른쪽 상단의 오류 내보내기를 클릭합니다.
기타
알 수 없는 오류로 인해 레코드가 동기화되지 않습니다. 이러한 오류에 대한 추가 지원이 필요한 경우 HubSpot 지원팀에 문의하세요.
참고: 한 번에 100개의 Salesforce 오류를 대량으로 다시 동기화할 수 있습니다. 100개 이상의 오류를 동기화하려면 Salesforce에서 레코드를 가져오거나 매핑된 속성을 업데이트하세요.
동기화 오류 알림 설정
- HubSpot 계정에서 상단 탐색 모음에 있는 settings 설정 아이콘을 클릭합니다. 왼쪽 사이드바 메뉴에서 통합 > 연결된 앱으로 이동합니다.
- 연결된 앱 목록에서 Salesforce를 클릭합니다.
- 동기화 상태 탭을 클릭합니다.
- 동기화 오류 아래에서 알림 관리를 클릭합니다.
- 대화 상자에서 알림 켜기 스위치를 클릭하여 전환합니다.
- 즉시, 매일 또는 매주 옆의 라디오 버튼을 선택하여 알림 빈도를 설정합니다.
- 저장을 클릭합니다.