메인 콘텐츠로 건너뛰기

​
개요

이 가이드는 연락처(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 Number4159095555
Phones / Primary Phone Country CodeUS
Phones / Primary Phone Calling Code+1

​
회사에 연결하기

회사 고유 식별자 열을 추가하세요:
열 이름형식예시
companyDomainURL 형식https://acme.com
companyIdUUIDc776ee49-f608-4a77-8cc8-6fe96ae1e43f
도메인 URL 형식을 사용하세요(https://acme.com), 라벨은 사용하지 마세요. 이는 Twenty에서 회사가 저장되는 방식과 일치합니다.

​
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. 기존 연락처는 업데이트되고, 새 연락처는 생성됩니다
자세한 내용은 기존 레코드를 업데이트하는 방법을 참조하세요.

​
FAQ

이메일은 Twenty에서 고유 식별자입니다. 이는 중복 연락처를 방지하고 이메일 동기화가 올바른 연락처에 이메일을 정확히 연결되도록 보장합니다.
이메일을 비워둘 수 있습니다. 하지만 데이터 품질과 이메일 동기화 기능을 위해 가능하면 이메일을 추가할 것을 권장합니다.
회사의 도메인(예: https://acme.com) 또는 ID가 포함된 열을 추가하세요. 매핑 중에 이 열을 회사 관계 필드에 연결하세요.
먼저 회사를 가져오고, 그다음 연락처를 가져오세요. 참조하려면 해당 회사가 먼저 존재해야 합니다.
예! 외부 ID를 저장하려면 데이터 모델에 “unique”로 표시된 사용자 지정 필드를 만드세요. 참고: 필드 이름 id는 Twenty의 내부 ID로 예약되어 있습니다.
참조하려는 회사가 존재하지 않습니다. 회사를 먼저 가져오거나, 도메인/ID가 기존 회사와 정확히 일치하는지 확인하세요.

​
문제 해결

문제가 있으신가요? 확인하세요: