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

​
概要

このガイドでは、会社を Twenty にインポートする手順を説明します。 まず Companies をインポートしてください。People と Opportunities は Companies にリンクします。

​
始める前に

​
事前準備チェックリスト

ファイル形式が CSV、XLSX、または XLS である
ファイルのレコード数が 10,000 未満
ファイル内に重複するドメインがない
すべてのカスタムフィールドが Settings → Data Model に存在する
10,000 社を超えてインポートする必要がありますか？ 複数のファイルに分割するか、API インポート を使用します。

​
ステップ 1: 会社データを準備する

​
必須および推奨フィールド

フィールド必須?形式ノート
Name推奨テキスト会社の表示名
ドメイン推奨https://domain.com一意の識別子
住所任意複数の列以下を参照
従業員任意数従業員数
カスタムフィールド任意項目により異なるデータモデル内に存在している必要があります

​
ドメイン形式

ドメインには https://domain.com の形式を使用してください。これは、メール／カレンダー同期から Companies が自動作成される際に使用される形式と一致し、後の重複を防ぎます。
ドメイン列:
  • Domain / Domain Label: acme.com
  • Domain / Domain URL: https://acme.com

​
住所形式

住所は複数の列を必要とするネストされたフィールドです: 
Address / Address 1,Address / City,Address / State,Address / Country,Address / Post Code
123 Main Street,San Francisco,CA,USA,94105

​
CSV のサンプル構造

name,Domain / Domain URL,Domain / Domain Label,Address / City,Address / Country,employees
Acme Corp,https://acme.com,acme.com,San Francisco,USA,250
Widget Co,https://widgets.co,widgets.co,New York,USA,50
プロのヒント: インポート中に Download sample file をクリックして、Twenty が想定する正確な列名を確認してください。

​
ステップ 2: インポート機能にアクセスする

オプション 1: Companies ビューから
  1. 左側のサイドバーで Companies に移動します
  2. 右上の ⋮ アイコンをクリックします
  3. Import records を選択します
オプション 2: Command メニューを使用
  1. Cmd + K（Mac）またはCtrl + K（Windows）を押します
  2. “import” と入力します
  3. Import records を選択します
  4. Companies を選択します

​
ステップ 3: ファイルをアップロードする

  1. Select file をクリックします
  2. CSV、XLSX、または XLS ファイルを選択します
  3. Twenty がファイルを解析するまで待ちます

​
ステップ 4: 列をマッピングする

Twenty は列をフィールドに自動的に照合しようとします。 確認して調整します:
  1. 自動マッピングを確認 — 正しいことを検証します
  2. 誤ったマッピングを修正 — ドロップダウンをクリックして正しいフィールドを選択します
  3. 列をスキップ — インポートしたくない列には Do not map を選択します

​
重要なマッピングルール

  • Domain: Domain / Domain URL にマップします（Domain Label ではありません）
  • 住所: 各項目を対応する列（City、State など）にマップします
  • Select フィールド: 値は既存のオプションと一致している必要があります（次のステップでマッピングすることもできます）

​
ステップ 5: Select フィールドの値をマッピングする

Select または Multi-Select フィールドがある場合:
  1. Twenty は、既存のオプションと並べて値を表示します
  2. ファイル内の各値を Twenty のオプションに対応付けます
  3. 必要に応じて新しいオプションを作成します
Select のオプションは表示ラベルではなく、API 名を使用します。 API 名を確認するには、Settings → Data Model で Advanced mode を有効にします。

​
ステップ 6: エラーを確認して修正

インポートを完了する前に、Twenty がデータを検証します:
  1. Next Steps をクリックします
  2. エラーのある行は 黄色 で強調表示されます
  3. エラーを直接修正 — セルをクリックして値を編集します
  4. 問題のある行を削除 — その行をスキップするには X をクリックします

​
一般的な会社インポートのエラー

エラー原因解決策
重複したドメインドメインが Twenty に既に存在するファイルから削除するか、既存のレコードを更新します
無効なドメイン形式形式の誤りhttps://domain.com を使用します
必須フィールドの欠落必須フィールドが空です値を入力するか、その行を削除します

​
ステップ 7: インポートを完了する

  1. インポートの概要を確認します
  2. インポートするには Confirm をクリックします
  3. インポートが完了するまで待ちます
  4. いくつかのレコードを確認して検証します

​
会社をインポートした後

これで、Companies にリンクするレコードをインポートできます:
  1. People をインポート — ドメインを使って Companies にリンクします
  2. Opportunities をインポート — Companies にリンクします
  3. インポートを検証 — データが正しいことを確認するために、いくつかのレコードを抜き取り確認します

​
既存の会社を更新する

新規作成ではなく会社を更新するには:
  1. ファイルに domain または id 列を含めます
  2. Twenty はこの一意の識別子でレコードを照合します
  3. 既存の会社は更新され、新規は作成されます
詳細は 既存レコードを更新する方法 を参照してください。

​
FAQ

ドメインは Twenty における一意の識別子です。 これにより会社の重複を防ぎ、メール同期でメールが正しい会社にリンクされるようになります。
ドメインは空のままでもかまいません。 ただし、データ品質を高め自動メールリンクのため、可能であればドメインの追加を推奨します。
はい! 最初に会社をインポートし、その後に People をインポートして、会社のドメインを使用して関連付けることができます。
既存の会社と一致する一意の識別子（ドメインまたは id）を含めた場合、Twenty は重複を作成せず、その会社を更新します。
ファイルから重複を削除するか、代わりに会社の id を含めて既存のレコードを更新してください。

​
トラブルシューティング

お困りですか？ 次を確認してください: