> ## Documentation Index
> Fetch the complete documentation index at: https://docs.get-clara.tech/llms.txt
> Use this file to discover all available pages before exploring further.

# 다른 CRM에서 마이그레이션하기

> 어떤 CRM에서든 데이터를 Twenty로 마이그레이션하는 단계별 가이드.

## 개요

이 가이드는 어떤 CRM에서든 데이터를 Twenty로 마이그레이션하는 과정을 단계별로 안내합니다. 이 과정에는 데이터 감사, Twenty 워크스페이스 준비, 현재 시스템에서의 내보내기, Twenty로의 가져오기가 포함됩니다.

<Note>마이그레이션 후에는 뷰, 워크플로우, 권한을 수동으로 다시 만들어야 합니다. 이 구성 작업에 필요한 시간을 계획하세요.</Note>

## 1단계: 현재 데이터 감사

마이그레이션은 새롭게 시작할 수 있는 기회입니다. 불필요한 데이터는 가져오지 마세요.

**유지할 항목:**

* 활성 연락처 및 회사
* 열려 있는 기회와 거래
* 중요한 메모와 활동
* 실제로 사용하는 사용자 정의 필드

**남겨둘 항목:**

* 오래된 연락처(2년 이상 활동 없음)
* 중복 레코드
* 테스트 데이터
* 사용하지 않는 사용자 정의 필드

## 2단계: 데이터 모델 매핑

현재 CRM과 Twenty 간의 매핑 문서를 만드세요:

| 현재 CRM    | Twenty           |
| --------- | ---------------- |
| 계정 / 조직   | **회사**           |
| 연락처 / 개인  | **사람들**          |
| 거래 / 기회   | **기회**           |
| 활동        | **작업** 또는 **노트** |
| 사용자 지정 개체 | **사용자 지정 개체**    |

**각 필드에 대해 다음을 문서화합니다:**

* 원본 필드 이름
* 대상 Twenty 필드
* 필요한 형식 변환(날짜, 전화번호 등)

<Note>가져오기 중에 이 매핑 문서를 가까이 두세요—열을 매핑할 때 참고하게 됩니다.</Note>

## 3단계: Twenty 워크스페이스 설정

데이터를 가져오기 전에 Twenty 워크스페이스를 준비하세요:

### 사용자 지정 개체 및 필드 만들기

1. **설정 → 데이터 모델**로 이동
2. 필요한 사용자 지정 개체를 생성하세요
3. 표준 개체와 사용자 지정 개체에 사용자 지정 필드를 추가하세요
4. 필드 설정(고유, 필수, 선택 옵션 등)을 구성하세요

<Warning>
  **가져오기 전에 필드가 존재해야 합니다.**

  CSV 가져오기는 필드가 아니라 레코드를 생성합니다. 가져오기 전에 **설정 → 데이터 모델**에서 사용자 지정 필드를 생성하세요.
</Warning>

### 팀 초대

<Warning>
  **데이터를 가져오기 전에 사용자를 초대하세요.**

  데이터에 사용자 참조(계정 소유자, 담당자 등)가 포함되어 있다면, 가져오기 전에 해당 사용자가 Twenty에 존재해야 합니다. 그렇지 않으면 해당 관계를 매핑할 수 없습니다.
</Warning>

1. **설정 → 구성원**으로 이동하세요.
2. 모든 팀 구성원을 초대하세요
3. **모두가 초대를 수락할 때까지 기다리세요**
4. 모든 사용자가 구성원 목록에 표시되는지 확인하세요

## 4단계: 현재 CRM에서 내보내기

현재 CRM에서 데이터를 내보내세요:

1. 보통 설정, 데이터 관리 또는 관리자 메뉴에 있는 **내보내기** 기능을 찾으세요
2. 가능하면 **CSV 형식**으로 내보내세요
3. 각 개체 유형을 별도로 내보내세요(회사, 연락처, 거래 등)
4. 마이그레이션하려는 모든 필드를 포함하세요

**다음 개체를 내보내세요(참고용 순서):**

1. 회사 / 계정 / 조직
2. 연락처 / 사람
3. 거래 / 기회
4. 노트 및 활동
5. 사용자 지정 개체

## 5단계: 데이터 정리 및 형식 지정

내보낸 각 CSV를 스프레드시트 애플리케이션에서 열고 Twenty에 맞게 준비하세요.

### 중복 제거

1. 고유 필드(사람: 이메일, 회사: 도메인)로 정렬하세요
2. 중복 행을 제거하거나 병합하세요
3. Twenty에 이미 중복이 없는지 확인하세요

### 필드 형식을 올바르게 지정

| 필드 유형     | 필수 형식                       |
| --------- | --------------------------- |
| **도메인**   | `https://domain.com`        |
| **이메일**   | `name@domain.com` (고유해야 함)  |
| **날짜**    | `YYYY-MM-DD`                |
| **전화**    | 세 개의 열: 번호, 국가 코드, 전화 걸기 코드 |
| **부울**    | `TRUE` 또는 `FALSE` (대문자)     |
| **선택 필드** | 표시 레이블이 아니라 API 이름을 사용하세요   |

<Warning>
  **도메인 형식이 중요합니다.**

  `https://domain.com`을 사용하세요(`domain.com` 또는 `www.domain.com`은 사용하지 마세요). 이는 Twenty의 형식과 일치하며 이메일/캘린더 동기화를 연결할 때 중복을 방지합니다.
</Warning>

모든 필드 유형에 대한 전체 형식 요구 사항은 [CSV 파일 준비 방법](/l/ko/user-guide/data-migration/how-tos/prepare-your-csv-files)을 참조하세요.

### 관계 열 추가

레코드를 연결하려면(예: 사람을 회사에) 상위 레코드의 고유 식별자가 있는 열을 추가하세요.

**예: 회사 링크가 포함된 사람 CSV**

```csv theme={null}
firstName,lastName,email,companyDomain
John,Smith,john@acme.com,https://acme.com
Jane,Doe,jane@widgets.co,https://widgets.co
```

레코드 연결에 대한 자세한 지침은 [관계 가져오기 방법](/l/ko/user-guide/data-migration/how-tos/import-relations-between-objects-via-csv)을 참조하세요.

### 사용자 참조 업데이트

데이터에 사용자 할당(소유자, 담당자)이 포함된 경우:

1. **사용자의 이메일**이 포함된 열을 추가하세요(이전 시스템의 ID만이 아니라)
2. 사용자가 Twenty 워크스페이스에 참여할 때 사용한 것과 동일한 이메일 주소를 사용하세요

전체 형식 가이드는 [CSV 파일 준비 방법](/l/ko/user-guide/data-migration/how-tos/prepare-your-csv-files)을 참조하세요.

## 6단계: Twenty로 가져오기

<Warning>
  **가져오기 순서가 중요합니다!**

  항상 다음 순서로 가져오세요:

  1. **회사** 먼저(종속성 없음)
  2. 그다음 **사람**(회사에 연결)
  3. **기회** 세 번째(회사/사람에 연결)
  4. **노트와 작업**(레코드에 연결)
  5. **사용자 지정 객체**(종속성에 따름)

  참조하려면 상위 레코드가 먼저 존재해야 합니다.
</Warning>

### 각 객체 가져오기

각 CSV 파일에 대해 다음 순서로 진행하세요:

1. Twenty에서 해당 객체로 이동하세요
2. **⋮ → 레코드 가져오기**를 클릭하세요
3. CSV 파일을 업로드하세요
4. 열을 필드에 매핑하세요:
   * 사용자 이메일 열을 해당 관계 필드에 매핑하세요
   * 관계 열(예: `companyDomain`)을 관계 필드에 매핑하세요
5. UI에서 오류를 검토하고 수정하세요
6. 가져오기를 확인하세요
7. 다음 파일로 진행하기 전에 몇 개의 레코드를 확인하세요

**상세 가이드:**

* [회사 가져오기 방법](/l/ko/user-guide/data-migration/how-tos/import-companies-via-csv)
* [연락처 가져오기 방법](/l/ko/user-guide/data-migration/how-tos/import-contacts-via-csv)
* [관계 가져오기 방법](/l/ko/user-guide/data-migration/how-tos/import-relations-between-objects-via-csv)

## 7단계: 대규모 마이그레이션(레코드 50,000개 이상)

대규모 마이그레이션의 경우:

| 규모                   | 권장 방법         |
| -------------------- | ------------- |
| 10,000개 미만의 레코드      | 단일 CSV 가져오기   |
| 10,000 - 50,000개 레코드 | 여러 CSV 파일로 분할 |
| 50,000개 이상의 레코드      | API 사용        |

**API 가져오기의 경우:**

* 대규모 데이터 세트에 대해 더 빠르고 신뢰성이 높음
* 배치 작업 지원(호출당 최대 60개 레코드)
* 자세한 내용은 [API로 데이터 가져오는 방법](/l/ko/user-guide/data-migration/how-tos/import-data-via-api)을 참조하세요

## 8단계: 마이그레이션 이후 설정

데이터를 가져온 후 워크스페이스 구성을 완료하세요:

### 뷰 다시 만들기

* 필터, 정렬, 열 구성이 포함된 저장된 뷰를 설정하세요
* 필요한 칸반 또는 캘린더 뷰를 만드세요

### 워크플로우 재구성

