# ファイルから連絡先をインポートする スプレッドシートに連絡先リストがある場合は、1件ずつ追加する代わりに、まとめてアップロードできます。このアプリでは、**アップロード → 列のマッピング → 確認**という3ステップのウィザードを使用します。テンプレートをダウンロードする必要はなく、お手持ちのCSVファイルをそのまま利用できます。 --- ## 連絡先のインポート方法 1. 左側のサイドバーで **Contacts** をクリックし、ページ上部の **Import** をクリックします。 2. **Upload.** CSVファイルをドロップゾーンにドラッグ＆ドロップするか、クリックしてファイルを選択します。最初にダウンロードするテンプレートはありません。お手持ちのファイルをそのまま使用してください。 3. **列をマッピングします。** ウィザードがファイルのヘッダー行を読み取り、各列をターゲットフィールド（**名、姓、電話番号、メールアドレス、タグ、メモ**、または**インポートしない**）に自動的に一致させようとします。各列の推測を確認し、誤りがある場合は横のピッカーを使用して修正してください。プレビューテーブルには、インポートされる最初の数行がそのまま表示されます。 * **電話番号の列は必須です**。これをマッピングしないと続行できません。 * **タグ**にマッピングされた列は、各連絡先の実際のタグになります。1つのセル内に複数のタグを含めることも可能です。その場合はカンマまたはセミコロン（`vip; newsletter; hotmart`）で区切ってください。存在しないタグは自動的に作成され、既存のタグは（大文字・小文字を区別せずに）再利用されます。 4. **確認。** 以下を選択します： * **デフォルトのチャネル** — WhatsApp Business、WhatsApp Web、またはSMS。これは、チャネルが指定されていないインポートされたすべての連絡先に適用されます。 * **リスト** — ドロップダウンから既存のリストを選択するか、名前を入力してその場で新しいリストを作成します。どちらか一方のみを選択でき、両方を選択することはできません。 * **既存の連絡先を更新** — デフォルトではオフです。オフの場合、すでに登録されている連絡先（同じ電話番号）と一致する行は重複としてスキップされます。その連絡先は変更されず、リストにも追加されません。オンの場合、それらの行は連絡先を**更新**します。ファイル内の名前、メールアドレス、メモが既存のデータに上書きされ（空のセルは現在の値を保持）、行内のタグが追加され、選択したリストに連絡先が追加されます。これは、既存の連絡先を修正または充実させるためにファイルを再インポートする方法です。 5. **[count]件をインポート**をクリックします。結果画面が表示され、作成された連絡先の数、更新された既存の連絡先の数（オプションがオンの場合）、およびスキップされた行がある場合はその理由（無効な電話番号、電話番号の欠落、重複、連絡先上限への到達など）の内訳が表示されます。 --- ## 列マッピングの詳細 * **電話番号**は必須の列です。電話番号が記載されていない行は、インポート前に除外され、結果画面で個別にカウントされます。 * **名 / 姓 / メールアドレス**は、連絡先の基本フィールドに直接マッピングされます。 * **メモ**は、連絡先の[メモ / リードプロフィール](custom-contact-fields.md#notes-lead-profile)フィールドにマッピングされます。 * **タグ**は、実際のタグを作成（または再利用）して連絡先に適用します。これは、フィルタリング、配信のターゲット設定、Webhookのトリガーに使用するものと同じタグです。1つのセル内に複数のタグを含める場合は、カンマまたはセミコロンで区切ってください。2026年8月19日以前は、この列は`tags`という名前のカスタムフィールドとして保存されていました。それ以前にインポートした場合は、**既存の連絡先を更新**をオンにして同じファイルを再インポートしてください。そうすることでタグが適切に適用されます（残った`tags`カスタムフィールドが悪影響を及ぼすことはありません。すべての連絡先から削除したい場合はサポートまでご連絡ください）。 * 現在、任意のカスタムフィールド（従来の`custom_`列など）に対する列マッピングはありません。現在の回避策については[カスタムフィールドの一括読み込み](custom-contact-fields.md#bulk-loading-custom-fields)を参照してください。 --- ## ヒント - 電話番号に国コードが含まれていることを再確認してください。国コードがないとメッセージが配信されず、使用可能な電話番号がない行は完全にスキップされます。 - 電話番号からスペース、ダッシュ、括弧を取り除く必要はありません。インポーターは一般的な形式を許容しますが、国コードは依然として必要です。 - ファイルはブラウザ内で完全に解析されるため、ウィザード自体による固定のアップロードサイズ制限はありませんが、連絡先の合計数はプランによって制限されます。インポートによってプランの上限を超える場合、それらの行は拒否され、結果画面に`contact_limit_reached`として表示されます。 - 同じ電話番号を持つ連絡先がすでに存在する場合、その行はデフォルトでスキップされ、結果画面に`duplicate`として表示されます。インポートによって重複した連絡先が作成されることはありません。すでに登録されている連絡先を一括編集（名前やメールアドレスの修正、タグの追加、リストへの追加）するには、確認ステップで**既存の連絡先を更新**をオンにしてファイルを再インポートしてください。 --- ## よくある質問 **CSVに古いエクスポートからの `custom_company` 列がありますが、正しくマッピングされますか？** 自動的にはマッピングされません。ウィザードの自動一致機能は、名/電話番号/メールアドレス/タグ/メモのヘッダーのみを認識します。それ以外はデフォルトで**インポートしない**になるため、`custom_company` 列が自動的に `company` カスタムフィールドに反映されることはありません。インポート後に[カスタムフィールド](custom-contact-fields.md)から、またはAPI経由で値を入力してください。 **「テンプレートをダウンロード」ボタンはどこに行きましたか？** 廃止されました。ウィザードはお手元のCSVファイルを直接使用し、マッピングステップで不一致の列を修正できるようになっています。 **すでに連絡先をインポートしましたが、一度にすべての連絡先にタグを追加したり、フィールドを修正したりするにはどうすればよいですか？** 確認ステップで**既存の連絡先を更新**をオンにして、同じファイル（または更新されたファイル）を再インポートしてください。既存の電話番号と一致する行は、スキップされる代わりに、その連絡先の名前、メールアドレス、メモ、タグ、リストを更新します。一致判定には電話番号のみが使用されるため、その列は元の状態を維持してください。 **InstagramやMessengerの連絡先をファイルからインポートできますか？** いいえ。インポート機能はWhatsApp Business、WhatsApp Web、およびSMSのみをサポートしています。これらのチャネルは電話番号でユーザーに連絡するためです。一方、InstagramやMessengerはソーシャルアカウントでユーザーを識別するため、これらのチャネルで誰かがメッセージを送信した際に連絡先が自動的に作成されます。 **連絡先をボット非アクティブ状態でインポートできますか？** 行ごとの列設定はありません。まずバッチをインポートしてから、インポートした連絡先に対して一括で**ボットオフ**アクションを実行してください。[AIボットから連絡先を除外する](excluding-contacts-from-bot.md)を参照してください。 --- ## 次のステップ - [リストと連絡先の整理](list-and-contact-management.md) — 新しくインポートした連絡先を管理・並べ替えします。 - [キャンペーンからブロードキャストとエージェントへの移行](../moving-from-campaigns.md) — インポートしたリストへのメッセージ送信を開始します。 - [カスタムフィールド、リードプロファイル、メモ](custom-contact-fields.md) — インポート後に詳細情報を充実させます。