---
title: CSV ファイルで連絡先をインポートする
description: Twenty に連絡先（People）をインポートするための完全なステップバイステップガイド。
---

## 概要

このガイドでは、連絡先（People）を Twenty にインポートする手順を説明します。

## 始める前に

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

<Check>
ファイル形式が CSV、XLSX、または XLS である
</Check>

<Check>
ファイルのレコード数が 10,000 未満
</Check>

<Check>
ファイル内に重複するメールアドレスがない
</Check>

<Check>
**会社を先にインポート**（People を会社に関連付ける場合）
</Check>

<Check>
すべてのカスタムフィールドが **Settings → Data Model** に存在する
</Check>

<Warning>
**People の前に会社をインポート**

People を会社に関連付けたい場合は、まず会社をインポートしてください。 参照する前に、その会社が存在している必要があります。
</Warning>

## ステップ 1: 連絡先データを準備する

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

| フィールド         | 必須? | 形式                | ノート                   |
| ------------- | --- | ----------------- | --------------------- |
| **メール**       | 推奨  | `name@domain.com` | 一意である必要があります          |
| **名**         | 推奨  | テキスト              |                       |
| **姓**         | 推奨  | テキスト              |                       |
| **会社**        | 任意  | ドメインまたは ID        | 既存の会社にリンクします          |
| **電話**        | 任意  | 複数の列              | 以下を参照                 |
| **職種**        | 任意  | テキスト              |                       |
| **カスタムフィールド** | 任意  | 項目により異なる          | データモデル内に存在している必要があります |

### メール形式

* 有効なメール形式である必要があります: `name@domain.com`
* **一意である必要があります** — ファイル内や Twenty 内に重複がないこと
* 追加のメールには、**Emails / Additional Emails** 列を使用してください:

```
["jane@twenty.com","jane.doe@twenty.com"]
```

### 電話番号の形式

電話番号は複数の列を必要とする**ネストされたフィールド**です:

| 列                                       | 例            |
| --------------------------------------- | ------------ |
| **Phones / Primary Phone Number**       | `4159095555` |
| **Phones / Primary Phone Country Code** | `US`         |
| **Phones / Primary Phone Calling Code** | `+1`         |

### 会社への関連付け

会社の一意の識別子を含む列を追加します:

| 列名              | 形式     | 例                                      |
| --------------- | ------ | -------------------------------------- |
| `companyDomain` | URL 形式 | `https://acme.com`                     |
| `companyId`     | UUID   | `c776ee49-f608-4a77-8cc8-6fe96ae1e43f` |

<Note>
**ドメインの URL 形式**（`https://acme.com`）を使用し、ラベルは使用しないでください。 これは Twenty における会社の保存方式に一致します。
</Note>

### CSV のサンプル構造

```csv
firstName,lastName,email,jobTitle,companyDomain,Phones / Primary Phone Number,Phones / Primary Phone Country Code
John,Smith,john@acme.com,CEO,https://acme.com,4159095555,US
Jane,Doe,jane@widgets.co,CTO,https://widgets.co,2125551234,US
```

<Note>
**プロのヒント:** インポート中に **Download sample file** をクリックするか、既存の People をいくつかエクスポートして、Twenty が想定する正確な列名を確認してください。
</Note>

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

**オプション 1: People ビューから**

1. 左側のサイドバーで **People** に移動します
2. 右上の **⋮** アイコンをクリックします
3. **Import records** を選択します

**オプション 2: Command メニューを使用**

1. `Cmd + K`（Mac）または`Ctrl + K`（Windows）を押します
2. "import" と入力します
3. **Import records** を選択します
4. **People** を選択します

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

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

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

Twenty は列をフィールドに自動的に照合しようとします。 確認して調整します:

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

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

| 列の種類   | マッピング先                         | ノート                                  |
| ------ | ------------------------------ | ------------------------------------ |
| 会社参照   | **会社** の関連フィールド                | ドメインまたは ID のいずれか一方を使用し、両方は使用しないでください |
| メール    | **メール**                        | プライマリメールアドレス                         |
| 追加のメール | **Emails / Additional Emails** | 配列形式                                 |
| 電話     | 別々の列                           | 番号、国コード、Calling Code                 |

<img src="/images/user-guide/import-export-data/match-columns.png" style={{width:'100%'}} />

### 会社リレーションのマッピング

会社列をマッピングする際:

