---
title: CSV로 연락처 가져오기
description: Twenty로 사람/연락처를 가져오는 포괄적인 단계별 가이드.
---
## 개요
이 가이드는 연락처(People)를 Twenty로 가져오는 과정을 단계별로 안내합니다.
## 시작하기 전에
### 사전 준비 체크리스트
파일이 CSV, XLSX 또는 XLS 형식임
파일의 레코드가 10,000개 미만임
파일에 중복된 이메일 주소가 없음
**회사를 먼저 가져옴**(사람을 회사에 연결하는 경우)
모든 사용자 정의 필드가 **Settings → Data Model**에 존재함
**사람보다 회사를 먼저 가져오기**
사람을 회사에 연결하려면 먼저 회사를 가져오세요. 참조하려면 회사가 먼저 존재해야 합니다.
## 1단계: 연락처 데이터 준비
### 필수 및 권장 필드
| 필드 | 필수? | 형식 | 노트 |
| ------------- | ----- | ----------------- | ------------------ |
| **이메일** | 권장 | `name@domain.com` | 고유해야 함 |
| **이름** | 권장 | 텍스트 | |
| **성** | 권장 | 텍스트 | |
| **회사** | 선택 사항 | 도메인 또는 ID | 기존 회사에 연결 |
| **전화** | 선택 사항 | 여러 열 | 아래 참조 |
| **직책** | 선택 사항 | 텍스트 | |
| **사용자 정의 필드** | 선택 사항 | 항목에 따라 다름 | Data Model에 존재해야 함 |
### 이메일 형식
* 유효한 이메일 형식이어야 함: `name@domain.com`
* **고유해야 함** — 파일 또는 Twenty에 중복이 없어야 합니다
* 추가 이메일은 **Emails / Additional Emails** 열을 사용하세요:
```
["jane@twenty.com","jane.doe@twenty.com"]
```
### 전화 형식
전화는 여러 열이 필요한 **중첩 필드**입니다:
| 열 | 예시 |
| --------------------------------------- | ------------ |
| **Phones / Primary Phone Number** | `4159095555` |
| **Phones / Primary Phone Country Code** | `US` |
| **Phones / Primary Phone Calling Code** | `+1` |
### 회사에 연결하기
회사 고유 식별자 열을 추가하세요:
| 열 이름 | 형식 | 예시 |
| --------------- | ------ | -------------------------------------- |
| `companyDomain` | URL 형식 | `https://acme.com` |
| `companyId` | UUID | `c776ee49-f608-4a77-8cc8-6fe96ae1e43f` |
**도메인 URL 형식을 사용하세요**(`https://acme.com`), 라벨은 사용하지 마세요. 이는 Twenty에서 회사가 저장되는 방식과 일치합니다.
### CSV 예시 구조
```csv
firstName,lastName,email,jobTitle,companyDomain,Phones / Primary Phone Number,Phones / Primary Phone Country Code
John,Smith,john@acme.com,CEO,https://acme.com,4159095555,US
Jane,Doe,jane@widgets.co,CTO,https://widgets.co,2125551234,US
```
**전문가 팁:** 가져오기 중에 **Download sample file**을 클릭하거나 기존 People 몇 명을 내보내 Twenty가 기대하는 정확한 열 이름을 확인하세요.
## 2단계: 가져오기 기능에 액세스
**옵션 1: People 보기에서**
1. 왼쪽 사이드바에서 **People**로 이동하세요
2. 오른쪽 상단의 **⋮** 아이콘을 클릭하세요
3. **Import records**를 선택하세요
**옵션 2: 커맨드 메뉴 사용**
1. `Cmd + K`(Mac) 또는 `Ctrl + K`(Windows)를 누르세요
2. "import"를 입력하세요
3. **Import records**를 선택하세요
4. **People**을 선택하세요
## 3단계: 파일 업로드
1. **Select file**을 클릭하세요
2. CSV, XLSX 또는 XLS 파일을 선택하세요
3. Twenty가 파일을 분석할 때까지 기다리세요
## 4단계: 열 매핑
Twenty가 열을 필드에 자동으로 매칭하려고 시도합니다. 검토 및 조정:
1. **자동 매핑 확인** — 올바른지 검증하세요
2. **잘못된 매핑 수정** — 드롭다운을 클릭하여 올바른 필드를 선택하세요
3. **열 건너뛰기** — 가져오지 않을 열은 **Do not map**을 선택하세요
### 중요한 매핑 규칙
| 열 유형 | 매핑 대상 | 노트 |
| ------ | ------------------------------ | ------------------------------- |
| 회사 참조 | **회사** 관계 필드 | 도메인 또는 ID 중 하나만 사용(둘 다 사용하지 않음) |
| 이메일 | **이메일** | 기본 이메일 주소 |
| 추가 이메일 | **Emails / Additional Emails** | 배열 형식 |
| 전화 | 분리된 열 | 번호, 국가 코드, 전화 걸기 코드 |
### 회사 관계 매핑
회사 열을 매핑할 때:
1. 회사 참조 열을 찾으세요(예: `companyDomain`)
2. 이를 **회사** 관계 필드에 매핑하세요
3. Twenty가 각 사람을 일치하는 회사에 연결합니다
**관계에는 고유 식별자를 하나만 매핑하세요.**
`companyId`와 `companyDomain`을 둘 다 매핑하지 마세요. 하나만 선택하세요—사람이 읽기 쉬우므로 도메인을 권장합니다.
## 5단계: 선택 필드 값 매핑
선택 또는 다중 선택 필드(예: 리드 소스)가 있는 경우:
1. Twenty에서 사용자의 값을 기존 옵션과 나란히 표시합니다
2. 파일의 각 값을 Twenty 옵션과 매칭하세요
3. 필요하면 새 옵션을 만드세요
선택 옵션은 표시 레이블이 아니라 **API 이름**을 사용합니다. API 이름을 보려면 **Settings → Data Model**에서 **Advanced mode**를 활성화하세요.
## 6단계: 오류 검토 및 수정
가져오기를 완료하기 전에 Twenty가 데이터를 검증합니다:
1. **다음 단계**를 클릭합니다
2. 오류가 있는 행은 **노란색**으로 강조 표시됩니다
3. **오류를 직접 수정** — 셀을 클릭하고 값을 편집하세요
4. **문제가 있는 행 제거** — 해당 행을 건너뛰려면 X를 클릭하세요
### 일반적인 연락처 가져오기 오류
| 오류 | 원인 | 해결책 |
| --------------- | ------------------------- | ------------------------- |
| **중복 이메일** | 이메일이 Twenty 또는 파일에 이미 존재함 | 중복을 제거하거나 기존 레코드를 업데이트하세요 |
| **잘못된 이메일 형식** | 이메일 형식이 올바르지 않음 | `name@domain.com`으로 수정하세요 |
| **관계를 찾을 수 없음** | 회사가 존재하지 않음 | 먼저 회사를 가져오거나 참조를 수정하세요 |
| **필수 필드 누락** | 필수 필드가 비어 있음 | 값을 입력하거나 해당 행을 제거하세요 |
## 7단계: 가져오기 완료
1. 가져오기 요약을 검토하세요
2. 가져오려면 **확인**을 클릭합니다
3. 가져오기가 완료될 때까지 기다리세요
4. 몇 개의 레코드와 해당 회사 링크를 확인하여 검증하세요
## 연락처 가져오기 후
이제 연락처가 Twenty에 있습니다! 다음 단계:
1. **회사 링크 확인** — 올바른 회사에 연결되어 있는지 확인하려면 몇 개의 연락처 레코드를 여세요
2. **기회 가져오기** — 필요한 경우 연락처 및 회사에 연결하세요
3. **이메일 동기화 설정** — 연락처 레코드에서 이메일 내역을 볼 수 있도록 메일박스를 연결하세요
## 기존 연락처 업데이트
새로 생성하는 대신 연락처를 업데이트하려면:
1. 파일에 `email` 또는 `id` 열을 포함하세요
2. Twenty는 이 고유 식별자로 레코드를 매칭합니다
3. 기존 연락처는 업데이트되고, 새 연락처는 생성됩니다
자세한 내용은 [기존 레코드를 업데이트하는 방법](/l/ko/user-guide/data-migration/how-tos/update-existing-records-via-import)을 참조하세요.
## FAQ
이메일은 Twenty에서 고유 식별자입니다. 이는 중복 연락처를 방지하고 이메일 동기화가 올바른 연락처에 이메일을 정확히 연결되도록 보장합니다.
이메일을 비워둘 수 있습니다. 하지만 데이터 품질과 이메일 동기화 기능을 위해 가능하면 이메일을 추가할 것을 권장합니다.
회사의 도메인(예: `https://acme.com`) 또는 ID가 포함된 열을 추가하세요. 매핑 중에 이 열을 회사 관계 필드에 연결하세요.
먼저 회사를 가져오고, 그다음 연락처를 가져오세요. 참조하려면 해당 회사가 먼저 존재해야 합니다.
예! 외부 ID를 저장하려면 데이터 모델에 "unique"로 표시된 사용자 지정 필드를 만드세요. 참고: 필드 이름 `id`는 Twenty의 내부 ID로 예약되어 있습니다.
참조하려는 회사가 존재하지 않습니다. 회사를 먼저 가져오거나, 도메인/ID가 기존 회사와 정확히 일치하는지 확인하세요.
## 문제 해결
문제가 있으신가요? 확인하세요:
* [가져오기 오류 수정](/l/ko/user-guide/data-migration/how-tos/fix-import-errors)
* [관계 가져오기 방법](/l/ko/user-guide/data-migration/how-tos/import-relations-between-objects-via-csv)
* [필드 매핑 레퍼런스](/l/ko/user-guide/data-migration/capabilities/field-mapping)