# CSV 대량 가져오기 문제 해결 이 가이드는 CSV 파일을 통해 연락처를 가져올 때 발생할 수 있는 오류를 해결하는 데 도움을 드립니다. 각 오류 코드에는 구체적인 원인과 해결 방법이 있습니다. 이를 이해하면 깔끔하고 원활하며 성공적인 대량 가져오기를 수행할 수 있습니다. *** **목차** * [대량 가져오기란 무엇인가요?](#대량-가져오기란-무엇인가요) * [성공적인 CSV 가져오기의 주요 장점](#성공적인-csv-가져오기의-주요-장점) * [CSV 가져오기 문제 해결 체크리스트](#csv-가져오기-문제-해결-체크리스트) * [대량 가져오기 오류 코드 마스터 목록](#대량-가져오기-오류-코드-마스터-목록) * [자주 묻는 질문](#자주-묻는-질문) *** ## 대량 가져오기란 무엇인가요? 대량 가져오기를 사용하면 CSV 파일을 통해 대량의 연락처 데이터를 빠르게 업로드할 수 있습니다. 온보딩, 리드 마이그레이션, 목록 동기화에 유용한 강력한 도구이지만, 형식 오류로 인해 진행이 차단될 수 있습니다. 이 가이드는 그러한 오류를 해결하는 데 도움이 됩니다. 다음 동영상은 특정 연락처 가져오기 일괄 작업과 연결된 오류 로그로 이동하는 방법과 오류를 해결하기 위해 작업하는 방법을 다룹니다: *** ## **성공적인 CSV 가져오기의 주요 장점** 대량 가져오기 문제 해결을 마스터하면 시간을 절약하고 좌절감을 줄일 수 있습니다. 이것이 중요한 이유는 다음과 같습니다: * 재작업을 줄여 시간 절약 * 중복되거나 충돌하는 연락처 레코드 생성 방지 * 깔끔하고 검증된 연락처 데이터 유지 * 워크플로우 자동화를 차단하는 가져오기 실패 방지 * 정확한 소유자/사용자 배정 보장 * 캠페인 개인화 및 태그 보존 *** ## **CSV 가져오기 문제 해결 체크리스트** 일반적인 CSV 오류를 방지하기 위해 가져오기 전에 이 체크리스트를 사용하세요: * 파일에 하나의 시트만 포함 * 모든 필수 필드가 채워져 있고 올바르게 형식화되었는지 확인 * 이메일, 전화번호, 날짜를 올바르게 형식화 * 각 행에 고유한 연락처 ID 사용 * 열거형/드롭다운 값이 정확히 일치하는지 확인 * 소유자 열에 유효한 하이퍼클래스 사용자 이메일 사용 * 신뢰할 수 있는 기본 열 선택(이메일 또는 연락처 ID 등) *** ## 대량 가져오기 오류 코드 마스터 목록 | 마스터 유형 | 오류 ID (선택사항) | 오류 코드 | 오류의 의미 | 오류 해결 단계 | | ----------------------- | ------------ | ------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 스프레드시트에 값을 배치할 때의 형식 오류 | 1001 | Unknown error | 하이퍼클래스가 알 수 없는 오류로 인해 파일을 처리할 수 없습니다. 데이터가 가져오기되지 않았습니다. | 파일이 모든 요구사항을 충족하는지 확인하세요. 브라우저 캐시를 지우거나 다른 브라우저를 사용한 후 다시 가져오기를 시도하세요. | | | 1002 | Multiple owners found in HL | 가져오기 파일에 계정의 둘 이상의 사용자와 일치하는 소유자 값이 포함되어 있습니다. 이는 일반적으로 이름에 대해 발생합니다(예: 하이퍼클래스 계정에 John Doe 사용자가 두 명 있고, 가져오기 파일에 "John Doe"라는 이름이 포함된 경우). 해당 레코드는 가져오기되었지만 소유자 속성에는 값이 포함되지 않습니다. | 가져오기 파일에서 소유자 이름을 이메일 주소로 바꾼 다음 파일을 다시 가져오세요. 해당 레코드의 소유자 속성 값을 수동으로 업데이트할 수도 있습니다. | | | 1003 | Invalid sheet count | 가져오기 파일에 둘 이상의 시트가 포함되어 있습니다. 데이터가 가져오기되지 않았습니다. | 가져오기 파일에서 추가 시트를 제거한 다음 다시 가져오세요. 하이퍼클래스로 가져오기 위한 추가 파일 요구사항을 검토하세요. | | | 1004 | Invalid required property | 가져오기 파일의 필수 속성에 잘못된 값이 포함되어 있습니다. 해당 행의 데이터가 가져오기되지 않았습니다. | 특정 속성 또는 속성 유형의 형식 요구사항을 확인하고, 올바른 형식과 일치하도록 파일을 업데이트한 다음 다시 가져오세요. | | | 1005 | Invalid enumeration option | 가져오기 파일에 열거형 속성의 기존 옵션과 일치하지 않는 값이 포함되어 있습니다. 이는 다중 선택, 드롭다운 선택, 라디오 선택, 체크박스 유형 속성에 적용됩니다. 해당 레코드는 여전히 가져오기되었지만 열거형 속성에는 값이 포함되지 않습니다. | 하이퍼클래스의 속성과 가져오기 파일을 비교하여 잘못된 값을 식별하세요. 가져오기 파일의 값을 기존 옵션과 일치하도록 업데이트하거나 해당 값을 속성에 커스텀 옵션으로 추가할 수 있습니다. 완료한 후 파일을 다시 가져오거나 해당 레코드의 속성 값을 수동으로 업데이트하세요. | | | 1006 | Invalid contact ID | 가져오기 중에 연락처 ID를 사용하여 기존 레코드를 업데이트하는 체크박스가 선택되었습니다. 그러나 파일에 나열된 연락처 ID가 하이퍼클래스의 기존 ID와 일치하지 않습니다. 레코드가 가져오기되지 않았습니다. | \[객체] ID가 올바른지 확인하세요. 올바른 객체 ID를 얻으려면 기존 레코드를 내보내기해야 할 수도 있습니다. 하이퍼클래스에서 기존 객체를 업데이트하거나 연결하지 않는 경우 가져오기 프로세스 중에 체크박스를 선택하지 마세요. | | | 1007 | File not found | 선택한 파일을 찾을 수 없습니다. 데이터가 가져오기되지 않았습니다. | 파일을 컴퓨터에 저장했고 올바른 파일 유형인지 확인하세요. 완료한 후 파일을 다시 업로드하세요. | | HL/파일의 중복 항목 | 1008 | Failed validation of Email | 가져오기 파일에 일반적인 이메일 주소 형식(예: )에 맞지 않는 이메일 주소가 포함되어 있습니다. 가져오기가 레코드를 생성하거나 업데이트하지 않았습니다. | 연락처의 경우 가져오기 파일을 올바른 이메일로 업데이트하고, '@' '.com' 형식이 올바른지 확인한 다음 파일을 다시 가져오세요. | | | 1009 | Empty unique property value in the file | 가져오기 파일에 고유 식별자(기본 열)의 레코드에 대한 값이 없어 처리할 수 없는 데이터가 있는 행이 포함되어 있습니다. | 데이터 값이 가져오는 속성에 대한 올바른 형식과 일치하는지 확인한 다음 파일을 다시 가져오세요. 해당 레코드의 속성 값을 수동으로 업데이트할 수도 있습니다. | | | 1010 | Duplicate unique property value in the HL | 기본 열의 동일한 값이 여러 레코드에 대해 존재합니다. 데이터는 모든 HL 레코드에 대해 가져오기되었지만 하이퍼클래스에 동일한 레코드의 중복이 있을 수 있습니다. | 기본 열 역할을 할 다른 열 헤더를 선택하거나 실수를 수정한 다음 파일을 다시 가져오세요. | | | 1011 | Duplicate unique property value in the file | 파일 내에서 동일한 고유 값이 여러 번 사용되었습니다. 데이터는 가져오기되었지만 하이퍼클래스에 동일한 레코드의 중복이 있을 수 있습니다. 연결을 시도한 경우 레코드가 연결되지 않았습니다. | 고유 값 역할을 할 다른 열 헤더를 선택하거나 실수를 수정한 다음 파일을 다시 가져오세요. | | | 1012 | Duplicate Contact ID in the file | 파일 내에서 동일한 연락처 ID가 여러 번 사용되었습니다. 해당 레코드가 하이퍼클래스에서 업데이트되거나 연결되지 않았습니다. | 해당 연락처 ID가 있는 행이 하나만 있도록 가져오기 파일을 업데이트하세요. 하이퍼클래스에 포함하려는 가장 최신 정보가 있는 행을 유지하세요. 중복을 제거한 후 파일을 다시 가져오세요. | | 기타 | 1013 | Could not parse the phone number | 가져오기 파일에 숫자가 아닌 문자 또는 E.164 형식에 따라 형식화되지 않은 숫자가 있는 번호 속성에 대한 값이 포함되어 있습니다. 해당 레코드는 가져오기되었지만 번호 속성에는 값이 포함되지 않습니다. | 가져오기 파일을 올바른 숫자 값으로 업데이트하여 다시 가져오거나, 해당 레코드의 속성 값을 수동으로 업데이트하세요. 레코드가 숫자 필드와 일치해야 하는 경우 여러 체크박스 속성에 데이터를 올바르게 가져오도록 파일을 형식화하는 방법을 알아보세요 - [더 알아보기](/hyperclass-docs/contacts/workflow-adding-and-removing-followers-for-contacts/troubleshooting-contact-import-errors.md)-,Phone%20Number,-For%20the%20vast) | | | 1014 | Could not parse the date | 가져오기 파일에 가져오기 프로세스 중에 선택한 형식과 일치하지 않는 날짜 값이 포함되어 있습니다. 해당 레코드는 가져오기되었지만 날짜 속성에는 값이 포함되지 않습니다. | 가져오기 파일을 올바른 값으로 업데이트하여 다시 가져오거나, 해당 레코드의 속성 값을 수동으로 업데이트하세요. 레코드가 날짜 필드와 일치해야 하는 경우 여러 체크박스 속성에 데이터를 올바르게 가져오도록 파일을 형식화하는 방법을 알아보세요 - [더 알아보기](/hyperclass-docs/contacts/workflow-adding-and-removing-followers-for-contacts/troubleshooting-contact-import-errors.md) | | | 1015 | Could not find the owner | 가져오기 파일에 하이퍼클래스의 사용자와 일치하지 않는 레코드 소유자가 포함되어 있습니다. 해당 레코드는 가져오기되었지만 소유자 필드에는 값이 포함되지 않습니다. | 가져오기 파일의 소유자 열에 있는 데이터를 계정의 사용자 이름과 성 또는 이메일을 포함하도록 업데이트하세요. 레코드를 할당하려는 사람이 아직 계정의 사용자가 아닌 경우 사용자로 추가한 다음 계정에 표시되는 이름 또는 이메일로 다시 가져오세요. 레코드가 연락처 소유자와 일치해야 하는 경우 여러 체크박스 속성에 데이터를 올바르게 가져오도록 파일을 형식화하는 방법을 알아보세요 - [더 알아보기](/hyperclass-docs/contacts/workflow-adding-and-removing-followers-for-contacts/troubleshooting-contact-import-errors.md) | | | 1016 | Ambiguous enumeration option in HL | 동일한 레코드가 열거형 속성에 대해 정의된 기존 옵션 중 둘 이상과 일치합니다. 이는 다중 선택, 드롭다운 선택, 단일 선택, 체크박스 유형 속성에 적용됩니다. 해당 레코드는 가져오기되었지만 열거형 속성에는 값이 포함되지 않습니다. | 하이퍼클래스의 속성과 가져오기 파일을 비교하여 잘못된 값을 식별하세요. 가져오기 파일의 값을 하나의 기존 옵션과만 일치하도록 업데이트한 다음 파일을 다시 가져오세요. 해당 레코드의 속성 값을 수동으로 업데이트할 수도 있습니다. 레코드가 여러 옵션과 일치해야 하는 경우 여러 체크박스 속성에 데이터를 올바르게 가져오도록 파일을 형식화하는 방법을 알아보세요 - [더 알아보기](/hyperclass-docs/contacts/workflow-adding-and-removing-followers-for-contacts/troubleshooting-contact-import-errors.md) | *** ## 자주 묻는 질문 **Q: 어떤 파일 형식을 업로드해야 하나요?** .csv 파일만 허용됩니다. Excel이나 Google Sheets에서 작업하는 경우 먼저 데이터를 CSV 파일로 내보내세요. **Q: 대량 가져오기를 취소할 수 있나요?** 직접적인 "취소" 옵션은 없지만 업로드 중에 가져온 연락처에 태그를 지정할 수 있습니다. 필요한 경우 해당 태그를 사용하여 필터링하고 삭제하세요. **Q: 가져오기 파일의 최대 크기는 얼마인가요?** 한도는 20MB 또는 10,000행 중 먼저 도달하는 것입니다. **Q: 업로드하기 전에 전화번호를 검증하려면 어떻게 해야 하나요?** 스프레드시트 수식이나 온라인 도구를 사용하여 E.164 형식을 따르는지 확인하세요. **Q: 기본 열로 무엇을 선택해야 하나요?** 여러 연락처에서 반복되지 않는 이메일이나 연락처 ID와 같은 고유 식별자를 사용하세요. **Q: 내 CSV 목록이 혼합되어 있습니다. 일부 연락처는 이메일이나 전화번호만 있고, 일부는 이메일과 전화번호를 모두 가지고 있습니다. 어떻게 진행해야 하나요?** 혼합된 CSV에 대해서는 '보조 기본설정' 옵션을 사용하세요. 시스템은 첫 번째 기본설정을 검색한 다음 첫 번째를 찾을 수 없는 경우 두 번째를 검색합니다. 위 예에서 첫 번째 기본설정은 '이메일'이고 두 번째는 '전화번호'입니다. 이제 보조 필드를 기반으로 기존 연락처를 찾을 수 있으므로 연락처 레코드에 전화번호만 있는 경우에도 업로드할 수 있습니다! ![](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155045601330/original/4zlCOqVjoq6LY8PnLxg6pZjqPyAfvDWsNg.png?1745499014) **Q: 내 연락처 중 일부는 여러 개의 이메일이나 전화번호를 가지고 있습니다. 어떻게 진행해야 하나요?** 연락처에 여러 전화번호나 이메일이 있는 경우 업로드할 수 있도록 연락처를 여러 개로 분할하세요. 예: **두 개의 전화번호 열이 있는 원본:** Josephine 810-292-9388 810-374-9840 **업로드용으로 정리된 버전:** Josephine 810-292-9388 Josephine 810-374-9840 전화번호를 고유 필드로 사용하여 연락처를 업로드할 때 중복이 생성되므로 다른 전화번호가 있는 두 번째 리드의 이메일은 공백으로 두세요. **Q: Keap를 사용하는 사람들을 위한 중요 참고사항:** Keap의 CSV 내보내기에서 나오는 전화번호 필드는 GHL과 호환되지 않습니다. 괄호 '()'와 대시 '-'로 인해 호환되지 않습니다. CSV 파일에서 전체 열을 강조 표시하고 숫자로 되어 있는지 확인하며, 괄호와 대시를 모두 제거한 다음 CRM의 데이터를 손상시키지 않고 가져올 수 있습니다. **Q: 전화번호를 가져올 때 오류 코드 1007 '잘못된 필수 속성'이 발생합니다:** 하위 계정 국가 외부의 번호를 가져올 때 국가 코드를 추가하세요. 하위 계정 국가가 미국으로 설정된 경우 가져온 전화번호에 +1(미국 국가 코드)을 추가할 필요가 없습니다. 하지만 미국 외부의 번호를 가져오는 경우 [국가 코드](https://countrycode.org/)를 추가해야 합니다. 예를 들어, 비즈니스 위치가 미국으로 설정된 하위 계정은 영국으로 전화하려면 '+44'를 추가해야 합니다. 하위 계정의 국가가 미국이 아닌 다른 국가(영국, 호주 등)로 설정된 경우 미국 번호로 전화/SMS를 보내려면 CSV 파일의 국가 지역 코드에 '+1'을 추가해야 합니다. **Q: DND 열이 있는 CSV를 가져오려고 하는데 모든 연락처가 모든 채널에 대해 DND로 설정됩니다.** CSV에 DND 열이 있는 연락처를 가져올 때 연락처는 모든 채널에 대해 DND가 됩니다. 특정 채널에 대해 DND하려면 먼저 워크플로우를 설정하고 각 채널에 대해 태그를 사용하세요. 예: John을 SMS에 대해서만 DND하고 싶습니다. 'DND SMS' 태그가 추가될 때 연락처를 DND하는 워크플로우를 만들 것입니다. 이제 CSV에서 John의 이름 옆에 'DND SMS' 태그를 추가할 것입니다. 가져올 때 이것은 John을 SMS에 대해서만 DND하는 자동화를 실행할 것입니다. **Q: 메모가 있는 CSV를 가져오려고 하는데 연락처 레코드당 하나 이상의 메모를 생성할 수 없습니다.** 연락처 메모를 가져올 때 연락처 레코드당 하나의 메모만 가질 수 있으며 5000자 제한이 있습니다. 하나 이상의 메모가 있거나 허용된 양보다 많은 문자가 있는 경우 [대형 텍스트 커스텀 필드](https://github.com/benjaminhyperclass/hyperclass-help-ko/blob/main/docs/23-레거시-자동화/Logic-&-Fulfillment/how-to-use-custom-fields.md)를 사용하세요. **Q: 메모가 있는 CSV를 내보내려고 합니다.** 현재 메모에 대한 CSV 가져오기 제한은 없으며, 현재 내보내기 동작에 따르면 마지막 메모에 대해 최대 255자를 지원합니다. *** *원문 최종 수정: Thu, 24 Apr, 2025 at 7:58 AM* *Hyperclass 사용 가이드 — hyperclass.ai* --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://hyperclass.gitbook.io/hyperclass-docs/contacts/workflow-adding-and-removing-followers-for-contacts/troubleshooting-bulk-imports-via-csv.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.