# CSV로 CRM에 연락처 가져오기, 최대 10,000행 | AiCrm

> AiCrm에 CSV를 올리세요. 구분자와 열(이름, 이메일, 전화번호, 회사, 국가, 태그)을 자동 감지하고, 100건씩 진행률과 함께 가져오며, 중단돼도 중복 없이 이어서 해요. 오류 CSV로 수정 후 재시도할 수 있어요.

- **출처 (source):** https://aistohire.com/ko/aicrm-api-gyeongnyang-crm-109/f/yeonlakcheo-csv-gajyeoogi
- **플랫폼 (platform):** AIstoHire
- **언어 (language):** ko

## 요약

- CSV로 연락처를 가져오세요. 밤새울 필요 없어요
- 파일당 최대 10,000행, 구분자와 열은 자동으로 감지해요. 가져오기가 중간에 끊겨도 멈춘 곳부터 이어서 하므로 중복은 생기지 않아요.
- 파일을 미리 손볼 필요가 없어요. 구분자(쉼표, 세미콜론, 탭), BOM, 따옴표, 셀 안의 줄바꿈, 인코딩은 업로드할 때 AiCrm이 알아서 처리해요.
- 열이 미리 매핑되어 있어요. AiCrm이 헤더 이름으로 열을 인식하고, 인식하지 못하면 데이터의 형태로 판단해요. 확인하고 필요한 부분만 고치면 돼요.
- 제대로 이어서 할 수 있어요. 지속형 커서가 100행마다 진행 위치를 저장하므로, 중간에 끊긴 가져오기도 멈춘 바로 그 행부터 다시 시작해요. 이미 처리한 행을 다시 처리하거나 중복으로 넣지 않아요.

## CSV로 연락처를 가져오세요. 밤새울 필요 없어요

CSV를 올리면 AiCrm이 먼저 힘든 작업을 대신 처리해요. 첫 줄을 보고 파일이 쉼표, 세미콜론, 탭 중 무엇으로 구분되어 있는지 파악하고, 일부 프로그램이 남기는 BOM을 제거하며, 큰따옴표와 셀 안의 줄바꿈도 이해해요. 파일이 UTF-8이 아니면 latin1로 다시 시도해서 ñ과 악센트 문자가 깨지지 않게 하고요. 가져오기 한 번에 최대 10,000행, 파일 크기는 최대 50MB까지 지원해요.

그다음 열 매핑을 알아서 제안해요. 스페인어와 영어로 흔히 쓰는 헤더(nombre, name, contacto, email, correo, tel, móvil, celular, empresa, organización, país, country, notas, estado, tags, etiquetas)를 인식하고, 헤더만으로 알 수 없을 때는 데이터 자체를 살펴봐요. 셀에 @가 있으면 이메일로, 전화번호처럼 보이면 전화번호로 처리해요. 각 열 옆에 처음 다섯 행을 보여 주므로 제대로 맞았는지 한눈에 확인할 수 있고, 어떤 열이든 다른 필드로 바꾸거나 '무시'로 지정할 수 있어요.

가져오기는 100행 단위로 처리되고, 마지막으로 완료한 행의 커서를 저장해요. 이 커서 덕분에 이어서 진행할 수 있어요. 탭을 닫거나, 와이파이가 끊기거나, 휴대폰이 절전 모드로 들어가도 가져오기는 기록에 '진행 중'으로 남고 재개 버튼이 표시돼요. 누르면 마지막으로 처리한 행의 바로 다음 행부터 이어서 진행해요. 커서가 이미 앞으로 나아가 있으므로 같은 행이 반복되지 않아요.

끝나면 생성, 업데이트, 오류 건수를 알려 주고, 가져온 연락처마다 'importacion-YYYY-MM-DD' 태그와 옵션에서 직접 추가한 태그를 붙여요. 그래서 언제든 그 묶음 전체를 필터링해서 볼 수 있어요. 실패한 행이 있으면 행 번호, 사유, 원본 데이터가 담긴 CSV를 내려받아 스프레드시트에서 고친 뒤 그 부분만 다시 올리면 돼요.

## 포함된 내용