1. 会社参照列（例: `companyDomain`）を見つけます
2. それを **会社** の関連フィールドにマッピングします
3. Twenty は各 People レコードを対応する会社にリンクします

<Warning>
**リレーションには一意の識別子を必ず1つだけマッピングしてください。**

`companyId` と `companyDomain` の両方をマッピングしないでください。 どちらか一方を選択してください—人間が読みやすいので、可能であればドメインを推奨します。
</Warning>

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

Select または Multi-Select フィールド（例: リードソース）がある場合:

1. Twenty は、既存のオプションと並べて値を表示します
2. ファイル内の各値を Twenty のオプションに対応付けます
3. 必要に応じて新しいオプションを作成します

<Note>
Select のオプションは表示ラベルではなく、**API 名**を使用します。 API 名を確認するには、**Settings → Data Model** で **Advanced mode** を有効にします。
</Note>

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

インポートを完了する前に、Twenty がデータを検証します:

1. **Next Steps** をクリックします
2. エラーのある行は **黄色** で強調表示されます
3. **エラーを直接修正** — セルをクリックして値を編集します
4. **問題のある行を削除** — その行をスキップするには X をクリックします

### 一般的な連絡先インポートのエラー

| エラー                | 原因                              | 解決策                         |
| ------------------ | ------------------------------- | --------------------------- |
| **重複したメールアドレス**    | メールアドレスが Twenty またはファイルに既に存在します | 重複を削除するか、既存のレコードを更新します      |
| **無効なメールアドレス形式**   | メールアドレスの形式が正しくありません             | `name@domain.com` の形式に修正します |
| **リレーションが見つかりません** | 会社が存在しません                       | 先に会社をインポートするか、参照を修正します      |
| **必須フィールドの欠落**     | 必須フィールドが空です                     | 値を入力するか、その行を削除します           |

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

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

## 連絡先をインポートした後

連絡先は Twenty に追加されました！ 次のステップ:

1. **会社リンクを確認** — いくつかの People レコードを開き、正しい会社にリンクされていることを確認します
2. **Opportunities をインポート** — 必要に応じて、People や Companies にリンクします
3. **メール同期を設定** — メールボックスを接続して、連絡先レコード上でメール履歴を確認します

## 既存の連絡先を更新する

新規作成ではなく連絡先を更新するには:

1. ファイルに `email` または `id` 列を含めます
2. Twenty はこの一意の識別子でレコードを照合します
3. 既存の連絡先は更新され、新規は作成されます

詳細は [既存レコードを更新する方法](/l/ja/user-guide/data-migration/how-tos/update-existing-records-via-import) を参照してください。

## FAQ

<AccordionGroup>
  <Accordion title="なぜ 2人の People が同じメールアドレスを持つことはできないのですか？">
    メールアドレスは Twenty における一意の識別子です。 これにより連絡先の重複を防ぎ、メール同期でメールが正しい人物にリンクされるようになります。
  </Accordion>

  <Accordion title="メールアドレスのない人がいる場合はどうすればよいですか？">
    メールアドレスは空のままでもかまいません。 ただし、データ品質とメール同期機能を高めるため、可能であればメールアドレスの追加を推奨します。
  </Accordion>

  <Accordion title="インポート中に People を Companies にリンクするにはどうすればよいですか？">
    Company のドメイン（例: `https://acme.com`）または ID の列を追加します マッピング時に、この列を Company のリレーションフィールドに関連付けます。
  </Accordion>

  <Accordion title="Company がまだ存在しない場合はどうすればよいですか？">
    まず Companies をインポートし、その後 People をインポートします。 参照する前に、その Company が存在している必要があります。
  </Accordion>

  <Accordion title="以前の CRM の ID をインポートできますか？">
    はい! 外部 ID を保存するために、データモデルで "unique" に指定したカスタムフィールドを作成します。 注意: フィールド名 `id` は Twenty の内部 ID 用に予約されています。
  </Accordion>

  <Accordion title="「relation not found」エラーはどのように修正しますか？">
    参照している Company が存在しません。 Company を先にインポートするか、ドメイン/ID が既存の Company と完全に一致しているか確認してください。
  </Accordion>
</AccordionGroup>

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

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

* [インポートエラーを解決する方法](/l/ja/user-guide/data-migration/how-tos/fix-import-errors)
* [リレーションをインポートする方法](/l/ja/user-guide/data-migration/how-tos/import-relations-between-objects-via-csv)
* [フィールドマッピングのリファレンス](/l/ja/user-guide/data-migration/capabilities/field-mapping)