> ## 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`                    |
| **電話**      | 3 列: 番号、国コード、Calling Code       |
| **ブール型**    | `TRUE` または `FALSE`（大文字）         |
| **選択フィールド** | 表示ラベルではなく API 名を使用する            |

<Warning>
  **ドメインの形式は重要です。**

  `https://domain.com` を使用してください（`domain.com` や `www.domain.com` ではありません）。 これは Twenty の形式に一致し、メール/カレンダー同期を接続した際の重複を防ぎます。
</Warning>

すべてのフィールドタイプに関する完全な書式要件は、[CSV ファイルを準備する方法](/l/ja/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/ja/user-guide/data-migration/how-tos/import-relations-between-objects-via-csv) を参照してください。

### ユーザー参照を更新

データにユーザーの割り当て（所有者、担当者）が含まれる場合：

1. **ユーザーのメールアドレス** の列を追加する（古いシステムの ID だけでは不可）
2. ユーザーが Twenty のワークスペースに参加した際に使用したものと同じメールアドレスを使用してください。

完全な書式ガイドは、[CSV ファイルを準備する方法](/l/ja/user-guide/data-migration/how-tos/prepare-your-csv-files) を参照してください。

## ステップ 6: Twenty にインポートする

<Warning>
  **インポート順は重要です！**

  必ずこの順序でインポートします:

  1. 最初に **会社**（依存関係なし）
  2. 次に **連絡先**（会社にリンク）
  3. 3 番目に **商談**（会社/連絡先にリンク）
  4. **メモとタスク**（レコードにリンク）
  5. **カスタムオブジェクト**（依存関係に従って）

  参照する前に、親レコードが存在している必要があります。
</Warning>

### 各オブジェクトをインポート

各 CSV ファイルについて、順番に実行します:

1. Twenty の対象オブジェクトに移動します
2. **⋮ → Import records** をクリックします
3. CSV ファイルをアップロードします
4. 列をフィールドにマッピングします:
   * ユーザーのメールアドレス列を適切なリレーションフィールドにマッピングします
   * リレーション列（`companyDomain` など）をリレーションフィールドにマッピングします
5. UI でエラーを確認して修正します
6. インポートを確定します
7. 次のファイルに進む前に、いくつかのレコードを確認します

**詳細ガイド:**

* [会社をインポートする方法](/l/ja/user-guide/data-migration/how-tos/import-companies-via-csv)
* [連絡先をインポートする方法](/l/ja/user-guide/data-migration/how-tos/import-contacts-via-csv)
* [リレーションをインポートする方法](/l/ja/user-guide/data-migration/how-tos/import-relations-between-objects-via-csv)

## ステップ 7: 大規模な移行（5 万件以上のレコード）

大規模な移行の場合:

| 件数       | 推奨アプローチ           |
| -------- | ----------------- |
| 1 万件未満   | 単一の CSV インポート     |
| 1 万〜5 万件 | 複数の CSV ファイルに分割する |
| 5 万件以上   | API を使用する         |

**API でのインポートについて:**

* 大規模データセットでは高速で信頼性が高い
* バッチ処理に対応（1 回の呼び出しで最大 60 レコード）
* 詳細は [API でデータをインポートする方法](/l/ja/user-guide/data-migration/how-tos/import-data-via-api) を参照

## ステップ 8: 移行後のセットアップ

データのインポート後、ワークスペースの設定を完了します:

### ビューを再作成

* フィルター、並べ替え、列の構成を含む保存済みビューを設定します
* 必要なカンバンビューやカレンダービューを作成します

### ワークフローを再作成

* **設定 → ワークフロー** で自動化を再構築します
* 最も重要なワークフローから開始する
* 運用に入れる前に各ワークフローをテストします

### 役割と権限の設定

* **設定 → 役割** で役割を設定します
* ユーザーに適切な役割を割り当てます

### メールとカレンダーの連携

* 各ユーザーは **設定 → アカウント** で自分のアカウントを接続します
* Twenty がメールを連絡先レコードと同期し始めます
* [メールとカレンダー](/l/ja/user-guide/calendar-emails/overview) を参照

### チームのトレーニング

* 新しいインターフェースを一緒に確認する
* チーム固有のプロセスを文書化する

## 一般的な問題と解決策

| 問題                 | 原因               | 解決策                                          |
| ------------------ | ---------------- | -------------------------------------------- |
| **重複エラー**          | メール/ドメインがすでに存在する | ファイルから重複を削除するか、一意の識別子を含めて既存のレコードを更新する        |
| **リレーションが見つかりません** | 親レコードが存在しない      | 親オブジェクトを先にインポートする（連絡先の前に会社）                  |
| **不足しているフィールド**    | カスタムフィールドが存在しない  | インポート前に **設定 → データモデル** でフィールドを作成する          |
| **選択フィールドのエラー**    | 表示ラベルを使用している     | API 名を使用する（設定で詳細モードを有効にして確認）                 |
| **ユーザーのリレーションが空**  | ユーザーが招待を受諾していない  | データをインポートする前に、すべてのユーザーが招待を受諾していることを確認してください。 |

詳細なトラブルシューティング手順は、[インポートエラーを解決する方法](/l/ja/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="移行には通常どれくらい時間がかかりますか？">
    データの量と複雑さによります。 小規模な移行（1 万件未満）は数時間で完了します。 大規模な移行は、データのクリーンアップやテストを含め、数日かかる場合があります。
  </Accordion>
</AccordionGroup>

## ヘルプが必要ですか?

複雑な移行や大規模なデータセットの場合:

* **ガイド付きセットアップ:** 4 時間のオンボーディングパックを予約する
* **フル移行サービス:** パートナーが移行全体に対応できます

[contact@twenty.com](mailto:contact@twenty.com) までご連絡いただくか、[導入支援サービス](/l/ja/user-guide/getting-started/capabilities/implementation-services)をご覧ください。