他のCRMからの移行

任意の CRM から Twenty へデータを移行するためのステップバイステップガイド。

​

概要

このガイドでは、任意の CRM から Twenty へデータを移行する手順を説明します。 このプロセスには、データの監査、Twenty ワークスペースの準備、現在のシステムからのエクスポート、および Twenty へのインポートが含まれます。

移行後、ビュー、ワークフロー、権限は手動で再作成する必要があります。 この構成作業のための時間を確保してください。

​

ステップ 1: 現在のデータを監査する

移行は新たなスタートの好機です。 不要なデータは持ち込まないでください。

保持するもの:

• アクティブな連絡先と会社
• 進行中の商談やディール
• 重要なメモとアクティビティ
• 実際に使用しているカスタムフィールド

除外するもの:

• 古い連絡先（2年以上アクティビティがないもの）
• 重複レコード
• テストデータ
• 未使用のカスタムフィールド

​

ステップ 2: データモデルをマッピングする

現在の CRM と Twenty の間のマッピングドキュメントを作成します:

お使いの CRM	Twenty
アカウント / 組織	会社
連絡先 / 人	連絡先
ディール / 商談	商談
アクティビティ	タスク または メモ
カスタムオブジェクト	カスタムオブジェクト

各フィールドごとに、次を記録します：

• ソースフィールド名
• 移行先の Twenty フィールド
• 必要な形式変換（例：日付、電話番号など）

インポート中はこのマッピングドキュメントを手元に置いてください—列のマッピング時に参照します。

​

ステップ 3: Twenty ワークスペースを設定する

データをインポートする前に、Twenty ワークスペースを準備します:

​

カスタムオブジェクトとフィールドを作成

1. 設定 → データモデル に移動
2. 必要なカスタムオブジェクトを作成する
3. 標準オブジェクトおよびカスタムオブジェクトにカスタムフィールドを追加する
4. フィールドの設定（一意、必須、選択肢など）を構成する

インポート前にフィールドが存在している必要があります。

CSV インポートはレコードを作成します。フィールドは作成しません。 インポート前に 設定 → データモデル でカスタムフィールドをすべて作成してください。

​

チームを招待

重要: データをインポートする前にユーザーを招待してください。

データにユーザー参照（アカウント所有者、担当者など）が含まれる場合、それらのユーザーはインポート前に Twenty 上に存在している必要があります。 そうでない場合、それらのリレーションはマッピングできません。

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
メール	[e-mail]（一意である必要があります）
日付	YYYY-MM-DD
電話	3 列: 番号、国コード、Calling Code
ブール型	TRUE または FALSE（大文字）
選択フィールド	表示ラベルではなく API 名を使用する

ドメインの形式は重要です。

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

すべてのフィールドタイプに関する完全な書式要件は、CSV ファイルを準備する方法 を参照してください。

​

リレーション列を追加

レコードをリンクするには（例：連絡先を会社にリンク）、親の一意の識別子を含む列を追加します。

例：会社リンク付きの連絡先 CSV

firstName,lastName,email,companyDomain
John,Smith,[e-mail],https://acme.com
Jane,Doe,[e-mail],https://widgets.co

レコードをリンクする手順の詳細は、リレーションをインポートする方法 を参照してください。

​

ユーザー参照を更新

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

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

完全な書式ガイドは、CSV ファイルを準備する方法 を参照してください。

​

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

インポート順は重要です！

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

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

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

​

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

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

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

詳細ガイド:

• 会社をインポートする方法
• 連絡先をインポートする方法
• リレーションをインポートする方法

​

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

大規模な移行の場合:

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

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

• 大規模データセットでは高速で信頼性が高い
• バッチ処理に対応（1 回の呼び出しで最大 60 レコード）
• 詳細は API でデータをインポートする方法 を参照

​

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

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

​

ビューを再作成

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

​

ワークフローを再作成

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

​

役割と権限の設定

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

​

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

• 各ユーザーは 設定 → アカウント で自分のアカウントを接続します
• Twenty がメールを連絡先レコードと同期し始めます
• メールとカレンダー を参照

​

チームのトレーニング

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

​

一般的な問題と解決策

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

詳細なトラブルシューティング手順は、インポートエラーを解決する方法 を参照してください。

​

ポスト移行チェックリスト

​

データの整合性

すべてのレコードがインポートされた（ソースシステムの件数と比較）

リレーションが正常に機能している（連絡先が会社にリンク）

ユーザーの割り当てが正しくマッピングされている（所有者、担当者）

カスタムフィールドが入力されている

想定外の重複がない

​

構成

ビューを再作成済み

ワークフローを再作成しテスト済み

役割と権限を設定済み

メール/カレンダー同期を接続済み

​

チームの準備状況

新しいシステムについてチームをトレーニング済み

旧 CRM のアクセス計画を決定（参照用に保持する？ いつ無効化するか？)

​

FAQ

ワークフローを自動的に移行できますか？

現時点ではできません。 ワークフローは Twenty で手動で再作成する必要があります。

ファイル添付はどうなりますか？

CSV のエクスポートにはファイル添付は含まれません。 手動で再アップロードするか、API で移行するか、サポートが必要な場合は弊社チームにご連絡ください。

移行中に両方のシステムを稼働させておけますか？

はい、移行が完了したことを確認するまでは、旧 CRM を稼働させておくことを推奨します。 ただし、両方の環境で新しいデータを作成しないよう注意してください。

移行には通常どれくらい時間がかかりますか？

データの量と複雑さによります。 小規模な移行（1 万件未満）は数時間で完了します。 大規模な移行は、データのクリーンアップやテストを含め、数日かかる場合があります。

​

ヘルプが必要ですか?

移行についてサポートが必要ですか？

• おまかせプラン: データ、パイプライン、ユーザーの移行を最初から最後まで任せられる 認定済みの Twenty パートナーを探す。
• オンボーディングパック: Twenty チームによる 4 時間のガイド付きセットアップ — [e-mail]。