- 파일을 미리 손볼 필요가 없어요. 구분자(쉼표, 세미콜론, 탭), BOM, 따옴표, 셀 안의 줄바꿈, 인코딩은 업로드할 때 AiCrm이 알아서 처리해요.
- 열이 미리 매핑되어 있어요. AiCrm이 헤더 이름으로 열을 인식하고, 인식하지 못하면 데이터의 형태로 판단해요. 확인하고 필요한 부분만 고치면 돼요.
- 제대로 이어서 할 수 있어요. 지속형 커서가 100행마다 진행 위치를 저장하므로, 중간에 끊긴 가져오기도 멈춘 바로 그 행부터 다시 시작해요. 이미 처리한 행을 다시 처리하거나 중복으로 넣지 않아요.
- 이미 가진 연락처를 어떻게 할지 직접 정해요. 기본적으로 이메일이 이미 DB에 있는 행은 건너뛰고 중복으로 기록해요. '기존 연락처 업데이트'를 선택하면 해당 행이 기존 카드를 보완하되, 이메일과 상태는 건드리지 않고 빈 셀 때문에 데이터가 지워지는 일도 없어요.
- 가져온 묶음마다 'importacion-YYYY-MM-DD' 태그가 붙고, 시작하기 전에 원하는 태그를 추가할 수도 있어요. 나중에 '화요일에 올린 800명'처럼 골라 볼 수 있어요.
- 잘못된 행 때문에 가져오기가 중단되지 않아요. 이름 비어 있음, 잘못된 이메일, 중복 이메일 같은 사유와 함께 건너뛰고, 행 번호, 사유, 데이터가 담긴 오류 CSV를 받아 고친 뒤 그 행들만 다시 시도할 수 있어요.
- 진행 상황을 실시간으로 확인해요. 진행 막대와 'X/Y 처리 중' 표시가 나오고, 끝나면 생성, 업데이트, 실패 건수가 표시돼요. 기록에는 최근 가져오기 내역과 결과가 저장돼요.
- 연락처가 빠짐없이 들어와요. 이름, 이메일, 전화번호, 회사, 국가, 메모, 상태, 태그가 모두 들어가고, 등록된 건마다 고객 타임라인에 'CSV 가져오기로 등록' 기록이 남아요.

## 자주 묻는 질문

### 한 번에 몇 개의 연락처를 가져올 수 있나요?

파일당 최대 10,000행, 50MB까지예요. 목록이 더 크다면 여러 개의 CSV로 나눠 주세요. 각 가져오기는 기록에 자체 건수와 날짜 태그와 함께 따로 남으므로, 어느 묶음이 어느 것인지 놓치지 않아요.

### 가져오기가 도중에 끊기면 어떻게 되나요?

큰 문제는 없어요. AiCrm은 파일을 100행 단위로 처리하고 마지막으로 완료한 행의 커서를 저장해요. 그래서 가져오기는 기록에 '진행 중'으로 남고 재개 버튼이 표시돼요. 버튼을 누르면 마지막으로 처리한 행의 다음 행부터 이어서 진행해요. 이미 가져온 행은 다시 건드리지 않고, 중복 연락처도 만들어지지 않아요.

### CSV는 특정 형식이어야 하나요?

미리 준비할 필요는 없어요. AiCrm이 첫 줄을 보고 구분자가 쉼표인지, 세미콜론인지, 탭인지 감지해요. BOM은 제거하고, 큰따옴표와 셀 안의 줄바꿈도 올바르게 처리해요. 파일이 UTF-8이 아니면 latin1로 다시 시도해서 악센트 문자가 깨지지 않게 해요. 다만 첫 행을 헤더로 두는 것이 좋아요. 매핑을 추측할 때 그 행을 활용하기 때문이에요.

### 어떤 열이 무엇인지 제가 직접 알려 줘야 하나요?

확인만 하면 돼요. AiCrm이 스페인어와 영어로 흔히 쓰는 헤더(nombre, name, email, correo, tel, móvil, empresa, país, notas, estado, etiquetas)를 인식해서 매핑을 제안하고, 헤더로 알 수 없을 때는 데이터 자체로 필드를 추론해요. @가 들어 있는 셀은 이메일, 전화번호처럼 보이는 셀은 전화번호로 판단하는 식이에요. 매핑 화면에서는 각 열의 실제 예시를 볼 수 있고, 열을 바꾸거나 '무시'로 지정할 수 있어요. 이름이나 이메일 중 하나만 매핑해도 시작할 수 있어요.