* 자동화를 **설정 → 워크플로우**에서 다시 만드세요
* 가장 중요한 워크플로우부터 시작하세요
* 사용하기 전에 각 워크플로우를 테스트하세요

### 역할 및 권한 구성

* **설정 → 역할**에서 역할을 설정하세요
* 적절한 역할에 사용자를 할당하세요

### 이메일 및 캘린더 연결

* 각 사용자는 **설정 → 계정**에서 자신의 계정을 연결합니다
* Twenty가 이메일을 연락처 레코드와 동기화하기 시작합니다
* 자세한 내용은 [이메일 및 캘린더](/l/ko/user-guide/calendar-emails/overview)를 참조하세요

### 팀 교육

* 함께 새 인터페이스를 살펴보세요
* 팀별 프로세스를 문서화하세요

## 일반적인 문제와 해결책

| 문제               | 원인                 | 해결책                                         |
| ---------------- | ------------------ | ------------------------------------------- |
| **중복 오류**        | 이메일/도메인이 이미 존재함    | 파일에서 중복을 제거하거나 고유 식별자를 포함하여 기존 레코드를 업데이트하세요 |
| **관계를 찾을 수 없음**  | 상위 레코드가 존재하지 않음    | 상위 객체를 먼저 가져오세요(회사를 사람보다 먼저)                |
| **누락된 필드**       | 사용자 지정 필드가 존재하지 않음 | 가져오기 전에 설정 → 데이터 모델에서 필드를 생성하세요             |
| **선택 필드 오류**     | 표시 레이블 사용 중        | API 이름을 사용하세요(설정에서 고급 모드를 활성화하여 찾을 수 있음)    |
| **사용자 관계 비어 있음** | 사용자가 초대를 수락하지 않음   | 가져오기 전에 모든 사용자가 초대를 수락했는지 확인하세요             |

자세한 문제 해결 단계는 [가져오기 오류 수정](/l/ko/user-guide/data-migration/how-tos/fix-import-errors)을 참조하세요.

## 마이그레이션 후 체크리스트

### 데이터 무결성

<Check>모든 레코드가 가져와졌음(원본 시스템과 개수 비교)</Check>
<Check>관계가 정상적으로 작동함(사람이 회사에 연결됨)</Check>
<Check>사용자 할당이 올바르게 매핑됨(소유자, 담당자)</Check>
<Check>사용자 지정 필드가 채워졌음</Check>
<Check>예상치 못한 중복 없음</Check>

### 구성

<Check>뷰 재생성 완료</Check>
<Check>워크플로우 재생성 및 테스트 완료</Check>
<Check>역할 및 권한 구성 완료</Check>
<Check>이메일/캘린더 동기화 연동 완료</Check>

### 팀 준비 상태

<Check>새 시스템에 대한 팀 교육 완료</Check>
<Check>기존 CRM 접근 계획 결정(참고용으로 유지? 언제 비활성화할지?)</Check>

## FAQ

<AccordionGroup>
  <Accordion title="워크플로우를 자동으로 마이그레이션할 수 있나요?">
    현재는 불가능합니다. 워크플로우는 Twenty에서 수동으로 다시 만들어야 합니다.
  </Accordion>

  <Accordion title="파일 첨부는 어떻게 하나요?">
    파일 첨부는 CSV 내보내기에 포함되지 않습니다. 수동으로 다시 업로드하거나 API를 통해 마이그레이션하거나 지원이 필요하면 당사 팀에 문의하세요.
  </Accordion>

  <Accordion title="마이그레이션 중에 두 시스템을 모두 실행 상태로 유지할 수 있나요?">
    예, 마이그레이션이 완료되었음을 확인할 때까지 기존 CRM을 실행 상태로 유지할 것을 권장합니다. 다만 두 곳 모두에서 새 데이터를 생성하지 않도록 주의하세요.
  </Accordion>

  <Accordion title="마이그레이션에는 일반적으로 얼마나 걸리나요?">
    데이터의 규모와 복잡도에 따라 다릅니다. 소규모 마이그레이션(레코드 10,000개 미만)은 몇 시간 내에 완료할 수 있습니다. 대규모 마이그레이션은 데이터 정리와 테스트를 포함하여 며칠이 걸릴 수 있습니다.
  </Accordion>
</AccordionGroup>

## 도움이 필요하신가요?

복잡한 마이그레이션 또는 대규모 데이터 세트의 경우:

* **가이드 설정:** 4시간 온보딩 패키지 예약
* **전체 마이그레이션 서비스:** 당사 파트너가 전체 마이그레이션을 처리할 수 있습니다

[contact@twenty.com](mailto:contact@twenty.com)으로 문의하시거나 당사의 [구현 서비스](/l/ko/user-guide/getting-started/capabilities/implementation-services)를 확인하세요.