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

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.

​
概要

このガイドでは、連絡先（People）を Twenty にインポートする手順を説明します。 People を会社に関連付けたい場合は、会社を先にインポートしてください。

​
始める前に

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

ファイル形式が CSV、XLSX、または XLS である
ファイルのレコード数が 10,000 未満
ファイル内に重複するメールアドレスがない
会社を先にインポート（People を会社に関連付ける場合）
すべてのカスタムフィールドが Settings → Data Model に存在する
People の前に会社をインポートPeople を会社に関連付けたい場合は、まず会社をインポートしてください。 参照する前に、その会社が存在している必要があります。

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

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

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

​
メール形式

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

​
電話番号の形式

電話番号は複数の列を必要とするネストされたフィールドです:
列例
Phones / Primary Phone Number4159095555
Phones / Primary Phone Country CodeUS
Phones / Primary Phone Calling Code+1

​
会社への関連付け

会社の一意の識別子を含む列を追加します:
列名形式例
companyDomainURL 形式https://acme.com
companyIdUUIDc776ee49-f608-4a77-8cc8-6fe96ae1e43f
ドメインの URL 形式（https://acme.com）を使用し、ラベルは使用しないでください。 これは Twenty における会社の保存方式に一致します。

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

​
ステップ 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

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

会社列をマッピングする際:
  1. 会社参照列（例: companyDomain）を見つけます
  2. それを 会社 の関連フィールドにマッピングします
  3. Twenty は各 People レコードを対応する会社にリンクします
リレーションには一意の識別子を必ず1つだけマッピングしてください。companyId と companyDomain の両方をマッピングしないでください。 どちらか一方を選択してください—人間が読みやすいので、可能であればドメインを推奨します。

​
ステップ 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 またはファイルに既に存在します重複を削除するか、既存のレコードを更新します
無効なメールアドレス形式メールアドレスの形式が正しくありませんname@domain.com の形式に修正します
リレーションが見つかりません会社が存在しません先に会社をインポートするか、参照を修正します
必須フィールドの欠落必須フィールドが空です値を入力するか、その行を削除します

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

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

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

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

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

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

​
FAQ

メールアドレスは Twenty における一意の識別子です。 これにより連絡先の重複を防ぎ、メール同期でメールが正しい人物にリンクされるようになります。
メールアドレスは空のままでもかまいません。 ただし、データ品質とメール同期機能を高めるため、可能であればメールアドレスの追加を推奨します。
Company のドメイン（例: https://acme.com）または ID の列を追加します マッピング時に、この列を Company のリレーションフィールドに関連付けます。
まず Companies をインポートし、その後 People をインポートします。 参照する前に、その Company が存在している必要があります。
はい! 外部 ID を保存するために、データモデルで “unique” に指定したカスタムフィールドを作成します。 注意: フィールド名 id は Twenty の内部 ID 用に予約されています。
参照している Company が存在しません。 Company を先にインポートするか、ドメイン/ID が既存の Company と完全に一致しているか確認してください。

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

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