개요
이 가이드는 어떤 CRM에서든 데이터를 Twenty로 마이그레이션하는 과정을 단계별로 안내합니다. 이 과정에는 데이터 감사, Twenty 워크스페이스 준비, 현재 시스템에서의 내보내기, Twenty로의 가져오기가 포함됩니다.마이그레이션 후에는 뷰, 워크플로우, 권한을 수동으로 다시 만들어야 합니다. 이 구성 작업에 필요한 시간을 계획하세요.
1단계: 현재 데이터 감사
마이그레이션은 새롭게 시작할 수 있는 기회입니다. 불필요한 데이터는 가져오지 마세요. 유지할 항목:- 활성 연락처 및 회사
- 열려 있는 기회와 거래
- 중요한 메모와 활동
- 실제로 사용하는 사용자 정의 필드
- 오래된 연락처(2년 이상 활동 없음)
- 중복 레코드
- 테스트 데이터
- 사용하지 않는 사용자 정의 필드
2단계: 데이터 모델 매핑
현재 CRM과 Twenty 간의 매핑 문서를 만드세요:| 현재 CRM | Twenty |
|---|---|
| 계정 / 조직 | 회사 |
| 연락처 / 개인 | 사람들 |
| 거래 / 기회 | 기회 |
| 활동 | 작업 또는 노트 |
| 사용자 지정 개체 | 사용자 지정 개체 |
- 원본 필드 이름
- 대상 Twenty 필드
- 필요한 형식 변환(날짜, 전화번호 등)
가져오기 중에 이 매핑 문서를 가까이 두세요—열을 매핑할 때 참고하게 됩니다.
3단계: Twenty 워크스페이스 설정
데이터를 가져오기 전에 Twenty 워크스페이스를 준비하세요:사용자 지정 개체 및 필드 만들기
- 설정 → 데이터 모델로 이동
- 필요한 사용자 지정 개체를 생성하세요
- 표준 개체와 사용자 지정 개체에 사용자 지정 필드를 추가하세요
- 필드 설정(고유, 필수, 선택 옵션 등)을 구성하세요
팀 초대
- 설정 → 구성원으로 이동하세요.
- 모든 팀 구성원을 초대하세요
- 모두가 초대를 수락할 때까지 기다리세요
- 모든 사용자가 구성원 목록에 표시되는지 확인하세요
4단계: 현재 CRM에서 내보내기
현재 CRM에서 데이터를 내보내세요:- 보통 설정, 데이터 관리 또는 관리자 메뉴에 있는 내보내기 기능을 찾으세요
- 가능하면 CSV 형식으로 내보내세요
- 각 개체 유형을 별도로 내보내세요(회사, 연락처, 거래 등)
- 마이그레이션하려는 모든 필드를 포함하세요
- 회사 / 계정 / 조직
- 연락처 / 사람
- 거래 / 기회
- 노트 및 활동
- 사용자 지정 개체
5단계: 데이터 정리 및 형식 지정
내보낸 각 CSV를 스프레드시트 애플리케이션에서 열고 Twenty에 맞게 준비하세요.중복 제거
- 고유 필드(사람: 이메일, 회사: 도메인)로 정렬하세요
- 중복 행을 제거하거나 병합하세요
- Twenty에 이미 중복이 없는지 확인하세요
필드 형식을 올바르게 지정
| 필드 유형 | 필수 형식 |
|---|---|
| 도메인 | https://domain.com |
| 이메일 | name@domain.com (고유해야 함) |
| 날짜 | YYYY-MM-DD |
| 전화 | 세 개의 열: 번호, 국가 코드, 전화 걸기 코드 |
| 부울 | TRUE 또는 FALSE (대문자) |
| 선택 필드 | 표시 레이블이 아니라 API 이름을 사용하세요 |
관계 열 추가
레코드를 연결하려면(예: 사람을 회사에) 상위 레코드의 고유 식별자가 있는 열을 추가하세요. 예: 회사 링크가 포함된 사람 CSV사용자 참조 업데이트
데이터에 사용자 할당(소유자, 담당자)이 포함된 경우:- 사용자의 이메일이 포함된 열을 추가하세요(이전 시스템의 ID만이 아니라)
- 사용자가 Twenty 워크스페이스에 참여할 때 사용한 것과 동일한 이메일 주소를 사용하세요
6단계: Twenty로 가져오기
각 객체 가져오기
각 CSV 파일에 대해 다음 순서로 진행하세요:- Twenty에서 해당 객체로 이동하세요
- ⋮ → 레코드 가져오기를 클릭하세요
- CSV 파일을 업로드하세요
- 열을 필드에 매핑하세요:
- 사용자 이메일 열을 해당 관계 필드에 매핑하세요
- 관계 열(예:
companyDomain)을 관계 필드에 매핑하세요
- UI에서 오류를 검토하고 수정하세요
- 가져오기를 확인하세요
- 다음 파일로 진행하기 전에 몇 개의 레코드를 확인하세요
7단계: 대규모 마이그레이션(레코드 50,000개 이상)
대규모 마이그레이션의 경우:| 규모 | 권장 방법 |
|---|---|
| 10,000개 미만의 레코드 | 단일 CSV 가져오기 |
| 10,000 - 50,000개 레코드 | 여러 CSV 파일로 분할 |
| 50,000개 이상의 레코드 | API 사용 |
- 대규모 데이터 세트에 대해 더 빠르고 신뢰성이 높음
- 배치 작업 지원(호출당 최대 60개 레코드)
- 자세한 내용은 API로 데이터 가져오는 방법을 참조하세요
8단계: 마이그레이션 이후 설정
데이터를 가져온 후 워크스페이스 구성을 완료하세요:뷰 다시 만들기
- 필터, 정렬, 열 구성이 포함된 저장된 뷰를 설정하세요
- 필요한 칸반 또는 캘린더 뷰를 만드세요
워크플로우 재구성
- 자동화를 설정 → 워크플로우에서 다시 만드세요
- 가장 중요한 워크플로우부터 시작하세요
- 사용하기 전에 각 워크플로우를 테스트하세요
역할 및 권한 구성
- 설정 → 역할에서 역할을 설정하세요
- 적절한 역할에 사용자를 할당하세요
이메일 및 캘린더 연결
- 각 사용자는 설정 → 계정에서 자신의 계정을 연결합니다
- Twenty가 이메일을 연락처 레코드와 동기화하기 시작합니다
- 자세한 내용은 이메일 및 캘린더를 참조하세요
팀 교육
- 함께 새 인터페이스를 살펴보세요
- 팀별 프로세스를 문서화하세요
일반적인 문제와 해결책
| 문제 | 원인 | 해결책 |
|---|---|---|
| 중복 오류 | 이메일/도메인이 이미 존재함 | 파일에서 중복을 제거하거나 고유 식별자를 포함하여 기존 레코드를 업데이트하세요 |
| 관계를 찾을 수 없음 | 상위 레코드가 존재하지 않음 | 상위 객체를 먼저 가져오세요(회사를 사람보다 먼저) |
| 누락된 필드 | 사용자 지정 필드가 존재하지 않음 | 가져오기 전에 설정 → 데이터 모델에서 필드를 생성하세요 |
| 선택 필드 오류 | 표시 레이블 사용 중 | API 이름을 사용하세요(설정에서 고급 모드를 활성화하여 찾을 수 있음) |
| 사용자 관계 비어 있음 | 사용자가 초대를 수락하지 않음 | 가져오기 전에 모든 사용자가 초대를 수락했는지 확인하세요 |
마이그레이션 후 체크리스트
데이터 무결성
모든 레코드가 가져와졌음(원본 시스템과 개수 비교)
관계가 정상적으로 작동함(사람이 회사에 연결됨)
사용자 할당이 올바르게 매핑됨(소유자, 담당자)
사용자 지정 필드가 채워졌음
예상치 못한 중복 없음
구성
뷰 재생성 완료
워크플로우 재생성 및 테스트 완료
역할 및 권한 구성 완료
이메일/캘린더 동기화 연동 완료
팀 준비 상태
새 시스템에 대한 팀 교육 완료
기존 CRM 접근 계획 결정(참고용으로 유지? 언제 비활성화할지?)
FAQ
워크플로우를 자동으로 마이그레이션할 수 있나요?
워크플로우를 자동으로 마이그레이션할 수 있나요?
현재는 불가능합니다. 워크플로우는 Twenty에서 수동으로 다시 만들어야 합니다.
파일 첨부는 어떻게 하나요?
파일 첨부는 어떻게 하나요?
파일 첨부는 CSV 내보내기에 포함되지 않습니다. 수동으로 다시 업로드하거나 API를 통해 마이그레이션하거나 지원이 필요하면 당사 팀에 문의하세요.
마이그레이션 중에 두 시스템을 모두 실행 상태로 유지할 수 있나요?
마이그레이션 중에 두 시스템을 모두 실행 상태로 유지할 수 있나요?
예, 마이그레이션이 완료되었음을 확인할 때까지 기존 CRM을 실행 상태로 유지할 것을 권장합니다. 다만 두 곳 모두에서 새 데이터를 생성하지 않도록 주의하세요.
마이그레이션에는 일반적으로 얼마나 걸리나요?
마이그레이션에는 일반적으로 얼마나 걸리나요?
데이터의 규모와 복잡도에 따라 다릅니다. 소규모 마이그레이션(레코드 10,000개 미만)은 몇 시간 내에 완료할 수 있습니다. 대규모 마이그레이션은 데이터 정리와 테스트를 포함하여 며칠이 걸릴 수 있습니다.
도움이 필요하신가요?
복잡한 마이그레이션 또는 대규모 데이터 세트의 경우:- 가이드 설정: 4시간 온보딩 패키지 예약
- 전체 마이그레이션 서비스: 당사 파트너가 전체 마이그레이션을 처리할 수 있습니다