### 이미 있는 연락처와 실패한 행은 어떻게 처리되나요?

이메일로 비교해요. 기본적으로 이메일이 이미 DB에 있으면 그 행은 건너뛰고 중복으로 기록해요. '이메일이 같으면 기존 연락처 업데이트' 옵션을 선택하면, 그 행이 기존 카드를 보완하고(이메일과 상태는 바꾸지 않고, 빈 셀로 데이터를 지우지도 않아요) 태그를 합쳐요. 이름이 비었거나 이메일이 잘못된 행은 작업을 멈추지 않고 건너뛰고, 끝나면 행 번호, 사유, 각 행의 원본 데이터가 담긴 CSV를 내려받아 고친 뒤 그 행들만 다시 올릴 수 있어요.

- [AiCrm — 어떤 시스템에서든 고객을 등록하는 API 기반 경량 CRM](https://aistohire.com/ko/aicrm-api-gyeongnyang-crm-109)

## 플랫폼 소개

**AiCrm — 어떤 시스템에서든 고객을 등록하는 API 기반 경량 CRM** — 앱 개발: AIstoHire. 이용 가능 위치:: https://aistohire.com/ko/aicrm-api-gyeongnyang-crm-109/f/yeonlakcheo-csv-gajyeoogi

### 다른 언어

- `es`: https://aistohire.com/es/aicrm-crm-ligero-con-api-109/f/importar-contactos-desde-csv
- `en`: https://aistohire.com/aicrm-lightweight-crm-with-api-109/f/import-contacts-from-csv
- `fr`: https://aistohire.com/fr/aicrm-crm-leger-avec-api-109/f/importer-contacts-depuis-csv
- `it`: https://aistohire.com/it/aicrm-crm-leggero-con-api-109/f/importare-contatti-da-csv
- `pt`: https://aistohire.com/pt/aicrm-crm-leve-com-api-109/f/importar-contatos-de-csv
- `de`: https://aistohire.com/de/aicrm-leichtes-crm-mit-api-109/f/kontakte-aus-csv-importieren
- `bg`: https://aistohire.com/bg/aicrm-lesen-crm-s-api-za-upravlenie-na-klienti-i-liydove-109/f/importirane-na-kontakti-ot-csv
- `ja`: https://aistohire.com/ja/aicrm-lightweight-crm-with-api-109/f/import-contacts-from-csv
- `nl`: https://aistohire.com/nl/aicrm-eenvoudige-crm-met-api-om-klanten-en-leads-te-beheren-109/f/contacten-importeren-uit-csv
- `sv`: https://aistohire.com/sv/aicrm-enkelt-crm-med-api-for-att-hantera-kunder-och-leads-109/f/importera-kontakter-fran-csv
- `da`: https://aistohire.com/da/aicrm-enkelt-crm-med-api-til-at-styre-kunder-og-leads-109/f/importer-kontakter-fra-csv
- `ar`: https://aistohire.com/ar/aicrm-nzam-crm-bsit-ma-api-lidara-alamla-walamla-almhtmlin-109/f/istirad-jihat-ittisal-min-csv
- `no`: https://aistohire.com/no/aicrm-enkelt-crm-med-api-for-a-styre-kunder-og-leads-109/f/importer-kontakter-fra-csv
- `fi`: https://aistohire.com/fi/aicrm-yksinkertainen-crm-rajapinnalla-asiakkaille-ja-liideille-109/f/tuo-kontaktit-csv-tiedostosta
- `zh`: https://aistohire.com/zh/ai-crm-rest-api-webhooks-109/f/daoru-lianluoren-csv-crm
- `pl`: https://aistohire.com/pl/aicrm-prosty-crm-z-api-do-zarzadzania-klientami-i-leadami-109/f/import-kontaktow-z-csv
- `he`: https://aistohire.com/he/aicrm-crm-pshot-am-api-lnihol-lkochot-vlidim-109/f/yevu-anshei-kesher-mi-csv
- `cs`: https://aistohire.com/cs/aicrm-jednoduche-crm-s-api-pro-spravu-klientu-a-leadu-109/f/importovat-kontakty-z-csv
- `id`: https://aistohire.com/id/aicrm-crm-sederhana-dengan-api-untuk-mengelola-pelanggan-dan-lead-109/f/impor-kontak-dari-csv
