メインコンテンツへスキップ

​
概要

このガイドでは、任意の CRM から Twenty へデータを移行する手順を説明します。 このプロセスには、データの監査、Twenty ワークスペースの準備、現在のシステムからのエクスポート、および Twenty へのインポートが含まれます。
移行後、ビュー、ワークフロー、権限は手動で再作成する必要があります。 この構成作業のための時間を確保してください。

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

移行は新たなスタートの好機です。 不要なデータは持ち込まないでください。 保持するもの:
  • アクティブな連絡先と会社
  • 進行中の商談やディール
  • 重要なメモとアクティビティ
  • 実際に使用しているカスタムフィールド
除外するもの:
  • 古い連絡先（2年以上アクティビティがないもの）
  • 重複レコード
  • テストデータ
  • 未使用のカスタムフィールド

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

現在の CRM と Twenty の間のマッピングドキュメントを作成します:
お使いの CRMTwenty
アカウント / 組織会社
連絡先 / 人連絡先
ディール / 商談商談
アクティビティタスク または メモ
カスタムオブジェクトカスタムオブジェクト
各フィールドごとに、次を記録します：
  • ソースフィールド名
  • 移行先の 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
メールname@domain.com（一意である必要があります）
日付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,john@acme.com,https://acme.com
Jane,Doe,jane@widgets.co,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 でのインポートについて:

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

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

​
ビューを再作成

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

​
ワークフローを再作成

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

​
役割と権限の設定

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

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

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

​
チームのトレーニング

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

​
一般的な問題と解決策

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

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

​
データの整合性

すべてのレコードがインポートされた（ソースシステムの件数と比較）
リレーションが正常に機能している（連絡先が会社にリンク）
ユーザーの割り当てが正しくマッピングされている（所有者、担当者）
カスタムフィールドが入力されている
想定外の重複がない

​
構成

ビューを再作成済み
ワークフローを再作成しテスト済み
役割と権限を設定済み
メール/カレンダー同期を接続済み

​
チームの準備状況

新しいシステムについてチームをトレーニング済み
旧 CRM のアクセス計画を決定（参照用に保持する？ いつ無効化するか？)

​
FAQ

現時点ではできません。 ワークフローは Twenty で手動で再作成する必要があります。
CSV のエクスポートにはファイル添付は含まれません。 手動で再アップロードするか、API で移行するか、サポートが必要な場合は弊社チームにご連絡ください。
はい、移行が完了したことを確認するまでは、旧 CRM を稼働させておくことを推奨します。 ただし、両方の環境で新しいデータを作成しないよう注意してください。
データの量と複雑さによります。 小規模な移行（1 万件未満）は数時間で完了します。 大規模な移行は、データのクリーンアップやテストを含め、数日かかる場合があります。

​
ヘルプが必要ですか?

複雑な移行や大規模なデータセットの場合:
  • ガイド付きセットアップ: 4 時間のオンボーディングパックを予約する
  • フル移行サービス: パートナーが移行全体に対応できます
contact@twenty.com までご連絡いただくか、導入支援サービスをご覧ください。