ファイルから連絡先をインポートする #

スプレッドシートに連絡先リストがある場合は、1件ずつ追加する代わりに、まとめてアップロードできます。このアプリでは、アップロード → 列のマッピング → 確認という3ステップのウィザードを使用します。テンプレートをダウンロードする必要はなく、お手持ちのCSVファイルをそのまま利用できます。

連絡先のインポート方法 #

1. 左側のサイドバーで Contacts をクリックし、ページ上部の Import をクリックします。
2. Upload. CSVファイルをドロップゾーンにドラッグ＆ドロップするか、クリックしてファイルを選択します。最初にダウンロードするテンプレートはありません。お手持ちのファイルをそのまま使用してください。

3. 列をマッピングします。 ウィザードがファイルのヘッダー行を読み取り、各列をターゲットフィールド（名、姓、電話番号、メールアドレス、タグ、メモ、またはカスタムフィールドのいずれか）に自動的に一致させようとします。一致しない場合はインポートしないを選択します。各列の推測結果を確認し、誤りがある場合は横のピッカーを使用して修正してください。プレビューテーブルには、インポートされる最初の数行がそのまま表示されます。
   • ヘッダーがカスタムフィールド名と一致する列は、そのフィールドに自動的にマッピングされます。大文字と小文字、アクセント記号は区別されないため、CPF という列は cpf という名前のフィールドと一致します。任意の列に対して、手動でカスタムフィールドを選択することも可能です。
   • まだカスタムフィールドではない列を新しいフィールドにすることもできます。ピッカーで 新しいカスタムフィールド: を選択すると、インポート時にそのフィールドが作成されます。
   • カスタムフィールドに型（数値、チェックボックス、ドロップダウン）が設定されており、列の値の一部がその型に適合しない場合、インポート前に影響を受ける行数が警告として表示されます。該当する行は、名前やメールアドレスを含め、すべてスキップされます。警告の をテキストに変更 をクリックすると、フィールドの型を一度に変更できます。または、値を修正するか、列を インポートしない に設定してください。
   • 電話番号の列は必須です。マッピングせずに続行することはできません。
   • タグにマッピングされた列は、各連絡先の実際のタグになります。1つのセル内に複数のタグを含めることも可能です。その場合はコンマまたはセミコロン（vip; newsletter; hotmart）で区切ってください。存在しないタグは自動的に作成され、既存のタグは（大文字小文字を無視して）再利用されます。

4. 確認。以下を選択します：
   • デフォルトチャネル — WhatsApp Business、WhatsApp Web、またはSMS。これは、チャネルが指定されていないインポートされたすべての連絡先に適用されます。
   • リスト — ドロップダウンから既存のリストを選択するか、名前を入力してその場で新しいリストを作成します。どちらか一方のみを選択でき、両方を選択することはできません。「連絡先」ページでいずれかのリストが表示されている状態でインポートを開くと、そのリストが自動的に選択されます。不要な場合はクリアしてください。
   • 既存の連絡先を更新 — デフォルトではオフです。オフの場合、すでに登録済みの連絡先（同じ電話番号）と一致する行は重複としてスキップされます。連絡先の内容は変更されませんが、リストを選択した場合は、既存の連絡先がそのリストに追加されます。オンの場合、それらの行は連絡先を更新します。ファイル内の名前、メールアドレス、メモが既存の情報に上書きされます（空のセルは現在の値を保持します）。行内のタグは追加され、連絡先は選択したリストに追加されます。これは、既存の連絡先を修正または充実させるためにファイルを再インポートする方法です。

5. [count]件をインポート をクリックします。結果画面が表示され、作成された連絡先の数、更新された既存の連絡先の数（オプションがオンの場合）、選択したリストに追加された既存の連絡先の数、およびスキップされた行がある場合はその理由（無効な電話番号、電話番号の欠落、重複、連絡先上限に到達など）の内訳が確認できます。既存の連絡先を更新 がオフの状態で、既存の連絡先と一致する行があった場合、結果画面にその旨が表示され、これらの連絡先を更新 というオプションが提供されます。これをクリックすると、スイッチをオンにした状態で該当する行のみが再送信されるため、ファイルを再度インポートする必要はありません。

列マッピングの詳細 #

• 電話番号のみが必須の列です。電話番号が全くない行はインポート前に除外され、結果画面で別途カウントされます。
• 名 / 姓 / メールアドレスは、連絡先の基本フィールドに直接マッピングされます。
• メモは、連絡先のメモ / リードプロファイルフィールドにマッピングされます。
• タグは、実際のタグを作成（または再利用）して連絡先に適用します。これは、フィルタリング、配信ターゲットの指定、Webhookのトリガーに使用するタグと同じです。1つのセル内に複数のタグを含める場合は、カンマまたはセミコロンで区切ってください。2026年8月19日以前は、この列は tags という名前のカスタムフィールドとして保存されていました。それ以前にインポートしたことがある場合は、既存の連絡先を更新するをオンにして同じファイルを再インポートすれば、タグが適切に適用されます（残った tags カスタムフィールドは悪影響を及ぼしません。すべての連絡先から削除したい場合はサポートまでご連絡ください）。
• カスタムフィールド — 各カスタムフィールドは個別のターゲットです。フィールド名と一致するヘッダーは自動的に選択されます。値はファイル内の形式のまま連絡先に保存されます（数値、日付、チェックボックス、またはドロップダウンフィールドは、19,99、01/02/1990、yes のような認識可能な形式に変換されます）。新しいカスタムフィールドを選択すると、列からフィールドを作成できます。既存の連絡先を更新するをオンにすると、ファイル内のカスタムフィールド値で既存の連絡先も更新されます。空のセルは現在の値をそのまま保持します。
• ドット、ダッシュ、または先頭のゼロを含む識別子（CPF、納税番号、郵便番号など）を持つ列は、テキストフィールドに属します。数値フィールドではこれらの値は適合せず、行がスキップされます。

ヒント #

• 電話番号に国コードが含まれていることを再確認してください。国コードがないとメッセージは配信されず、使用可能な電話番号がない行は完全にスキップされます。
• 電話番号からスペース、ハイフン、括弧を取り除く必要はありません。インポーターは一般的な形式に対応していますが、国コードは必須です。
• ファイルはブラウザ内で完全に解析されるため、ウィザード自体による固定のアップロードサイズ制限はありませんが、連絡先の合計数はプランによって制限されます。インポートによってプランの上限を超える場合、それらの行は拒否され、結果画面に contact_limit_reached として表示されます。
• 同じ電話番号を持つ連絡先がすでに存在する場合、その行はデフォルトでスキップされ、結果画面に duplicate として表示されます。インポートによって同じ人物のコピーが作成されることはありません。リストを選択した場合、それらの行に対しても処理が行われます。既存の連絡先がリストに追加され、結果画面で個別にカウントされるため、同じファイルを再インポートすることで、すでにアカウントに存在するユーザーをリストに追加できます。フィールドを更新（名前やメールアドレスの修正、タグの追加）するには、「確認」ステップで既存の連絡先を更新をオンにしてからファイルを再インポートしてください。

よくある質問 #

CSVに古いエクスポートからの custom_company 列がありますが、正しくマッピングされますか？ ヘッダーが正確に company ではないため、自動的にはマッピングされません。その列のピッカーで カスタムフィールド: company を選択すると、company フィールドにインポートされます。アップロード前にヘッダー名を company に変更しておくと、ウィザードが自動的に一致させてくれます。

「カスタムフィールドの値がフィールドの型に適合しません」という理由で一部の行がスキップされました。なぜですか？ その列は型指定されたカスタムフィールド（例：数値）にマッピングされていますが、該当する行に数値フィールド内の 001.576.401-08 のような別の形式の値が含まれているためです。マッピングステップの警告にある をテキストに変更 をクリックするか、カスタムフィールドの設定で型を変更してから、既存の連絡先を更新 をオンにしてファイルを再度インポートしてください。

「テンプレートをダウンロード」ボタンはどこに行きましたか？ 廃止されました。ウィザードはお手元のCSVファイルを直接使用し、マッピングステップで不一致の列を修正できるようになっています。

すでに連絡先をインポートしましたが、一度にすべての連絡先にタグを追加したり、フィールドを修正したりするにはどうすればよいですか？ 確認ステップで既存の連絡先を更新をオンにして、同じファイル（または更新されたファイル）を再インポートしてください。既存の電話番号と一致する行は、スキップされる代わりに、その連絡先の名前、メールアドレス、メモ、タグ、リストを更新します。一致判定には電話番号のみが使用されるため、その列は元の状態を維持してください。

InstagramやMessengerの連絡先をファイルからインポートできますか？ いいえ。インポート機能はWhatsApp Business、WhatsApp Web、およびSMSのみをサポートしています。これらのチャネルは電話番号でユーザーに連絡するためです。一方、InstagramやMessengerはソーシャルアカウントでユーザーを識別するため、これらのチャネルで誰かがメッセージを送信した際に連絡先が自動的に作成されます。

連絡先をボット非アクティブ状態でインポートできますか？ 行ごとの列設定はありません。まずバッチをインポートしてから、インポートした連絡先に対して一括でボットオフアクションを実行してください。AIボットから連絡先を除外するを参照してください。

次のステップ #

• リストと連絡先の整理 — 新しくインポートした連絡先を管理・並べ替えします。
• キャンペーンからブロードキャストとエージェントへの移行 — インポートしたリストへのメッセージ送信を開始します。
• カスタムフィールド、リードプロファイル、メモ — インポート後に詳細情報を充実させます。